Docs

MotionSpec — Quickstart

Connect the hosted MCP

claude mcp add motionspec https://api.motionspec.dev/mcp

No key needed: the read-only tools (catalog, validate) are open on a free, unauthenticated tier; usage is rate-limited. (Custom domain https://mcp.motionspec.dev/mcp is on the roadmap.)

Or run locally (no key needed)

npm i -g motionspec        # MIT, v1.2.4
npx motionspec             # stdio MCP server
motion --help              # CLI

The 5 tools (all read-only)

• motion_catalog — list the 40 verified primitives
• motion_validate — check a spec against the schema (fail-closed)
• motion_compile — deterministic code output (WAAPI/GSAP) with enforced reduced-motion + performance budget
• motion_audit — static motion-a11y check of a live URL (WCAG 2.2.2/2.3.3)
• motion_stats — usage/health

The guarantee, in one line

Same spec → same code, every time; the model can only pick from a verified catalog — animations are generated, not hallucinated. Proven in production: Lighthouse 71→90, LCP −47% on a live client site (case study).

Status & limits

Rate limits: pre-auth burst protection + per-tier quotas (429 on excess — empirically verified). Uptime canary runs every minute. Status contact: hello@motionspec.dev.