MCP server

MotionVid for AI agents

Connect Claude, Cursor, Codex, and any MCP-compatible client. Your agent generates videos, checks progress, and manages your account with plain language.

ClaudeChatGPTCodexCursorVS CodeGemini CLI+ any MCP client

Endpoint

The server speaks Streamable HTTP at:

URL
https://motionvid.ai/mcp

Authentication is OAuth 2.1 with automatic discovery: point a client at the URL, click Connect, and sign in with your MotionVid account. Headless setups can send an API key instead (below).

Connect a client

Claude (web & desktop)

Open Claude connector settings
Steps
1. Desktop: Settings → Connectors → Add custom connector
   Web: claude.ai/customize/connectors
2. Name: MotionVid — URL: https://motionvid.ai/mcp
3. Click Connect and sign in with your MotionVid account

Claude Code

shell
# 1. Register the server:
claude mcp add --transport http motionvid https://motionvid.ai/mcp

# 2. Sign in (adding it does not start OAuth on its own):
claude mcp login motionvid
#    …or run /mcp inside a session and choose Authenticate.

# Headless alternative — register with an API key, no sign-in step:
claude mcp add --transport http motionvid https://motionvid.ai/mcp \
  --header "Authorization: Bearer mvk_your_api_key"

Cursor

Add to Cursor
.cursor/mcp.json
{
  "mcpServers": {
    "motionvid": {
      "url": "https://motionvid.ai/mcp",
      "headers": { "Authorization": "Bearer mvk_your_api_key" }
    }
  }
}

VS Code

Add to VS Code
.vscode/mcp.json
{
  "servers": {
    "motionvid": { "type": "http", "url": "https://motionvid.ai/mcp" }
  }
}

Codex

~/.codex/config.toml
[mcp_servers.motionvid]
url = "https://motionvid.ai/mcp"

# Headless alternative — this names the variable, so also
# export MOTIONVID_API_KEY=mvk_your_api_key in your shell:
# bearer_token_env_var = "MOTIONVID_API_KEY"
shell
# Sign in (adding the server does not start OAuth on its own):
codex mcp login motionvid

# Or skip the config file and do both steps from the terminal:
codex mcp add motionvid --url https://motionvid.ai/mcp

Any MCP client

shell
# Streamable HTTP + a bearer header is all it takes.
# OAuth access tokens and mvk_ API keys are interchangeable.

curl -X POST https://motionvid.ai/mcp \
  -H "Authorization: Bearer mvk_your_api_key" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Example tool call

Your agent handles this for you — but under the hood, generating a video is one call:

JSON-RPC
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_video",
    "arguments": {
      "prompt": "A 30s product launch teaser for our new app",
      "duration": 30,
      "aspect_ratio": "16:9",
      "render": true
    }
  }
}

Drop a link in the prompt and the video follows its design. Any URL or domain you mention gets read and screenshotted, and the page's copy, colors, and typography carry into the scenes — so pointing at your own site or the article you're announcing is the quickest way to make the result look like it belongs to you.

It also researches on its own when the prompt needs it. Ask for something current and it searches the web before planning, so a video about this week's news is built on this week's sources rather than guesswork. Name a company without a link and it looks up the official site itself.

Available tools

create_video

Generate a full video from a text prompt (async job)

get_video_status

Poll a job: progress, scenes, fresh download link

edit_video

Change a finished video by describing the change

preview_video

See the result: one frame per scene, shown as images

approve_video

Answer a paused review gate on a storyboard build

render_video

Encode a finished job to MP4, or re-render at a new size

cancel_video

Cancel a queued or in-flight job

list_videos

Your video jobs, newest first

list_models

Model capabilities, durations, and credit costs

list_animation_styles

Visual style packs for create_video

list_voices

The narration voice catalog

list_brand_kits

Your saved brand kits (logo, colors, fonts)

enhance_prompt

Rewrite a rough idea into a generation-ready prompt

get_credit_balance

Remaining credits and render allowance

whoami

The authenticated account

Availability & billing

MCP is available on Ultimate, Creator, and AppSumo Tier 5+ plans. API keys for headless use come with those same plans; create them from your API keys page. Generations started by an agent spend the same credits as the web app, and research along the way costs one credit for each page read and each web search run.

Connecting a client grants it access to your MotionVid account — your videos, brand kits, and credit balance. Our Privacy Policy covers what we collect and how it is stored, and the Terms apply to agent-initiated use exactly as they do in the app.

Prefer raw HTTP?

The REST API exposes the same capabilities, plus webhooks.