i2v.ai MCP
Connect an AI client, verify its permissions, check USD usage, and generate images or video.

i2v.aiConnect an AI client, verify its permissions, check USD usage, and generate images or video.
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.
| Client | Setup guide |
|---|---|
| Codex CLI and Codex IDE extension | Codex |
| Claude Code | Claude Code |
| Claude Desktop and Claude web | Claude connectors |
| Cursor | Cursor |
| ChatGPT web | ChatGPT |
| Scripts and other remote MCP clients | API key and custom clients |
| Desktop clients that launch a local process | Local stdio |
| Your own OAuth client | OAuth integration |
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 . See for revocation and troubleshooting.
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.
| 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 for the first paid task and for usage, revocation, and version checks.