> This page is for version v2 (default).
> For other versions, use one of these documentation indexes:
> - v2 (default): https://developer.ideogram.ai/v2/llms.txt
> - v1: https://developer.ideogram.ai/v1/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developer.ideogram.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.ideogram.ai/_mcp/server.

> Connect Claude, ChatGPT, Cursor or another MCP client to Ideogram's MCP server to make and edit images and video in a chat. Sign in; no API key needed.

Ideogram's MCP server lets an AI assistant generate, edit and organize images and video in your Ideogram account from a conversation. You sign in with your Ideogram account, so you don't need an API key, and the work spends your workspace's credits the same way the Ideogram app does.

Use it when a person works with an assistant. To build Ideogram into your own software, call the API directly; start with the [Quickstart](/v2/ideogram-api/quickstart).

## Server address

```text
https://mcp.ideogram.ai/mcp
```

It is a Streamable HTTP MCP server. The first time a client connects, it opens Ideogram's sign-in page in your browser.

## Connect a client

#### Claude

1. Open Claude and go to **Settings → Connectors**.
2. Select **Add custom connector** and paste the server address.
3. Sign in to Ideogram when the browser opens.

#### ChatGPT

1. Open ChatGPT and go to **Settings → Connectors**.
2. Add a new connector and paste the server address.
3. Sign in to Ideogram when asked.

#### Claude Code

1. Run this command in your terminal:

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

2. Type `/mcp` in Claude Code and pick **ideogram**.

3. Sign in to Ideogram in the browser.

#### Cursor

1. Open **Cursor Settings → MCP → Add new server**.

2. Paste this into `mcp.json`:

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

3. Sign in to Ideogram when Cursor asks.

#### Other clients

1. Open your assistant's MCP or connector settings.
2. Add a Streamable HTTP server with the server address.
3. Sign in to Ideogram on first use.

These steps also appear in the Ideogram app at [ideogram.ai/mcp](https://ideogram.ai/mcp).

## Sign-in and workspace

You sign in with the account you use for Ideogram, in the browser, using any sign-in method Ideogram offers. If you belong to more than one workspace, you choose one when you first connect; every client you connect uses that workspace, and you can ask the assistant to switch it later.

## What an assistant can do

Once connected, the assistant sees Ideogram's tools and picks them from your request. Ask in your own words, for example "Turn this banner into a 9:16 story and upscale it."

| Area          | What the assistant can do                                                                                                                                 |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Generate      | Make images, including SVG artwork with Ideogram Vector 1, and video                                                                                      |
| Edit          | Edit, remix, upscale and reframe images; remove or replace backgrounds; remove objects; resize ads; vectorize; change colorways and materials; edit video |
| Understand    | Describe an image as a prompt                                                                                                                             |
| Organize      | List your images and manage collections                                                                                                                   |
| Custom models | Manage training datasets, train a custom model and list your models                                                                                       |
| Account       | Manage organizations, upload files and check the status of a job                                                                                          |

## Billing

* MCP use spends the chosen workspace's credits: your plan's monthly credits first, then credits you bought. A prepaid workspace uses its shared balance, and an enterprise agreement bills under its terms.
* When the credits run out, MCP requests don't fall back to the slower queue the app offers. The assistant gets a link to add credits or upgrade, and the request can be tried again after that.

## Limits

* Files you send through the assistant can be up to 50 MB.
* One request can submit a batch of up to 500 prompts.
* How many jobs run at once follows your plan, as in the app.

See [Plans and Credits](https://docs.ideogram.ai/plans-and-billing/available-plans) in the user guide for what each plan includes.

## The docs MCP server is different

`https://developer.ideogram.ai/_mcp/server` searches these docs and nothing else. It can't generate images. See [Build with AI coding agents](/v2/ideogram-api/ai-tools).