# MotionSpec — web animation accessibility MCP

> MotionSpec — web animation accessibility MCP is an open-source MCP server for developer tools. Compile validated web animations to GSAP and CSS and audit CSS motion accessibility. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, Web
- **Website:** https://motionspec.dev
- **Repository:** https://github.com/masterplayspots/motionspec
- **MCP Registry name:** io.github.MasterPlayspots/motionspec
- **Categories:** developer tools, design and media
- **Listing updated:** 2026-11-14

## About

MotionSpec has two jobs. It compiles JSON animation specs, built from a reviewed catalog of 40 primitives, into deterministic GSAP and CSS with reduced-motion handling and loop pause controls by default. It also audits a live URL's loaded CSS for animations that ignore prefers-reduced-motion and for continuous loops with no pause path, mapped to WCAG 2.3.3 and 2.2.2.

The design principle in the README is that capability lives in the catalog, not the model: a fail-closed trust boundary means a spec cannot use a primitive, parameter or selector that has not been approved. The audit reads static CSS only; runtime JavaScript motion, flashing, video and canvas are out of scope, and a clean scan is not a conformance assessment.

Run it locally with npx motionspec, which exposes five tools without a key, or use the hosted endpoint where four tools are keyless. The compiler and server are MIT on npm. A paid Motion Report for one URL costs $9 once, and the free check is unlimited per page.

## Features

- **Spec to GSAP and CSS:** Compiles validated specs deterministically.
- **Reduced-motion by default:** Output includes prefers-reduced-motion handling and loop pauses.
- **Live URL audit:** Finds loops without pause paths and motion outside a reduced-motion guard.
- **Suggested fixes:** Reports selectors with copy-paste CSS fixes.
- **CI baseline:** An example workflow compares findings with an accepted baseline.
- **Keyless hosted tools:** Four hosted tools work without a key, rate-limited.

## Good for

- Check a client site for unpausable CSS loops
- Generate an animation with accessible defaults
- Keep a dated motion record for a handoff
- Block new motion regressions in CI

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http motionspec https://api.motionspec.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.motionspec.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "motionspec": {
      "url": "https://api.motionspec.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "motionspec": {
      "type": "http",
      "url": "https://api.motionspec.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "motionspec": {
      "serverUrl": "https://api.motionspec.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "motionspec": {
      "type": "http",
      "url": "https://api.motionspec.dev/mcp"
    }
  }
}
```

## Tools

- `motion_catalog`: Lists the reviewed animation primitives.
- `motion_validate`: Validates a JSON animation spec.
- `motion_compile`: Compiles a spec to GSAP and CSS with the reduced-motion guard by default.
- `motion_audit`: Runs the static motion check on a live URL.
- `motion_stats`: Operator telemetry for the hosted service; needs the operator key.

## FAQ

### Does it check JavaScript animation?

No, only static CSS; runtime JS and GSAP motion are outside the audit.

### Is it free?

The check and tools are free; a dated Motion Report is $9 for one URL.

### Does it fix my site automatically?

No. It suggests fixes; your team applies and tests them.

### How do I run it locally?

npx -y motionspec over stdio, no key needed.

### Is MotionSpec — web animation accessibility MCP free?

Yes. MotionSpec — web animation accessibility MCP is open source, so you can use and self-host it for free.

### How do I add MotionSpec — web animation accessibility MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http motionspec https://api.motionspec.dev/mcp

### What are the best alternatives to MotionSpec — web animation accessibility MCP?

The closest alternatives to MotionSpec — web animation accessibility MCP are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/motionspec-web-animation-accessibility-mcp
