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.
Use the transport that matches the job
Cursor is the cleanest hosted MCP path today. Local coding agents should use stdio against a repository checkout. The raw HTTP API is still the right fit when you want explicit request control or generated SDKs.
Cursor Remote MCP
Best hosted setup today. Point Cursor at the Shotmatic MCP endpoint with a bearer token and let the agent call the existing workflow tools.
Recommended scopes: *
{
"mcpServers": {
"shotmatic": {
"url": "https://shotmatic.com/mcp",
"headers": {
"Authorization": "Bearer <SHOTMATIC_API_KEY>"
}
}
}
}Replace the placeholder with a real API key from your account page, then verify by calling get_capabilities or one of the named workflow prompts.
Hosted MCP endpointStart from named workflows, not raw tool spelunking
Shotmatic exposes low-level tools, but most agent sessions should begin with an opinionated workflow prompt and only drop down when the task is unusual.
project_campaign_setup
resume_project_campaignStart or resume a campaign with the right archetype and brand defaults before drafting.
Create a project for the Miami penthouse campaign, apply the launch_film archetype, attach the core brand kit, and start the first session.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
create_video_plan or create_videoCreate 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
create_video_plan or create_videoConvert 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
create_clip_task -> get_clip_task -> render_clip_sectionsTurn a long hosted walkthrough video into short social clips.
Create short clips from https://cdn.example.com/walkthrough.mp4 and focus on the kitchen, pool, and office.create_avatar_spokesperson_video
list_voices -> create_video_plan -> approve_video_planProduce 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_video_plan or create_videoGenerate 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_sessionStart 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 -> get_media or 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
list_workflows -> run_workflow -> get_workflow_executionUse 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.