MCP Server Guide

Use Ideogram V3 from Claude Code

Ideogram V3 is the best-in-class image model for text inside images: signs, posters, logos, embedded typography. Other models struggle to render readable text; Ideogram nails it. The first pick when the prompt includes any literal text rendering.

If you use Claude Code and you want Ideogram V3 available as a native tool that the agent can call directly, the AetherWave MCP server wires it up in one command. No SDK to learn, no separate API key per provider, no polling loop to write.

Install in 30 seconds

Run this from your terminal:

claude mcp add aetherwave \
-e AETHERWAVE_API_KEY=aw_live_your_key_here \
-- npx -y @aetherwave-studio/mcp

Get your API key at your Profile page under the Developer tab. New accounts start with free credits to try it without spending anything.

Quick facts

Model ID
ideogram-v3-t2i
Provider
Ideogram via KIE.ai
Cost
5 cr turbo, 10 cr balanced, 14 cr quality
Outputs per call
1

How to use it

Once the MCP is installed, you can ask Claude Code naturally. It'll pick Ideogram V3 from the model-selection rubric in the tool description when your prompt matches its strengths (AI images with embedded readable text).

Example interaction:

You
Generate posters with prominent text or headlines

Claude Code calls aetherwave_generate_image with model: "ideogram-v3-t2i" and returns the finished asset URL. The result auto-saves to your AetherWave gallery (Cloudflare R2 hosted, no URL expiration).

Sample prompts that work well

Example 1
"Concert poster for 'Neon Drift', synthwave aesthetic, large stylized title text, 1980s typography"
Example 2
"Vintage book cover for 'The Last Algorithm', literary fiction, debossed title typography"
Example 3
"Coffee shop signage 'Open 7am-7pm' in chalkboard style on weathered wood"

When to pick Ideogram V3

Ideogram V3 shines for:

How it compares

vs gpt-image-2-t2i at 9 cr: Ideogram is best-in-class specifically for readable text in images. GPT Image 2 handles text okay; Ideogram makes it crisp and professional.

Run aetherwave_list_image_models from Claude Code to see the full live catalog with pricing.

Cost

Tiered pricing by rendering speed. 5 credits at turbo (fastest), 10 at balanced (default), 14 at quality (best). Single output across all tiers.

Credits come from your AetherWave account. Plans:

Frequently Asked Questions

How do I install AetherWave MCP in Claude Code?

One command (shown above). Then restart Claude Code. The agent will have Ideogram V3 available as part of the aetherwave_generate_image tool with 1 output(s) per call.

How do I use Ideogram V3 from Claude Code?

Just describe what you want. The agent picks Ideogram V3 when your prompt matches its strengths (AI images with embedded readable text). You can also explicitly request it by passing model: "ideogram-v3-t2i" in the tool call.

What does Ideogram V3 cost per generation?

Tiered pricing by rendering speed. 5 credits at turbo (fastest), 10 at balanced (default), 14 at quality (best). Single output across all tiers. Credits come from your AetherWave account (Studio sub from $9.99/mo or one-time bundles from $4.99/500 cr).

Try Ideogram V3 from Claude Code

Free API key, free starter credits, single MCP install. Be running your first Ideogram V3 generation in under five minutes.

Get Your Free API Key