AI video generation API and MCP server
Connect Shotmatic To Your AI Stack
Use Shotmatic through hosted MCP, local stdio, or the public HTTP API. Build review-first video plans, direct renders, clip workflows, and saved automations without wiring a second backend.
Start from your agent
Use the transport that matches the job
Connect Cursor, Claude Code or Codex to your Shotmatic account with a managed API key. Plan, review and render through the same account and credit controls as the workspace.
Cursor Remote MCP
Add Shotmatic to Cursor with your account API key. Your videos and credits stay in your Shotmatic account.
Recommended scopes: catalog:read, usage:read, videos:read, sessions:read, voices:read, avatar_profiles:read, media:read
{
"mcpServers": {
"shotmatic": {
"url": "https://shotmatic.com/mcp",
"headers": {
"Authorization": "Bearer <SHOTMATIC_API_KEY>"
}
}
}
}After connecting, call get_account and read shotmatic://capabilities. Use plan_video to choose a creation path. Add write scopes only for the actions you need.
View capability catalogStart with a workflow
Use a named workflow to create, revise, or publish a video. Each example shows the tools involved and a starting prompt.
project_campaign_setup
resume_project_campaignResume a saved campaign with its archetype and brand defaults before drafting.
Resume project proj_123 for the Miami penthouse campaign and start its next session with the saved brand kit.branch_and_compare_variant
branch_and_compare_sessionFork a draft into a variant when you want a second angle without overwriting the main cut.
Branch session sess_123 into a tighter version, keep the hero visuals, swap the voice, and only approve the stronger cut.publish_finished_cut
publish_finished_cutFollow the publish path after approval and inspect the actual render run before sharing the output.
Approve the best version of sess_123, inspect the latest render run, and open the final video once the run completes.create_listing_teaser
plan_video -> create_session -> approve_and_renderCreate a reviewable or straight-through real-estate teaser from a listing brief.
Create a short real-estate teaser for 25 Ocean Drive. Focus on the rooftop terrace, chef kitchen, and sunset views.turn_article_into_video
plan_video -> create_session -> approve_and_renderConvert a public article or blog URL into a video plan or direct render.
Turn this article into a 45-second vertical video: https://example.com/storyturn_walkthrough_into_clips
upload_media -> create_clip_task -> quote_clip_sections -> render_clip_sectionsTurn a long walkthrough video you upload into short social clips. Clip tasks take an upload or a media library video, not a link.
Cut my uploaded walkthrough video into three vertical clips that focus on the kitchen, pool, and office.create_avatar_spokesperson_video
plan_video -> create_session -> quote_avatar_session -> approve_and_renderProduce a spokesperson-style video with a chosen or discovered voice.
Create an avatar spokesperson video announcing our new launch in a confident but calm tone.create_shorts_batch
repeat create_session -> approve_and_render, or create_sequenceGenerate a themed batch of related short videos for a campaign or content machine.
Create a batch of 6 short videos about AI sales outreach for TikTok and Reels.create_asset_first_campaign
upload_media -> create_session -> branch_session -> approve_and_renderStart from a reusable asset, then branch the draft into a campaign-ready cut.
Build a campaign around this product image, branch a premium launch cut, and keep the final asset reusable for future sessions.upload_and_reuse_media
upload_media -> list_mediaUpload an asset once and reuse it across multiple renders or plans.
Upload this product image and keep the media id so it can be reused in later drafts.run_existing_workflow
POST /v1/workflows/{workflowId}/executions (MCP: legacy tools only)Use a saved account workflow instead of inventing a new automation on the fly.
Find the saved real-estate listing workflow and run it for this new penthouse brief.Inspect recent render runs, immutable inputs, and live status streaming.
Resume campaigns, inspect archetypes, and follow the publish path from one project view.
Manage reusable visual, voice, caption, and glossary defaults for campaigns.
Review real MCP traces, revisions, and finished output videos.
Agent-native tool surface for remote clients.
Catalog of creation surfaces, option matrices, and scopes.
Single-file draft spec for direct HTTP integration.
Metadata route used by hosted MCP auth-aware clients.