motionspec — MCP server for Claude Code: what it does, install
motionspec is an MCP server for Claude Code that checks and compiles UI motion in AI-generated web apps. It provides motion primitives, WCAG validation, and output to GSAP or WAAPI CSS.
no license 189 installs updated 2026-07-14
claude mcp add --transport http motionspec https://motionspec--office-jafp.run.toolsWhat motionspec does
Two tools work without a key. motion_catalog hands back 40 checked motion primitives with their purpose, parameter schemas and defaults, plus the rules for writing a spec. The agent writes the spec; the server does not invent it.
motion_validate then checks that spec against the schema, the list of allowed primitives, parameter bounds and injection rules. It fails closed: anything wrong comes back as ok=false with the exact errors, while WCAG 2.2.2 and reduced-motion findings land in warnings. Read both fields, or half the problems slip past.
Compiling and auditing sit behind a plan. motion_compile, motion_audit and motion_stats need a Dev Key at $39/mo or the Agency plan at $249/mo on the paid endpoint. Without one they only report how to get access and produce no code. So the catalog and the validation are the free half; GSAP or WAAPI CSS output that respects reduced motion requires the key. Submitted specs are not stored.
What it helps with
- check AI-written animation against WCAG 2.2.2
- pull a list of motion primitives with their parameters and defaults
- catch spec errors before any code is generated
- compile a validated spec into GSAP or WAAPI CSS
- keep reduced-motion handling in the output
Example prompts for the agent
- List the primitives from
motion_catalogand explain the rules for writing a spec. - Run this animation spec through
motion_validateand walk me through the errors and warnings. - Build a modal entrance from the catalog primitives, then validate the spec with
motion_validate.
How to install motionspec
Platform CLI: remote server
claude mcp add --transport http motionspec https://motionspec--office-jafp.run.toolsPlatform CLI: remote server
codex mcp add motionspec --url https://motionspec--office-jafp.run.toolsConfig file
{
"mcpServers": {
"motionspec": {
"url": "https://motionspec--office-jafp.run.tools"
}
}
}Config file
{
"servers": {
"motionspec": {
"type": "http",
"url": "https://motionspec--office-jafp.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http motionspec https://motionspec--office-jafp.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about motionspec
How do I install motionspec in Claude Code?
Run claude mcp add --transport http motionspec https://motionspec--office-jafp.run.tools. It connects over HTTP and needs no key at that step.
What does motionspec do?
It validates UI animation specs against its schema and the WCAG 2.2.2 and 2.3.3 rules, and serves a catalog of 40 primitives. A spec that passes can be compiled to GSAP or WAAPI CSS.
Which tools need a paid key?
motion_compile, motion_audit and motion_stats do: they run on a Dev Key at $39/mo or the Agency plan at $249/mo. Without one they only return access details.