Skip to main content
Glama
Sign In
deenesjakoruzh
Ideogram MCP Server

Ideogram MCP Server

by Sunwood-ai-labs
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

šŸ“¦ Project Overview

  • A TypeScript tool that allows you to use Ideogram API (v3.0) via MCP server

  • Multi-function including image generation, style reference, magic prompt, aspect ratio, model selection, etc.

  • Can be used immediately with Claude Desktop and other MCP clients

Related MCP server: OpenAI MCP

āš”ļø Quick Start

If you want to connect to Claude Desktop or other MCP clients at lightning speed,
Just copy and paste the JSON snippet below into your configuration file!

{
  "mcpServers": {
    "ideogram": {
      "command": "npx",
      "args": [
        "@sunwood-ai-labs/ideagram-mcp-server"
      ],
      "env": {
        "IDEOGRAM_API_KEY": "your_api_key_here"
      }
    }
  }
}

šŸ› ļø MCP Tool Specifications

generate_image

Parameter list (latest version)

Parameters

Type

explanation

Required/Optional

remarks

prompt

string

Image generation prompt (English recommended)

Required

aspect_ratio

string

Aspect ratio (e.g. "1x1", "16x9", "4x3", etc.)

any

15 types

resolution

string

Resolution (see official documentation, 69 types in total)

any

seed

integer

Random number seed (to ensure reproducibility)

any

0 to 2147483647

magic_prompt

string

Magic prompt ("AUTO"

"ON"

"OFF"

rendering_speed

string

Rendering speed for v3 ("TURBO"

"DEFAULT"

"QUALITY"

style_codes

string[]

8-character style code sequence

any

style_type

string

Style type ("AUTO"

"GENERAL"

"REALISTIC"

negative_prompt

string

Exclusions (English recommended)

any

num_images

number

Number of generated images (1 to 8)

any

style_reference

object

Style Reference (New in Ideogram 3.0)

any

Details below

ā”” urls

string[]

Reference image URL array (up to 3)

any

ā”” style_code

string

Style Code

any

ā”” random_style

boolean

Use random style

any

output_dir

string

Image storage directory (default: "docs")

any

base_filename

string

Base for saved filename (default: "ideogram-image")

any

Timestamp and ID assignment

blur_mask

boolean

Blur the edges of the image (set to true for mask compositing)

any

Default: false

šŸ“ Usage example

const result = await use_mcp_tool({
  server_name: "ideagram-mcp-server",
  tool_name: "generate_image",
  arguments: {
    prompt: "A beautiful sunset over mountains",
    aspect_ratio: "16x9",
    rendering_speed: "QUALITY",
    num_images: 2,
    style_reference: {
      urls: [
        "https://example.com/ref1.jpg",
        "https://example.com/ref2.jpg"
      ],
      random_style: false
    },
    blur_mask: true
  }
});

šŸ§‘ā€šŸ’» Develop, build, and test

  • npm run build ... TypeScript build

  • npm run watch ... development mode (automatic build)

  • npm run lint ... Code linting

  • npm test ... run tests

šŸ—‚ļø Directory structure

ideagram-mcp-server/
ā”œā”€ā”€ assets/
ā”œā”€ā”€ docs/
ā”‚   ā””ā”€ā”€ ideogram-image_2025-05-18T06-31-45-777Z.png
ā”œā”€ā”€ src/
ā”‚   ā”œā”€ā”€ tools/
ā”‚   ā”œā”€ā”€ types/
ā”‚   ā”œā”€ā”€ utils/
ā”‚   ā”œā”€ā”€ ideogram-client.ts
ā”‚   ā”œā”€ā”€ index.ts
ā”‚   ā”œā”€ā”€ server.ts
ā”‚   ā””ā”€ā”€ test.ts
ā”œā”€ā”€ .env.example
ā”œā”€ā”€ package.json
ā”œā”€ā”€ tsconfig.json
ā”œā”€ā”€ README.md
ā””ā”€ā”€ ...ļ¼ˆēœē•„ļ¼‰

šŸ“ Contributions

  1. Fork this repository

  2. Create a new branch ( git checkout -b feature/awesome )

  3. Commit changes (Commit messages should be in Japanese and emojis are recommended!)

  4. Push and pull request creation

šŸš€ Deploy & Release

  • Automatic npm publishing with GitHub Actions

  • Version update ā†’ Automatic deployment by pushing tags

npm version patch|minor|major
git push --follow-tags

For details, see docs/npm-deploy.md !

šŸ“„ License

MIT

Available Tools

1 tool
generate_imageC

Generate an image using Ideogram AI

Inputs: prompt (required), aspect_ratio, resolution, seed, +11 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    C2.9/5.0

    Scored across 1 tool

    Disambiguation5/5

    With only one tool, there is no possibility of confusion or overlap between tools. The single tool 'generate_image' has a clearly distinct and unambiguous purpose.

    Naming Consistency5/5

    A single tool inherently has perfect naming consistency, as there are no other tools to compare it against. The name 'generate_image' follows a clear verb_noun pattern.

    Tool Count2/5

    One tool is too few for a server named 'Ideogram MCP Server', which suggests a broader scope for image generation or AI tasks. A single tool feels thin and limited for such a domain.

    Completeness2/5

    The tool surface is severely incomplete for an image generation server. It only offers generation with no options for editing, listing, deleting, or managing images, creating significant gaps in functionality.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    Appeared in Searches