# Ideogram MCP: add Ideogram to any AI agent

Ideogram publishes a public search API over its indexed pages; the guide is at https://ideogram.ai/agents/agent-access.

Source: https://ideogram.ai/features/mcp/
Source observed: 2026-11-03T18:37:00.458Z
Last checked: 2026-11-08T15:45:18.323+00:00
Indexed: 2026-11-03T18:45:49.531+00:00

---

# Ideogram MCP: add Ideogram to any AI agent

We let AI agents use Ideogram to generate, edit, upscale, organize, and train image assets through the Model Context Protocol (MCP). Agents can chain our tools in a conversation, without custom glue code.

## Connect any MCP client

Our MCP server uses streamable HTTP at [`https://mcp.ideogram.ai/mcp`](https://mcp.ideogram.ai/mcp). Authentication uses OAuth through your Ideogram account: the first connection opens a browser window for sign-in. No API key handling is required.

The supported clients shown on our page are Claude, Claude Code, ChatGPT, Cursor, Cline, OpenCode, Hermes Bot, and custom clients. Any client that implements MCP streamable HTTP can connect.

### Claude Desktop

Add this to `claude_desktop_config.json`, then restart the app:

```json
{
  "mcpServers": {
    "ideogram": {
      "transport": "http",
      "url": "https://mcp.ideogram.ai/mcp"
    }
  }
}
```

### Claude Code

```bash
claude mcp add ideogram --transport http https://mcp.ideogram.ai/mcp
```

Run the command anywhere and sign in to your Ideogram account on first use.

### ChatGPT

Ideogram MCP is available in ChatGPT Plus and Pro through the desktop app's Connectors panel. Add an MCP server with:

- **URL:** `https://mcp.ideogram.ai/mcp`
- **Transport:** HTTP
- **Auth:** OAuth using your Ideogram account

### Cursor

Add this to `~/.cursor/mcp.json`, then reload the editor:

```json
{
  "mcpServers": {
    "ideogram": {
      "url": "https://mcp.ideogram.ai/mcp"
    }
  }
}
```

### Cline

Cline reads the same JSON shape from `cline_mcp_settings.json`:

```json
{
  "mcpServers": {
    "ideogram": {
      "url": "https://mcp.ideogram.ai/mcp"
    }
  }
}
```

### OpenCode

Add this to `~/.config/opencode/config.json` or a project-local `opencode.json`:

```json
{
  "mcpServers": {
    "ideogram": {
      "transport": "streamable-http",
      "url": "https://mcp.ideogram.ai/mcp"
    }
  }
}
```

### Hermes Bot

Use streamable-HTTP transport. Refer to your Hermes build's configuration path; the JSON shape follows the standard `mcpServers` convention.

### Custom clients

Any MCP streamable-HTTP client can connect. Discover OAuth metadata at [`https://mcp.ideogram.ai/.well-known/oauth-authorization-server`](https://mcp.ideogram.ai/.well-known/oauth-authorization-server).

A direct request uses:

```http
POST https://mcp.ideogram.ai/mcp
Authorization: Bearer <oauth-token>
Content-Type: application/json
```

```json
{
  "jsonrpc": "2.0",
  "method": "tools/list",
  "id": 1
}
```

## Try one of these to start

After connecting, drop a request into your assistant. The agent selects the appropriate tool from our catalog.

- “Generate a poster for the Beaches Jazz Festival happening on July 3 in Toronto, using Ideogram.”
- “Generate four seasonal versions of a ‘OPEN’ sign for a flower shop using soft pastels. Keep the signs in the same style.”
- “Build me a yoga clothing brand from scratch using Ideogram for image assets.”
- “Make me a children's book cover for a story about a fox who learns to fly.”

## Workflows

Each workflow is a single conversation in which the agent chains the required tools.

### Asset packs from a brief

Give the agent a one-paragraph campaign brief. It returns a hero image, four social cards, and two print posters in one conversation, then saves them into a named collection.

Tools:

- `generate_images_bulk`
- `create_collection`
- `upscale_image`

### Catalog cleanup

Provide product photos in chat. The agent removes backgrounds, reframes images for marketplace ratios, and uploads the cleaned assets to a shared collection.

Tools:

- `edit_image`
- `reframe_image`
- `upload_image`

### Train and iterate

Provide a folder of brand references. The agent creates a dataset, uploads the assets, starts training, and notifies you when the model is ready to use.

Tools:

- `create_dataset`
- `upload_dataset_assets`
- `train_model`

## Frequently asked

### Which clients are supported?

Anything that speaks the MCP streamable-HTTP transport is supported, including Claude desktop and code, ChatGPT, Cursor, Cline, OpenCode, and custom clients that implement the protocol.

### How does authentication work?

Your client opens a browser so you can sign in to your Ideogram account through OAuth. Our MCP server acts on your behalf using the resulting session, with no API key handling required.

### Does Ideogram MCP use my plan's credits?

Yes. MCP usage draws from the same subscription as the Ideogram web app. MCP requests have no separate billing.

### When should I use the Ideogram REST API instead?

MCP is designed for agents acting on a user's behalf with OAuth. For server-to-server pipelines under your own control, use our REST API at developer.ideogram.ai.

## Related Ideogram products and resources

- [Apps & Models](https://ideogram.ai/tools/)
- [Precise Edit](https://ideogram.ai/tools/precise-edit/)
- [Ad Resizer](https://ideogram.ai/tools/ad-resizer/)
- [Background Remover](https://ideogram.ai/tools/background-remover/)
- [Colorways](https://ideogram.ai/tools/colorways/)
- [Material Swap](https://ideogram.ai/tools/material-swap/)
- [Object Remover](https://ideogram.ai/tools/object-remover/)
- [Ideogram Vector](https://ideogram.ai/models/vector/)
- [Ideogram 4.5](https://ideogram.ai/models/4.5/)
- [Ideogram 4.0](https://ideogram.ai/models/4.0/)
- [Ideogram 3.0](https://ideogram.ai/models/3.0/)
- [P-Image-Ideogram](https://ideogram.ai/tools/p-image-ideogram/)
- [Custom Image Models](https://ideogram.ai/models/custom-models/)
- [API](https://ideogram.ai/api-learn/)
- [API pricing](https://ideogram.ai/pricing/?pricing_tab=api)
- [API documentation](https://developer.ideogram.ai/ideogram-api/api-overview)
- [API status](https://status.ideogram.ai/)
- [Pricing](https://ideogram.ai/pricing/)
- [Enterprise](https://ideogram.ai/enterprise/)
- [Privacy Policy](https://ideogram.ai/legal/privacy/)

---

[Read this page’s summary](https://ideogram.ai/agents/api/public/v1/page-tldr?url=https%3A%2F%2Fideogram.ai%2Ffeatures%2Fmcp%2F&trace=t_380edc68d53d)

## Ask a follow-up about this page

Need a more specific answer? Ask the exact question you have. It returns a fresh, cited answer from Ideogram’s knowledge base. No account or API key required.

Open this URL with your own question, URL-encoded. Include your question in q. All research inputs are optional; no account or setup.

`GET https://ideogram.ai/agents/agent/faq?q={question}&trace=t_380edc68d53d`

[Tool guide and examples](https://ideogram.ai/agents/agent-access) · [OpenAPI](https://ideogram.ai/agents/api/public/v1/openapi.json) · [Page TLDR form](https://ideogram.ai/agents/agent-tools/page-tldr?url=https%3A%2F%2Fideogram.ai%2Ffeatures%2Fmcp%2F). Opening a form does not execute a tool.