Developer platform
Generate video from Claude, Cursor, or your own code
MotionVid runs a remote MCP server at https://motionvid.ai/mcp and a REST API. Both drive the same multi-scene engine behind the app: AI video with narration, music, sound effects and your brand kit — from one prompt in a chat, or one POST from your backend.
How does it work?
- Step 1
Connect once
Add https://motionvid.ai/mcp to your MCP client and sign in with OAuth — or create an mvk_ API key for the REST API and headless agents.
- Step 2
Ask for a video
Describe it in plain language, or POST /v1/videos with a prompt. Either way the job runs async: narration, music, brand kit and aspect ratio are all parameters.
- Step 3
Review and ship
Preview one frame per scene, request edits by describing the change, optionally gate the build on storyboard approval, then render the MP4 and download it.
Connect your client
Pick your client for its exact setup — one click where the client supports it, a paste where it doesn't.
Settings → Connectors
https://motionvid.ai/mcp
The button opens the Add custom connector dialog — name it MotionVid, paste the URL above, then Connect and sign in. (Desktop: Settings → Connectors → Add custom connector.)
Add to ClaudeFull walkthrough, tool list and auth details in the MCP setup guide.
What can your agent actually do?
Agent-native workflow
create_video, get_video_status, preview_video, edit_video, render_video — the full loop is tools, so an agent can carry a video from idea to MP4 and show you frames along the way.
Async jobs and webhooks
POST /v1/videos returns 202 with a job id immediately. Poll it, or pass webhook_url and get called when the job finishes — no connection held open across a multi-minute build.
Your brand, programmatically
brand_kit_id injects your saved logo, colors and fonts into every build. Animation style packs and the narration voice catalog are one list call away.
Research built in
Put a URL in the prompt and the planner fetches and screenshots the page, reading its copy, palette and typography — so a product video can be briefed with a link to the product.
One request, one video
The whole build — script, scenes, narration, music, render — from a single call.202comes back immediately with a job id; the webhook fires when the MP4 is ready.
curl -X POST https://us-central1-motionvid-ai.cloudfunctions.net/api/v1/videos \
-H "Authorization: Bearer mvk_your_api_key" \
-d '{
"prompt": "A 60s explainer on how solar panels work",
"narration": true,
"music": true,
"render": true,
"webhook_url": "https://example.com/webhooks/motionvid"
}'Frequently asked questions
- What is the MotionVid MCP server?
- An MCP (Model Context Protocol) server at https://motionvid.ai/mcp that lets AI assistants generate video. Connect it once to Claude, Claude Code or Cursor and you can ask for a video in plain language, then check on it, preview the scenes and request changes without leaving the chat.
- Can I generate video from Claude or Cursor?
- Yes. Add MotionVid as a connector in Claude, Claude Code or Cursor, sign in once with your MotionVid account, and your assistant can create, edit, preview and render videos using your credits.
- Is there a REST API as well?
- Yes. POST /v1/videos creates an async job and returns an id immediately; poll it or receive a webhook, then download the finished MP4. Multi-scene builds with narration, music and brand kits are all request parameters.
- Which plans include the API and MCP?
- The developer API and MCP connector are included on Ultimate, Creator, and AppSumo Tier 5+. Both draw on the same credit balance as the app, so there is no separate developer plan to buy.
- How do I authenticate?
- MCP clients sign in with OAuth: point the client at the endpoint, click Connect, and log in with your MotionVid account. The REST API and headless MCP setups use an API key (mvk_…) as a bearer token instead, created on the API keys page. The two are interchangeable on the MCP endpoint.
- Can a human review the video before it renders?
- Yes. Pass storyboard: true on a full AI-video build and the job pauses for approval — first at the cast sheets, then at the storyboard stills — until POST /v1/videos/{id}/approve (or the approval card in the MotionVid app) answers each gate.
Start building
The developer API and MCP connector are included on Ultimate, Creator, and AppSumo Tier 5+, drawing on the same credits as the app.