@matildeene/motion-mcp

A Model Context Protocol server that teaches an AI agent to write good ZXN Motion films. It serves the same documentation and the same verified example films the website publishes, and checks the source an agent writes before anyone has to look at it.

Left alone, an agent builds character rain from a <div> per glyph, reaches for Date.now(), lets GSAP play itself, and copies a 4K project size. It cannot see the result, so it never finds out. This gives it the rules, the nearest working example, and a checker that catches all of those.

Tools

| Tool | What it does | | --- | --- | | authoring_rules | The short list of rules for a film that is deterministic, fast and good-looking. Read first. | | search_docs | Searches the docs and examples; returns the matching sections and recipes, best first. | | list_docs / read_doc | The documentation topics, and one page in full. | | list_examples / get_example | The verified example films, and one film's complete source. | | check_film | Type-checks source against the real SDK and reports imports a film may not use and habits that make it slow or unrepeatable. Nothing is executed. |

Run it

Run the published server with npm:

npx --yes @matildeene/motion-mcp

Claude Code:

claude mcp add zxn-motion -- npx --yes @matildeene/motion-mcp

Any client that reads an mcpServers map (.mcp.json, .cursor/mcp.json):

{
  "mcpServers": {
    "zxn-motion": { "command": "npx", "args": ["--yes", "@matildeene/motion-mcp"] }
  }
}

See Writing films with an AI agent for the workflow and a rules file to drop into a project.