Repository avatar
AI Tools
v1.1.0
active

mcp

io.github.i2v-ai/mcp

Discover, quote, generate, and manage image and video tasks with i2v.ai.

Documentation

i2v.ai Agent Tools

Use i2v.ai image and video models from your coding agent or terminal. Find models by task, check inputs and the current USD reservation, upload references, and recover a submission after a timeout.

Choose how to use i2v.ai

  • Create media with an Agent. Install i2v-models for model discovery, quoting, safe submission, and recovery.
  • Add i2v.ai to your app. Install i2v-integrate to help a coding Agent implement your server, workflow, or webhook. Use the runnable examples for a backend integration.
  • Use the terminal or local MCP. The CLI package is built from the bundled script. The TypeScript SDK targets the OpenAPI 2.2.0 rollout. Source builds are available here while npm publication is prepared.
npx skills add i2v-ai/i2v-agent-tools --skill i2v-integrate

Agent Skill

Install i2v-models from this repository.

npx skills add i2v-ai/i2v-agent-tools --skill i2v-models

The website also offers npx skills add https://i2v.ai. See the CLI and MCP setup page for the download and platform-specific examples.

Standalone CLI

Run the bundled script with Node.js 20 or later.

node skills/i2v-models/scripts/i2v-cli.mjs list --task text-to-image
node skills/i2v-models/scripts/i2v-cli.mjs doctor
node skills/i2v-models/scripts/i2v-cli.mjs balance
node skills/i2v-models/scripts/i2v-cli.mjs usage --range 30d
node skills/i2v-models/scripts/i2v-cli.mjs recommend --task image-to-video
node skills/i2v-models/scripts/i2v-cli.mjs plan gpt-image-2 --input '{"prompt":"A blue ceramic mug on a pale tabletop"}'

Set I2V_API_KEY in the process environment for authenticated commands. recommend, plan, recover, and authenticated doctor use the remote MCP endpoint. A paid submission requires an approved --max-cost-usd. Pass the plan's expectedRevision as --expected-revision and retain the original idempotency key. After a timeout, run recover with the original credential and idempotency key, then query the recovered task with status.

MCP

  • Remote Streamable HTTP connects to https://i2v.ai/api/mcp. Use OAuth or a Bearer API key according to your client.
  • Local stdio runs node /absolute/path/to/i2v-cli.mjs mcp. Set I2V_API_KEY in the client environment. To let the local process upload and download files in your project, set I2V_WORKSPACE_DIR to that project's directory.

Use get_account for the wallet and current OAuth scopes. Use get_usage for account-wide settled charges, usage refunds and net spend by UTC date. API-key clients can also call GET /api/v1/account and GET /api/v1/account/usage?range=30d on the API host.

Local stdio checks for new versions when it connects. Run doctor to inspect the downloaded CLI, bundled Skill and MCP server. Reinstall the Skill in its original scope when ready to update, and restart your client to reload local stdio or refresh the remote tool list. See the MCP setup page for client permissions and connection steps.

See the workflow and recovery guide and MCP documentation. The Skill also includes guides for product images, reference-to-video, and comparing models.

中文快速开始

在项目目录运行上面的安装命令。用 recommend 按任务选型,用 plan 检查实际输入及账户美元报价。上传、生成和查单需要 API Key 或已授权的 MCP 连接。超时后用原凭据和幂等键执行 recover,找回任务 ID 后继续查单。中文界面与客户端配置见 i2v.ai CLI。

No installation packages available.

Remote

streamable-http
https://i2v.ai/api/mcp