# i2v.ai MCP

Connect i2v.ai to an MCP client to select a model, validate inputs, review a live USD quote, submit a generation, or check your account. For copyable client configuration, open [MCP setup](/mcp).

## Choose your client

| Client | Setup guide |
| --- | --- |
| Codex CLI and Codex IDE extension | [Codex](/docs/mcp/codex-cli) |
| Claude Code | [Claude Code](/docs/mcp/claude-code) |
| Claude Desktop and Claude web | [Claude connectors](/docs/mcp/claude-desktop) |
| Cursor | [Cursor](/docs/mcp/cursor) |
| ChatGPT web | [ChatGPT](/docs/mcp/chatgpt) |
| Scripts and other remote MCP clients | [API key and custom clients](/docs/mcp/api-key) |
| Desktop clients that launch a local process | [Local stdio](/docs/mcp/local-stdio) |
| Your own OAuth client | [OAuth integration](/docs/mcp/oauth) |

## Endpoint and permissions

The remote MCP URL is `https://i2v.ai/api/mcp`. It accepts stateless Streamable HTTP over `POST`. A compatible client can complete OAuth in your browser. For API-key authentication, send `Authorization: Bearer YOUR_API_KEY` to the MCP endpoint. REST account and generation requests use `https://api.i2v.ai`.

| OAuth scope | Allows |
| --- | --- |
| `mcp:read` | Discover models, check quotes, query account balance and usage, and look up owned tasks. This is the default when a client requests no scope. |
| `mcp:write` | Upload assets and submit generations. The client requests it and you explicitly authorize it. It includes read access. |

An active API key provides read and write access for its owner, subject to [key settings and IP restrictions](/docs/authentication). See [Account, access, and updates](/docs/mcp/account-and-access) for revocation and troubleshooting.

## Verify read access

Use this prompt to check the connection.

> Use i2v.ai to list all public image models with `list_models` and `mediaType: image`. Continue until you reach `total`. Show the model names and IDs, then use `get_account` to show the granted scopes. Do not create a task.

For a spend check, ask for `get_usage` with `range: 30d`. It reports UTC booking dates, settled fees, usage refunds, verified historical usage, and net spend. Use `get_account` for available and reserved USD, which are a separate wallet view.

## Available tools

| Tool | OAuth scope | Result |
| --- | --- | --- |
| `list_models` | Read | Public catalog with filters and pagination |
| `get_model_params` | Read | Current input schema and media limits |
| `recommend_models` | Read | Candidates for a specific task and constraints |
| `prepare_generation` | Read | Validated inputs, normalized settings, USD quote, and model revision |
| `estimate_cost` | Read | Compatibility tool for account-specific quotes |
| `create_task` | Write | Task ID and billing information after submission |
| `get_task` | Read | Current status and output URLs for an owned task |
| `recover_submission` | Read | Original submission receipt for the same credential |
| `get_account` | Read | Balance, reservations, funding categories, and scopes |
| `get_usage` | Read | Account-wide charges, refunds, and net USD usage |
| `search_docs` | Read | Matching help and model documentation |
| `create_upload_url` | Write | Short-lived URL for a direct upload |
| `complete_upload` | Write | Verification of the uploaded object |

Local stdio also provides CLI-backed tools for public prices and, with a workspace configured, local file uploads and downloads. See [Generation and recovery](/docs/mcp/workflow) for the first paid task and [Account, access, and updates](/docs/mcp/account-and-access) for usage, revocation, and version checks.