# Rive MCP

> Rive MCP is a free MCP server for design and media. Create, edit, render and preview Rive animations from Claude without the Rive editor. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** self-hosted, CLI
- **Repository:** https://github.com/odu33104/rive-mcp
- **MCP Registry name:** io.github.ODU33104/rive-mcp
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-15

## About

Rather than driving the Rive editor, this server builds `.riv` files directly by writing the binary format from a JSON scene spec. Output is validated and previewed with the official Rive runtime (WASM) inside headless Chromium, so renders follow runtime behaviour apart from the Canvas2D differences the README lists. Audio can be embedded but only plays in a GPU-backed runtime, not in this server's own preview.

It goes well beyond shapes: bones, skinning and IK, state machines, particles, physics baking, 28 semantic motion presets such as `pop-in` and `breathing`, an OKLCH design-token generator, SVG and Lottie import, and decompiling an existing file back into an editable spec. A critique tool returns a filmstrip, onion-skin overlay and metrics so a vision model can judge motion quality.

A local web Studio gives a hierarchy, canvas, inspector and timeline with hot reload, a curve editor, a state machine graph and an agent chat where you leave feedback that the AI picks up through `riv_studio_notes`.

## Features

- **Build from a JSON spec:** riv_create writes a valid .riv with shapes, gradients, bones, state machines and presets.
- **Render to many formats:** PNG, GIF, APNG, WebM and sprite sheets, including batch jobs for CI.
- **Motion quality lint:** Rules flag robotic linear movement, teleports and missing stagger.
- **SVG and Lottie import:** Brings in vector and Lottie art as Rive shapes.
- **Local Studio:** Editor-style UI with timeline, curve editor and state machine graph.
- **Agent chat loop:** Feedback typed in the Studio reaches the AI through riv_studio_notes.

## Good for

- Generate an animated icon from a description
- Lint an existing .riv for broken references and unreachable states
- Convert a Lottie file into Rive
- Render sprite sheets for a game engine
- Generate integration code for React, Vue, Svelte or Flutter

## Install

### Claude Code (Terminal)

```sh
claude mcp add rive-mcp -- npx -y rive-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "rive-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "rive-mcp-server"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "rive-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "rive-mcp-server"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "rive-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "rive-mcp-server"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "rive-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "rive-mcp-server"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "rive-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "rive-mcp-server"
      ]
    }
  }
}
```

## Tools

- `riv_list`: Finds .riv files with size and format version.
- `riv_inspect`: Returns artboards, animations, state machines and data-binding structure.
- `riv_lint`: Static diagnostics and motion-quality rules.
- `riv_render_frame`: Renders a moment to PNG.
- `riv_render_gif`: Renders a preview GIF.
- `riv_render_apng`: Exports an animated PNG.
- `riv_render_video`: Records an animation to WebM.
- `riv_render_sprites`: Exports a sprite sheet with JSON metadata.
- `riv_batch_render`: Renders many jobs to several formats in one call.
- `riv_play_state_machine`: Sets inputs, advances and reports transitions.
- `riv_generate_code`: Generates integration code for several frameworks.
- `riv_create`: Builds a .riv from a JSON scene spec.
- `riv_design_tokens`: Generates palette, motion and spacing tokens.
- `riv_import_svg`: Imports SVG as Rive bezier shapes.
- `riv_asset_search`: Searches Iconify icons and imports one.
- `riv_lottie_import`: Converts Lottie JSON to a Rive scene fragment.
- `riv_decompile`: Converts a .riv into an editable scene spec.
- `riv_critique`: Returns filmstrip, onion skin and metrics for review.
- `riv_studio_notes`: Reads feedback left in the Studio agent chat.
- `riv_ab_compare`: Composites two files side by side into a labelled GIF or APNG.

## FAQ

### Do I need the Rive editor?

No. It works with only a .riv file and can build one from scratch.

### How many tools are there?

The README lists 35.

### Is it free?

Yes; the README describes it as a free server with no subscription.

### Does it use the network?

A few calls do, such as icon search; the README lists them under Network access.

### Is Rive MCP free?

Yes. Rive MCP is free to use.

### How do I add Rive MCP to Claude Code?

Run this command in your terminal: claude mcp add rive-mcp -- npx -y rive-mcp-server

### What are the best alternatives to Rive MCP?

The closest alternatives to Rive MCP are REA, HyperFrames by HeyGen, Context7, Chrome DevTools MCP and Codebase Memory.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## 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.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [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.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/rive-mcp
