1. Conduid
  2. Content
  3. io.github.qmediat/ideogram-mcp
MCP server · Content

io.github.qmediat/ideogram-mcp

· github.com/qmediat/ideogram-mcp

Ideogram V3 API — generate, edit, remix, reframe, replace background, upscale images

Unclaimed content
InstallView source
37Low

Scored 6 months ago · breakdown

About io.github.qmediat/ideogram-mcp

io.github.qmediat/ideogram-mcp is an MCP server in the Content category: ideogram V3 API — generate, edit, remix, reframe, replace background, upscale images.

Install

Claude Code
claude mcp add io-github-qmediat-ideogram-mcp -- npx -y @qmediat.io/ideogram-mcp
npx
npx -y @qmediat.io/ideogram-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (7)

ideogram_describeGenerate text description of an image

Parameters not published.

ideogram_editEdit areas of an image with mask-based inpainting

Parameters not published.

ideogram_generateGenerate images from text prompts

Parameters not published.

ideogram_reframeExtend an image to a new resolution (outpainting)

Parameters not published.

ideogram_remixTransform an image with a new prompt

Parameters not published.

ideogram_replace_backgroundReplace background, preserving foreground

Parameters not published.

ideogram_upscaleUpscale with guided enhancement

Parameters not published.

Ask AI

✦

Ask AI about io.github.qmediat/ideogram-mcp

Powered by Claude · Grounded in docs

I know everything about io.github.qmediat/ideogram-mcp. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

@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.

npm version license TypeScript

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

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

Variable Required Default Description
IDEOGRAM_API_KEY Yes — Your Ideogram API key (get one here)
IDEOGRAM_OUTPUT_DIR No /tmp/ideogram-output Any folder where you want images saved. Use absolute paths (e.g. /home/user/images/ideogram)

Available Tools

Tool Description Key Parameters
ideogram_generate Generate images from text prompts prompt, aspect_ratio, rendering_speed, style_type, num_images
ideogram_describe Generate text description of an image image (file path)
ideogram_edit Edit areas of an image with mask-based inpainting image, mask, prompt
ideogram_remix Transform an image with a new prompt image, prompt, image_weight (0-100)
ideogram_reframe Extend an image to a new resolution (outpainting) image, resolution (69 valid sizes)
ideogram_replace_background Replace background, preserving foreground image, prompt
ideogram_upscale Upscale with guided enhancement image, resemblance (0-100), detail (0-100)

Common Parameters

Parameter Available In Values
rendering_speed generate, edit, remix, reframe, replace_background FLASH, TURBO, DEFAULT, QUALITY
magic_prompt generate, edit, remix, replace_background, upscale AUTO, ON, OFF
style_type generate, edit, remix AUTO, GENERAL, REALISTIC, DESIGN, FICTION
aspect_ratio generate, remix 1x1, 16x9, 9x16, 4x3, 3x4, and 10 more
num_images all tools 1-8
seed all tools 0-2,147,483,647

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

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About io.github.qmediat/ideogram-mcp

How do I install io.github.qmediat/ideogram-mcp?

Run claude mcp add io-github-qmediat-ideogram-mcp -- npx -y @qmediat.io/ideogram-mcp, then add the server to your MCP client's configuration.

Is io.github.qmediat/ideogram-mcp safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is io.github.qmediat/ideogram-mcp still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.