ideogram-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| IDEOGRAM_API_KEY | Yes | Your Ideogram API key | |
| IDEOGRAM_OUTPUT_DIR | No | Any folder where you want images saved. Use absolute paths (e.g. /home/user/images/ideogram) | /tmp/ideogram-output |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ideogram_generateB | Generate images from text prompts with Ideogram 3.0 (default) or 4.0 (model: '4.0'). 3.0 takes aspect ratios or an exact resolution, style types, style and character reference images, style codes, presets, colour palettes and custom models. |
| ideogram_describeA | Generate a text description of an image (Ideogram's describe endpoint). Accepts a local file path. |
| ideogram_editB | Edit specific areas of an image using mask-based inpainting. Requires source image, mask (black=edit, white=keep), and prompt; takes the style and character references, style codes, preset and palette (no exact resolution: inpaint keeps the source size). |
| ideogram_remixC | Transform an image with a new prompt while preserving characteristics. Control influence with image_weight (0-100); takes the style and character references, style codes, preset, palette and an exact resolution. |
| ideogram_reframeB | Extend an image to a new resolution via outpainting. Specify target resolution (e.g. 1024x1024, 1536x640). |
| ideogram_replace_backgroundB | Replace the background of an image while preserving the foreground subject. Describe the new background in the prompt. |
| ideogram_upscaleB | Upscale an image to higher resolution with guided enhancement. Control resemblance (0-100) and detail (0-100). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool targets a clearly distinct image operation: generation, description, background replacement, upscaling, masked inpainting, remixing, and outpainting. Although all modify images, the required inputs (mask, image_weight, target resolution) and descriptions make the boundaries unambiguous.
All tool names follow a consistent pattern: ideogram_ prefix plus a clear verb or verb_noun (generate, describe, replace_background, upscale, edit, remix, reframe). No mixing of conventions or case styles.
Seven tools is a well-scoped set for an image generation and editing API, covering core generation and advanced manipulation without bloat or notable omissions. Each tool earns its place.
The surface covers the full lifecycle of image creation and transformation: text-to-image, image description, background replacement, upscaling, masked editing, remixing, and outpainting. No obvious operational gaps for the stated Ideogram domain.