Skip to main content

Motion graphics videos from your AI agent

Connect Claude Code, Codex, Cursor or VS Code to iArt’s MCP server. Your agent describes the video; iArt writes it, adds voice-over and renders it. Back come an MP4 and a share link. A REST API does the same.

Get an API keyConnect your agent

Beta. Pro, Ultra and Max plans.

Claude Code

Run in a terminal.

Replace YOUR_API_KEY with a key from the API page in the app.

claude mcp add --transport http iart https://app.iart.ai/api/mcp --header "Authorization: Bearer YOUR_API_KEY"

Codex

Run in a terminal. Codex reads the key from IART_API_KEY, so keep it set where you start Codex (e.g. in your shell profile).

Replace YOUR_API_KEY with a key from the API page in the app.

export IART_API_KEY=YOUR_API_KEY
codex mcp add iart --url https://app.iart.ai/api/mcp --bearer-token-env-var IART_API_KEY

Cursor

Add to .cursor/mcp.json in your project (or ~/.cursor/mcp.json).

Replace YOUR_API_KEY with a key from the API page in the app.

{
  "mcpServers": {
    "iart": {
      "url": "https://app.iart.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

VS Code

Add to .vscode/mcp.json in your workspace.

Replace YOUR_API_KEY with a key from the API page in the app.

{
  "servers": {
    "iart": {
      "type": "http",
      "url": "https://app.iart.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Any other MCP client: Streamable HTTP at https://app.iart.ai/api/mcp, with the key in an Authorization: Bearer or x-api-key header. Then ask your agent for a video, for example “make a 15-second launch video for my app with iArt”.

Five tools

Full API reference

  • create_video

    POST /api/v1/videos

    Starts a motion graphics video from a written brief: prompt (required), aspect_ratio (16:9, 9:16 or 1:1), voiceover (on by default), model, resolution (720p by default; 1080p on Pro, up to 4K on Ultra and Max) and files (up to 10: public links, up to 10 MB for images and 100 MB for video, or files from upload_file). Returns the video id.

  • get_video

    GET /api/v1/videos/{id}

    Status: writing, rendering, done, failed or stopped. When done: an MP4 link, an unlisted share link, and a link that opens the project in the iArt editor.

  • revise_video

    POST /api/v1/videos/{id}/revise

    Changes a finished video from a description of what to change (and more files, if you like), or retries a failed or stopped one. It is made again and charged again.

  • stop_video

    POST /api/v1/videos/{id}/stop

    Stops a video being made, for example when the brief was wrong. What it used so far is charged; it can be retried later.

  • upload_file

    POST /api/v1/files?name=…

    Adds a file from your computer to use in a video: a logo, screenshots, product photos, a voice recording, a PDF (up to 4 MB; for larger files, put a public link in files instead). Over MCP your agent gets an upload link and sends the file with curl, no key needed; over REST you send the file as the body. Either way you get a file_url for files. Every file is checked before it is used: it must be the type its name says, and an SVG may not contain scripts or links to other files.

REST

# Upload a file to use (optional; answers with its file_url)
curl -X POST "https://app.iart.ai/api/v1/files?name=logo.png" -H "Authorization: Bearer YOUR_API_KEY" --data-binary @logo.png

# Start a video (answers at once with its id)
curl -X POST https://app.iart.ai/api/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"prompt": "A 15-second launch video for my app, with logo.png: …", "files": ["FILE_URL"]}'

# Check it every 30-60 seconds until status is done, failed or stopped
curl https://app.iart.ai/api/v1/videos/VIDEO_ID -H "Authorization: Bearer YOUR_API_KEY"

# Change a finished video (or retry a failed or stopped one, without instructions)
curl -X POST https://app.iart.ai/api/v1/videos/VIDEO_ID/revise \
  -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"instructions": "Make the logo bigger"}'

# Stop a video being made
curl -X POST https://app.iart.ai/api/v1/videos/VIDEO_ID/stop -H "Authorization: Bearer YOUR_API_KEY"

Limits and pricing

Videos use your credits at the same prices as the app. A video is refused up front when your credits can’t cover it on top of the ones in progress.

Pro
3 videos at once · up to 1080p
Ultra
6 videos at once · up to 4K
Max
15 videos at once · up to 4K
Get an API keySee plans

Supported models and pricing

model
Input
Output
deepseek-4.1
$0.45 /1M tokens
$1.8 /1M tokens
haiku-5.5
$0.15 /1M tokens
$0.75 /1M tokens
sonnet-5.5 (default)
$3 /1M tokens
$15 /1M tokens
opus-5.5
$6 /1M tokens
$30 /1M tokens
fable-5.2
$12 /1M tokens
$60 /1M tokens
gemini-4-argon
$3 /1M tokens
$15 /1M tokens

Including the service fee. Rendering: $0.09 per scene and $0.045 to combine the scenes, at any resolution. Per key: 300 status checks and 60 creates or revisions a minute.

Questions

What is the iArt MCP server?

A remote MCP server that lets an AI agent such as Claude Code, Codex, Cursor or VS Code make motion graphics videos with iArt: kinetic typography, explainers, logo reveals, data animations and promos, with AI voice-over. Your agent describes the video, iArt writes and renders it, and the agent gets back an MP4 and a share link. The same tools are available as a REST API.

Which plans include the API?

Pro, Ultra and Max. Create a key in the iArt app under API (in your account menu). Videos use your account’s credits, exactly as videos made in the app do.

How much does a video cost?

Videos use your credits at the same prices as the app: the model’s tokens (from $0.15 in and $0.75 out per 1M tokens with haiku-5.5; sonnet-5.5, the default, is $3 and $15), plus $0.09 per rendered scene and $0.045 to combine them, at any resolution. What a video costs depends on its length and how much the agent writes. A video is refused up front when your credits can’t cover it on top of the videos you have in progress.

How long does a video take, and what do I get?

A few minutes. You get an MP4 (720p by default; 1080p on Pro, up to 4K on Ultra and Max), an unlisted share link anyone with the link can watch, and a link that opens the project in the iArt editor, where you can keep working on it.

How many videos can I make at once?

Pro 3, Ultra 6 and Max 15 at a time, counting videos you make with Batch in the app too. The API is in beta. Each key also has a rate limit: 300 status checks and 60 creates or revisions a minute.

Is there a free way to do this?

The open-source motion graphics skills teach your agent to write and render animations itself, for free. The API is for when you would rather have iArt run the whole pipeline: writing, voice-over, music and rendering. Browse the skills.