Docs · MCP

Ask Claude to make and edit the film.

MotionTyped has an MCP server. Claude Code, or any MCP client, can make a film, answer the brief, pick a concept, edit scenes and export, with the same checks the editor uses.

Coming soon The hosted app is not open yet. These pages describe MotionTyped as it works today, in testing. Anything that is not available yet is marked. Join the waitlist to hear when it opens.

Set it up

The MCP server runs on your own machine today, from the self-hosted package. It uses your Anthropic key, or your Claude Code login when there is no key. Register it once:

claude mcp add --scope user motiontyped -- \
  node /abs/path/motiontyped/apps/mcp/dist/index.js

The developers page has the .mcp.json form and the other settings, and the self-host guide has the install.

Not available yet: a hosted MCP endpoint. Claude can only reach MotionTyped through a copy you run yourself.

The tools

There are 36 tools. Most work on a run, which is one film project, named by a runId.

GroupTools
Brief and conceptsdraft_brief writes the brief and returns at most three questions. answer_brief settles them. list_concepts shows the concepts. choose_concept picks one (t1…, or surprise).
Make a filmgenerate runs the whole pipeline. It can stop at the concepts (concept: "ask") or after the brief (briefOnly), take a goal, aspects, a preset and voice. get_run shows state, progress, QA and exports.
Your materialupload_asset attaches a logo, screenshot or brand kit. read_screens reads screenshots of your real product UI.
Editget_versions, edit_storyboard, undo_edit, redo_edit, diff_versions, regenerate_scene, list_insertables, build_insert_ops, scene_compositions.
Music and panelsmusic_shortlist ranks tracks. plan_panel_ops builds the edits for music, camera and pace, or colours. Apply them with edit_storyboard.
Check and exportexport_check lists what would block an export. export_run renders a version, with captions if asked. render_video, qa_video and critique_video render and review a run.
Presets and batchessave_preset, list_presets, delete_preset, apply_preset, batch_generate (one URL, several goals) and get_batch.
Templateslist_templates, get_template, render_template, revise_template.
Single stepsingest_url and generate_storyboard run the early stages one at a time.

edit_storyboard takes the same typed edits as the editor: set text, set a property, change a length or a transition, move, delete, duplicate or insert a scene, and change film-level settings. It applies all of them or none, and each accepted batch becomes a version, so undo_edit works. Pass the baseVersion you got from get_versions. A stale base or a batch that breaks a rule comes back as an error and changes nothing. It does not render: call export_run or render_video afterwards.

A short example

You say to Claude:

Make a 30-second launch film for acme.com for LinkedIn.
Ask me the brief questions first, then show me the concepts.

Claude then calls, in this order:

  1. draft_brief with the address and your request. It returns a runId, the brief and up to three questions with options. Claude asks you.
  2. answer_brief with your answers.
  3. generate with the runId and concept: "ask". It stops once the rough previews are drawn.
  4. list_concepts. Claude describes each concept to you and you choose one.
  5. choose_concept with that concept's id. The film is built. This takes minutes.

Then you say Make the first headline shorter, then export the vertical one with captions.

  1. get_versions for the head version and the scenes.
  2. edit_storyboard with that baseVersion and one set_text edit on the headline.
  3. export_check. If it lists blocking problems, Claude fixes them or tells you.
  4. export_run with aspects: ["9:16"] and the captions you want. get_run then lists the exported files.

Captions as SRT or VTT need a voice-over, as in the app. See Exporting.

Get started

Two ways in. One is ready today.

Hosted app

Coming soon

Paste a URL in your browser and get the ad back. No Docker, no keys. We are building it now.

  • Accounts, projects and credits when it launches
  • The waitlist gets a sample cut for their URL first
  • Pricing is indicative until launch
Get a sample cut

Self-host

Runs today

The same pipeline in one Docker image on your machine, with your Anthropic key or a Claude Code login. CPU only.

docker run --rm -e ANTHROPIC_API_KEY=sk-… \
  -v "$PWD/runs:/app/runs" \
  motiontyped generate https://your-product.com
Self-host guide

The source is not public yet: the self-host guide has a one-line request form and we send access by email. Everything the hosted app will do, the self-hosted version does today.