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.
Endpoint
The server speaks Streamable HTTP at:
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 settings1. 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 accountClaude Code
# 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{ "mcpServers": { "motionvid": { "url": "https://motionvid.ai/mcp", "headers": { "Authorization": "Bearer mvk_your_api_key" } } } }
VS Code
Add to VS Code{ "servers": { "motionvid": { "type": "http", "url": "https://motionvid.ai/mcp" } } }
Codex
[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"
# 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
# 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:
{ "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_videoGenerate a full video from a text prompt (async job)
get_video_statusPoll a job: progress, scenes, fresh download link
edit_videoChange a finished video by describing the change
preview_videoSee the result: one frame per scene, shown as images
approve_videoAnswer a paused review gate on a storyboard build
render_videoEncode a finished job to MP4, or re-render at a new size
cancel_videoCancel a queued or in-flight job
list_videosYour video jobs, newest first
list_modelsModel capabilities, durations, and credit costs
list_animation_stylesVisual style packs for create_video
list_voicesThe narration voice catalog
list_brand_kitsYour saved brand kits (logo, colors, fonts)
enhance_promptRewrite a rough idea into a generation-ready prompt
get_credit_balanceRemaining credits and render allowance
whoamiThe 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.