# motionprompts

> motionprompts is a freemium MCP server for developer tools. Pick and compose GSAP animation components and fetch their build prompts from an agent. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, Web
- **Website:** https://motionprompts.dev/developers/
- **Repository:** https://github.com/vanguardiaai/motionprompts-mcp
- **MCP Registry name:** dev.motionprompts/motionprompts
- **Categories:** developer tools, design and media
- **Listing updated:** 2026-11-14

## About

motionprompts is a catalogue of 259 GSAP and WebGL animation components, each with a live demo, a copy-paste build prompt and motion metadata measured from the real code. This server lets a coding agent work through that catalogue while it builds a page, rather than copying prompts by hand.

It does not generate animation. Per the README, it hands over solved components, explains how to combine them so they do not clash, and says plainly when the catalogue has nothing suitable. The tools cover page planning, per-section mechanics, composition contracts, imagery direction and prompt retrieval.

Access is tiered. Thirty components publish full prompts for free; the remaining ones return a 12-line preview unless a Full Stack key is supplied as a Bearer token. The server is hosted at https://motionprompts.dev/mcp with no authentication for the free set, or runs locally over stdio from the npm package motionprompts-mcp.

## Features

- **Page planning:** Plans a page's sections and their roles before any component is chosen.
- **Motion metadata search:** Finds components by measured trigger, easing and duration rather than looks.
- **Composition rules:** Checks that chosen components work together and flags an under-animated page.
- **Imagery direction:** Advises which shot and model to use for each section's images.
- **Free and paid prompts:** Thirty prompts are free; others show a 12-line preview without a paid key.
- **Hosted or local:** Use the remote endpoint or the npm package over stdio.

## Good for

- Plan the sections of a landing page
- Choose scroll animations that do not conflict
- Fetch the build prompt for a hero component
- Search components by easing or duration
- Check a component set before assembling a page

## Install

### Claude Code (Terminal)

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

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

```sh
https://motionprompts.dev/mcp
```

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

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

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

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

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

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

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

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

## Tools

- `plan_page`: Returns the information architecture of a page: 9 to 14 sections with role and job, without components.
- `suggest_mechanics`: Suggests animation mechanics for one section, filtered by its role.
- `suggest_page_treatments`: Suggests page-level treatments such as smooth scroll, shaped section edges and running backgrounds.
- `get_integration_contract`: Gives repairs, mount order and budget for a set of components.
- `plan_imagery`: Directs imagery section by section, including which model to use for each shot.
- `get_component_prompt`: Returns the author's build prompt for a component with motion-system tokens.
- `search_components`: Free-text search that reports lexical coverage.
- `search_components_motion`: Searches by measured motion metadata such as trigger, easing and duration.
- `get_component`: Returns metadata, preview, prompt and source where available.
- `list_facets`: Lists the search vocabulary.
- `list_components`: Lists catalogue components.
- `list_motion_systems`: Lists the motion systems.
- `get_motion_system`: Returns the tokens of one motion system.

## FAQ

### Is a key needed?

No key is needed for the catalogue and the free prompts. Paid prompts require an MCP key from a Full Stack plan.

### Does it generate the animations itself?

No. It returns existing components and prompts and states when the catalogue has nothing suitable.

### How many components are there?

259 components, of which 30 publish their prompts as plain files.

### How do I install it locally?

Run claude mcp add motionprompts -- npx -y motionprompts-mcp; Node 20 or newer is required.

### Is motionprompts free?

motionprompts has a free plan, with paid plans for more usage or features.

### How do I add motionprompts to Claude Code?

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

### What are the best alternatives to motionprompts?

The closest alternatives to motionprompts 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/motionprompts
