@qmediat.io/ideogram-mcp

MCP server for the Ideogram V3 API — generate, edit, remix, upscale, and describe images from Claude Code, Claude Desktop, or any MCP client.

Why this server?

• 7 tools — full Ideogram V3 coverage (generate, edit, remix, reframe, replace background, upscale, describe)

• Security-first — SSRF protection, symlink rejection, Content-Type validation, path traversal prevention, Zod response validation (details)

• 2 runtime dependencies — @modelcontextprotocol/sdk + zod. No axios, no form-data, no HTTP libraries

• Native Ideogram API — direct V3 endpoints, not proxied through fal.ai or Replicate

• Production-hardened — retry with exponential backoff, safety filter handling, partial failure resilience

Related MCP server: ideogram-mcp-server

Quick Start

npm install -g @qmediat.io/ideogram-mcp

Or use directly:

npx @qmediat.io/ideogram-mcp

Requires IDEOGRAM_API_KEY — get one at ideogram.ai/manage-api.

Configuration

Claude Code

Add to ~/.claude.json → mcpServers:

{
  "ideogram": {
    "command": "npx",
    "args": ["-y", "@qmediat.io/ideogram-mcp"],
    "env": {
      "IDEOGRAM_API_KEY": "your-api-key",
      "IDEOGRAM_OUTPUT_DIR": "/tmp/ideogram-output"
    }
  }
}

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "ideogram": {
      "command": "npx",
      "args": ["-y", "@qmediat.io/ideogram-mcp"],
      "env": {
        "IDEOGRAM_API_KEY": "your-api-key",
        "IDEOGRAM_OUTPUT_DIR": "/tmp/ideogram-output"
      }
    }
  }
}

Environment Variables

Available Tools

Common Parameters

Security

This server is designed with a zero-trust, minimal-dependency approach:

• SSRF protection — HTTPS-only downloads, hostname allowlist, redirect blocking

• Symlink rejection — lstat() rejects user-created symlinks before reading

• Content-Type validation — downloads must be image/*, rejecting HTML/JSON error pages

• Zod response validation — API responses parsed through schemas, no blind type casts

• Path traversal prevention — extension allowlist + path.relative() containment check

Full details in SECURITY.md.

Development

git clone https://github.com/qmediat/ideogram-mcp.git
cd ideogram-mcp
npm install
npm run build

Run locally:

IDEOGRAM_API_KEY=your-key node dist/index.js

Contributing

See CONTRIBUTING.md for architecture guidelines and PR requirements.

License

MIT — Quantum Media Technologies