# @qmediat.io/ideogram-mcp MCP server for the Ideogram platform (api.ideogram.ai v2): every image and video model the platform sells through one API key — Ideogram 4.5/4.0/3.0, GPT Image, Nano Banana, Z-Image, P-Image, Topaz upscalers, Seedance/Kling/MiniMax video — the commercial - **Type:** MCP server - **Trust:** 85/100 (A), scored on the package rubric - **Verification:** verified (build provenance) - **Version:** 2.5.0 - **Author:** Quantum Media Technologies - **License:** MIT - **npm:** @qmediat.io/ideogram-mcp - **Source:** https://github.com/qmediat/ideogram-mcp - **Compatible clients:** claude-code, cursor, copilot, gemini (basis: transport) ## Trust 85/100 (A), scored on the package rubric - Publisher verified: no - Build provenance: verified attestation - npm trusted publishing (OIDC): yes - Install scripts: nothing suspicious found - Prompt-injection scan: not run - Obfuscation scan: not run - Evidence age: 1 day ## Security scan - **Status:** clean - **Scanned:** 2026-10-15T01:26:28.186Z - **Version scanned:** 2.5.0 - **CVEs:** none found by OSV at scan time ## Tools 12 declared. Statically extracted from the shipped source — a floor on the surface, not a census. - `ideogram_usage` - `ideogram_invoices` - `ideogram_api_keys` - `ideogram_edit` — Deprecated alias of ideogram_inpaint, kept through 2.x for 1.x callers: the same arguments and models (see ideogram_inpaint's schema). - `ideogram_operations` — Discover what Ideogram's API offers and what this server serves: no input = every family; family = its operations (model, class, support, quotable); operation = - `ideogram_generation` — Collect the result of a generation by its generation_id (from a tool that answered 'still running', or from an earlier session): waits up to wait_s for it, then - `ideogram_quote` — Ask Ideogram what a call would cost before making it: give the curated tool's name and the arguments you would pass it. Answers USD and credits from the API's o - `ideogram_api` — Advanced: call an Ideogram operation by id (from ideogram_operations) when no curated tool covers it — a model the documentation index does not list (allow_undo - `ideogram_datasets` — Your training datasets: the list (optionally searched by name), or one dataset by id with its files, captions and the models trained from it. Reads only. - `ideogram_dataset_upload` — Upload images (JPEG, PNG, WebP), caption sidecars (.txt/.json named like their image) and .zip archives into a dataset — an existing one by dataset_id, or a new - `ideogram_train` — Start training a custom Ideogram 4.0 (default) or 3.0 model from a dataset of 15-100 images; a hyperparameter routes to the advanced operation. Returns the mode - `ideogram_models` — Your custom models and those shared with your organization: the list (by scope and status), or one by id with its training runs. Reads only. ## Install **Verdict: install** — No blocking findings and no open coverage gaps — safe to install as configured. **Config** (claude-code): ```json "{\n \"mcpServers\": {\n \"ideogram\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@qmediat.io/ideogram-mcp\"\n ],\n \"env\": {\n \"IDEOGRAM_API_KEY\": \"\"\n }\n }\n }\n}" ``` **Credentials it will ask for** (names only — Forge never holds a value): - `IDEOGRAM_API_KEY` — Ideogram API Key (required) Placeholders only. Forge never holds, brokers, or transmits a credential value — replace each in your own config file. Do not send a value back to Forge; no Forge endpoint accepts one. - This entry needs 1 credential (1 required). The generated config carries placeholders, so it will fail in the editor rather than at runtime if they are left unset. ## Blast radius Extensive blast radius — mutates data; holds an api key. - Floor 47, ceiling 47 (tier: extensive) - This is impact, not likelihood. A high radius is not a defect: a filesystem server is supposed to write files. It is never part of the trust score. ## Machine-readable views of this entry - Signed JSON: https://forgeregistry.com/api/v1/packages/%40qmediat.io%2Fideogram-mcp - Install plan: https://forgeregistry.com/api/v1/packages/%40qmediat.io%2Fideogram-mcp/install-plan - Alternatives: https://forgeregistry.com/api/v1/alternatives/%40qmediat.io%2Fideogram-mcp - HTML page: https://forgeregistry.com/registry/%40qmediat.io%2Fideogram-mcp - MCP: POST https://forgeregistry.com/api/mcp → `forge_get_package` / `forge_install_plan` ## About this document Generated by Forge (https://forgeregistry.com) — a compact rendering of the same record served, signed, at the JSON URL above. Trust and scan facts are the registry's own measurements; anything Forge did not measure is named as unmeasured rather than omitted.