RiveMCP

MCP server for programmatically creating and editing Rive animation files. Let AI build your animations.

What is RiveMCP?

RiveMCP exposes 139 MCP tools that let any AI assistant (Claude, GPT, etc.) create complete Rive animations from natural language. Describe what you want, and the AI builds it — shapes, colors, animations, state machines, physics, and more — then exports a .riv file you can use in your app or a .rev file you can open in the Rive Editor.

Quick Start

Install via npm (recommended)

npm install -g rivemcp

This automatically downloads the correct binary for your platform. No Node.js runtime needed at execution time.

Configure your AI client

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "rivemcp": {
      "command": "npx",
      "args": ["-y", "rivemcp"]
    }
  }
}

Claude Code:

claude mcp add rivemcp -- npx -y rivemcp

Cursor / VS Code (settings.json):

{
  "mcp.servers": {
    "rivemcp": {
      "command": "npx",
      "args": ["-y", "rivemcp"]
    }
  }
}

Manual install (alternative)

Download the binary for your platform from Releases:

chmod +x rivemcp-macos-arm64
# macOS only — remove quarantine:
xattr -d com.apple.quarantine rivemcp-macos-arm64

Then point your MCP client at the binary path directly.

4. Start creating

Ask your AI to create animations:

"Create a bouncing ball animation with a blue gradient background"

"Build a loading spinner with 3 dots that pulse in sequence"

"Make a button that changes color on hover with a state machine"

The AI will use RiveMCP's tools to build the animation, then export a .riv file.

Features

Shapes & Styling

Rectangles, ellipses, triangles, polygons, stars, custom vector paths. Solid fills, gradient fills, strokes, dash paths, trim paths, feathering, blend modes.

Animation

Keyframe animations with linear, cubic, and elastic interpolation. Animate any property — position, size, rotation, scale, opacity, color.

State Machines

Interactive animations with triggers, boolean and number inputs, transitions with conditions, listeners for pointer events.

Physics (HLAPI)

Bake realistic physics into keyframes at compile time — gravity, bounce, wind, spring forces. No runtime physics engine needed.

Prefabs & Particles

Spawn shapes from templates (rocks, dust clouds, sparks, rain, snow, bubbles). Emit particle systems with physics.

Scene Composition

Describe an entire scene in one call — backgrounds, shapes, motion, timing — and get a complete .riv file.

Text & Fonts

Rich text with multiple runs, custom fonts, text modifiers, follow-path text.

Images & Assets

Embed images, audio, Lottie animations, and SVGs. Mesh deformation for image warping.

Bones & Skinning

Skeletal animation with bones, IK constraints, skins, and tendons.

Nested Artboards

Reusable components via nested artboards with animation and state machine control.

Data Binding

ViewModels with typed properties, instances, data converters, and formula tokens.

Import & Roundtrip

Load existing .riv files, modify them, and re-export. Lossless roundtrip for unmodified content.

Rive Editor Export

Export .rev files that open directly in the Rive Desktop Editor for further manual editing.

Tool Categories

... View full README on GitHub