Ideogram Mcp
This server wraps the full Ideogram V3 API in seven MCP tools: generate from text prompts, describe images, edit with masks, remix with variable image weights, reframe to new aspect ratios via outpainting, replace backgrounds, and upscale with detail control. All operations support configurable rendering speeds (flash to quality), magic prompt enhancement, and style presets. Images save to a local directory you specify. The implementation is security hardened with SSRF protection, symlink rejection, and Zod validation, using only two runtime dependencies. Good fit if you want Claude to create or modify images through Ideogram without leaving the conversation or writing custom API calls.
- tools
- 38
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- Oct 11, 2026
Tools
38 toolsPublic tool metadata for what this MCP can expose to an agent.
ideogram_generateImages from a text prompt
Images from a text prompt
No parameter schema in public metadata yet.
ideogram_precise_editEdit an image at its exact size: a prompt, an optional mask (black = edit), up to 4 reference images, `context_window` to confine the edit
Edit an image at its exact size: a prompt, an optional mask (black = edit), up to 4 reference images, `context_window` to confine the edit
No parameter schema in public metadata yet.
ideogram_inpaintRepaint the masked part of an image (black = repaint)
Repaint the masked part of an image (black = repaint)
No parameter schema in public metadata yet.
ideogram_editThe 1.x name of `ideogram_inpaint` (kept through 2.x)
The 1.x name of `ideogram_inpaint` (kept through 2.x)
No parameter schema in public metadata yet.
ideogram_remixNew images from a source image and a prompt
New images from a source image and a prompt
No parameter schema in public metadata yet.
ideogram_reframeExtend an image to a new size (outpainting)
Extend an image to a new size (outpainting)
No parameter schema in public metadata yet.
ideogram_replace_backgroundA new background, the subject kept
A new background, the subject kept
No parameter schema in public metadata yet.
ideogram_remove_backgroundThe foreground as a transparent PNG
The foreground as a transparent PNG
No parameter schema in public metadata yet.
ideogram_remove_objectRemove what the mask marks (white = remove) and fill the gap
Remove what the mask marks (white = remove) and fill the gap
No parameter schema in public metadata yet.
ideogram_upscaleEnlarge an image
Enlarge an image
No parameter schema in public metadata yet.
ideogram_describeDescribe an image: words (`ideogram-3`, default) or a structured JSON prompt (`ideogram-4`)
Describe an image: words (`ideogram-3`, default) or a structured JSON prompt (`ideogram-4`)
No parameter schema in public metadata yet.
ideogram_video_textA video from a prompt: duration, aspect ratio, resolution, audio per model; saved as mp4
A video from a prompt: duration, aspect ratio, resolution, audio per model; saved as mp4
No parameter schema in public metadata yet.
ideogram_video_imageA video from a start image (and an end image): files, URLs or assets
A video from a start image (and an end image): files, URLs or assets
No parameter schema in public metadata yet.
ideogram_video_referenceA video guided by reference images, MP3/WAV clips and videos stored with Ideogram, in prompt order
A video guided by reference images, MP3/WAV clips and videos stored with Ideogram, in prompt order
No parameter schema in public metadata yet.
ideogram_layerizeA flat image as an editable design: the text-free base image (saved) and the detected text blocks (JSON)
A flat image as an editable design: the text-free base image (saved) and the detected text blocks (JSON)
No parameter schema in public metadata yet.
ideogram_ad_localizerTranslate an ad's copy into one language, keeping layout, logos and product
Translate an ad's copy into one language, keeping layout, logos and product
No parameter schema in public metadata yet.
ideogram_ad_resizerReframe an ad to a platform's exact ad size inside its safe zone
Reframe an ad to a platform's exact ad size inside its safe zone
No parameter schema in public metadata yet.
ideogram_ad_variationsVary an ad along one axis: people, setting, group_size or scene
Vary an ad along one axis: people, setting, group_size or scene
No parameter schema in public metadata yet.
ideogram_colorwaysRecolor a product photo: up to 4 masks paired with hex colours
Recolor a product photo: up to 4 masks paired with hex colours
No parameter schema in public metadata yet.
ideogram_ghost_mannequinA garment on an invisible mannequin from its photos, in the view asked
A garment on an invisible mannequin from its photos, in the view asked
No parameter schema in public metadata yet.
ideogram_material_swapApply reference materials to the masked regions of a product photo
Apply reference materials to the masked regions of a product photo
No parameter schema in public metadata yet.
ideogram_model_pose_variantsRe-pose the model of a fashion image by instruction
Re-pose the model of a fashion image by instruction
No parameter schema in public metadata yet.
ideogram_sketch_to_renderRender a fashion sketch as a product photo
Render a fashion sketch as a product photo
No parameter schema in public metadata yet.
ideogram_magic_promptRewrite a prompt into an Ideogram 4.0 structured JSON prompt (nothing generated)
Rewrite a prompt into an Ideogram 4.0 structured JSON prompt (nothing generated)
No parameter schema in public metadata yet.
ideogram_layerize_logosDetect and remove reference logos from a flat design: the base image saved, the layers listed
Detect and remove reference logos from a flat design: the base image saved, the layers listed
No parameter schema in public metadata yet.
ideogram_provenanceCheck whether an image was created by Ideogram (free)
Check whether an image was created by Ideogram (free)
No parameter schema in public metadata yet.
ideogram_snap_maskSnap a hand-drawn mask to the object it marks; the PNG saved
Snap a hand-drawn mask to the object it marks; the PNG saved
No parameter schema in public metadata yet.
ideogram_quoteThe price of a call: {"tool": "ideogram_generate", "arguments": {…}}
The price of a call: {"tool": "ideogram_generate", "arguments": {…}}
No parameter schema in public metadata yet.
ideogram_generationCollect a generation by `generation_id` — its images or its video
Collect a generation by `generation_id` — its images or its video
No parameter schema in public metadata yet.
ideogram_usageBilled usage as Ideogram reports it: buckets of line items summed per product and currency
Billed usage as Ideogram reports it: buckets of line items summed per product and currency
No parameter schema in public metadata yet.
ideogram_invoicesThe organization's invoices with their line items (organization-admin key)
The organization's invoices with their line items (organization-admin key)
No parameter schema in public metadata yet.
ideogram_api_keysThe organization's API keys, redacted (organization-admin key)
The organization's API keys, redacted (organization-admin key)
No parameter schema in public metadata yet.
ideogram_datasetsYour training datasets: the list (searched by name) or one with its files and models
Your training datasets: the list (searched by name) or one with its files and models
No parameter schema in public metadata yet.
ideogram_dataset_uploadImages, .txt captions and .zip archives into a dataset (an existing one, or a new one from a name)
Images, .txt captions and .zip archives into a dataset (an existing one, or a new one from a name)
No parameter schema in public metadata yet.
ideogram_trainTrain a custom model from a dataset of 15–100 images; hyperparameters route to the advanced operation
Train a custom model from a dataset of 15–100 images; hyperparameters route to the advanced operation
No parameter schema in public metadata yet.
ideogram_modelsYour custom models and the shared ones, or one with its training runs
Your custom models and the shared ones, or one with its training runs
No parameter schema in public metadata yet.
ideogram_operationsWhat the API offers: families, operations, fields, limits
What the API offers: families, operations, fields, limits
No parameter schema in public metadata yet.
ideogram_apiAny served operation by id, including the ones the documentation index does not list
Any served operation by id, including the ones the documentation index does not list
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
IDEOGRAM_API_KEY*secretYour Ideogram API key (create one at https://ideogram.ai/platform)
IDEOGRAM_OUTPUT_DIRDirectory for saved images (default: /tmp/ideogram-output)
Readme
Details
- Repository
- github.com/qmediat/ideogram-mcp
- Package
@qmediat.io/ideogram-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active