Command Palette

Search for a command to run...

UnylyUnyly
Весь каталог

Ideogram V3 Server

БесплатноНе проверен

MCP server for Ideogram V3 model line enabling image editing, reframing, remixing, and text-to-image generation with task polling and pricing checks through Run

GitHubEmbed

Описание

MCP server for Ideogram V3 model line enabling image editing, reframing, remixing, and text-to-image generation with task polling and pricing checks through RunAPI.

README

RunAPI Ideogram V3 MCP Server

Ideogram V3 API access for AI agents: create image generation tasks, poll results, and check pricing through one focused MCP server.

Works with Claude Code, Codex, Cursor, Windsurf, VS Code, Roo Code, and any MCP-compatible host.

npm version GitHub repository Apache-2.0 license MCP Server 7 models

Install | Tools | Models | Agent Prompts | Configuration | Links


Why This Package?

@runapi.ai/ideogram-v3-mcp is a focused Model Context Protocol server for the Ideogram V3 model line on RunAPI. It gives MCP-compatible assistants direct access to 4 endpoints and 7 model variants without loading the full RunAPI catalog.

Use this per-model server when an agent should stay scoped to Ideogram V3. Use @runapi.ai/mcp when one assistant should discover every RunAPI model line.


Install

Add it to Claude Code:

claude mcp add ideogram-v3 -s user -- npx -y @runapi.ai/ideogram-v3-mcp

Use project scope when the server should be shared with a repository:

claude mcp add ideogram-v3 -s project -- npx -y @runapi.ai/ideogram-v3-mcp

Codex, Cursor, Windsurf, VS Code, Roo Code, and other MCP hosts can use the same stdio command:

{
  "mcpServers": {
    "ideogram-v3": {
      "command": "npx",
      "args": ["-y", "@runapi.ai/ideogram-v3-mcp"]
    }
  }
}

check_pricing works before sign-in. For task creation and status polling, ask your assistant to call the login tool. It opens a browser login and saves credentials to ~/.config/runapi/config.json, the same file used by runapi login. Headless and CI hosts can still set RUNAPI_API_KEY before starting the MCP host.

Ready-made examples are in examples/ for Claude, Cursor, Windsurf, VS Code, and Roo Code.


Tools

Tool Auth Purpose
edit_image Yes Create an Ideogram V3 edit image task and optionally wait for a terminal status. Returns the task id, status, output URLs, and pricing snapshot.
reframe_image Yes Create an Ideogram V3 reframe image task and optionally wait for a terminal status. Returns the task id, status, output URLs, and pricing snapshot.
remix_image Yes Create an Ideogram V3 remix image task and optionally wait for a terminal status. Returns the task id, status, output URLs, and pricing snapshot.
text_to_image Yes Create an Ideogram V3 text to image task and optionally wait for a terminal status. Returns the task id, status, output URLs, and pricing snapshot.
get_task Yes Fetch the current status and latest payload for an existing task.
check_pricing No Look up the current pricing snapshot for a Ideogram V3 model and endpoint.

Models

Ideogram V3 covers 7 model variants across 4 endpoints. Each tool accepts the models listed for it:

Tool Models
edit_image ideogram-v3-character-edit, ideogram-v3-edit
reframe_image ideogram-v3-reframe
remix_image ideogram-v3-character-remix, ideogram-v3-remix
text_to_image ideogram-v3-character, ideogram-v3-text-to-image

Model availability can change between releases. Use check_pricing or the Ideogram V3 model page for the current catalog view.


Agent Prompts

Ask your assistant in natural language; it can inspect pricing, create the task, and return the task id plus output URLs.

Create a task

Run an Ideogram V3 edit image task with RunAPI.

The assistant can call check_pricing, then edit_image, and return the task id, status, and output URLs.

Submit without waiting

Create the task but don't wait for it to finish.

The assistant calls the create tool with wait: false and returns the task id. Check on it later with get_task.

Check pricing before creating

Check current Ideogram V3 pricing, then create the task if it matches my request.

The assistant calls check_pricing and can link to the Ideogram V3 model page for the canonical catalog entry.


Configuration

The server resolves auth in this order:

  1. RUNAPI_API_KEY environment variable, useful for headless and CI hosts
  2. ~/.config/runapi/config.json, created by the MCP login tool or runapi login
  3. No key, which still allows check_pricing

The config file is normally managed by login. A pre-provisioned headless config can use:

{
  "apiKey": "your_runapi_key"
}

Do not commit real API keys.


Links

Resource URL
Ideogram V3 model page https://runapi.ai/models/ideogram-v3
npm package @runapi.ai/ideogram-v3-mcp
GitHub repository runapi-ai/ideogram-v3-mcp
RunAPI MCP overview runapi.ai/mcp
RunAPI docs runapi.ai/docs

License

Licensed under the Apache License, Version 2.0.

from github.com/runapi-ai/ideogram-v3-mcp

Установить Ideogram V3 Server в Claude Desktop, Claude Code, Cursor

Рекомендуется · одна команда, все IDE
unyly install ideogram-v3-mcp-server

Ставит в Claude Desktop, Claude Code, Cursor и VS Code — сам разбирается с npx, uvx и сборкой из исходников.

Впервые? Поставь CLI: curl -fsSL https://unyly.org/install | sh

Или настроить вручную

Выполни в терминале:

claude mcp add ideogram-v3-mcp-server -- npx -y @runapi.ai/ideogram-v3-mcp

FAQ

Ideogram V3 Server MCP бесплатный?

Да, Ideogram V3 Server MCP бесплатный — установка в пару кликов через Unyly без оплаты.

Нужен ли API-ключ для Ideogram V3 Server?

Нет, Ideogram V3 Server работает без API-ключей и переменных окружения.

Ideogram V3 Server — hosted или self-hosted?

Доступен hosted-вариант: Unyly запускает сервер в облаке, локальная установка не обязательна.

Как установить Ideogram V3 Server в Claude Desktop, Claude Code или Cursor?

Открой Ideogram V3 Server на unyly.org, выбери вкладку своего клиента (Claude Desktop, Claude Code, Cursor) и нажми Install — конфиг сгенерируется автоматически, без правки JSON.

Похожие MCP

Compare Ideogram V3 Server with

Не уверен что выбрать?

Найди свой стек за 60 секунд

Автор?

Embed-бейдж для README

Похожее

Все в категории media