# motionspec

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 189 installs
- Author: office-jafp
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/office-jafp/motionspec
- Updated: 2026-07-14
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/motionspec

## What it 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.

## Requirements
- Remote server: `https://motionspec--office-jafp.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http motionspec https://motionspec--office-jafp.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add motionspec --url https://motionspec--office-jafp.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "motionspec": {
            "url": "https://motionspec--office-jafp.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "motionspec": {
            "type": "http",
            "url": "https://motionspec--office-jafp.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http motionspec https://motionspec--office-jafp.run.tools
```

## When to use it
- 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
- List the primitives from `motion_catalog` and explain the rules for writing a spec.
- Run this animation spec through `motion_validate` and walk me through the errors and warnings.
- Build a modal entrance from the catalog primitives, then validate the spec with `motion_validate`.

## Similar
- [accessible-animation](https://affpapa.org/en/nevibecode/skills/accessible-animation.md) — skill · 4400 installs
- [scroll-scrubbed-word-reveal](https://affpapa.org/en/nevibecode/skills/scroll-scrubbed-word-reveal.md) — skill · 1800 installs
- [accessible-motion](https://affpapa.org/en/nevibecode/skills/accessible-motion.md) — skill · 723 installs
- [premium-frontend-ui](https://affpapa.org/en/nevibecode/skills/premium-frontend-ui.md) — skill · 4900 installs
- [frontend-ui-engineering](https://affpapa.org/en/nevibecode/skills/frontend-ui-engineering.md) — skill · 85500 installs
- [modern-web-design](https://affpapa.org/en/nevibecode/skills/modern-web-design.md) — skill · 3200 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
