Rive MCP Server

Free, editor-less MCP server for Rive: create, edit, inspect, render and preview .riv animations

Local serverstdio

What is the Rive MCP Server?

Free, editor-less MCP server for Rive: create, edit, inspect, render and preview .riv animations

The short version

rive-mcp is a free MCP (Model Context Protocol) server that gives Claude (or any MCP client) full control over .riv files. Unlike the official Rive MCP (which requires the editor running) or paid third-party servers, it works with nothing but a .riv file — and it can even build .riv files from scratch by serializing the binary format directly.

  • Losslessly edit existing .riv — — change any property, swap text, delete subtrees (references auto-remapped); round-trip verified pixel-perfect
  • Human ⇄ AI loop — — an "Instructions for AI" box in the Studio: you type feedback, the AI picks it up via riv_studio_notes (now auto-attached with the current selection/artboard/animation/time context) and fixes the file, your browser updates instantly
  • Auto-rig characters — — one call turns a character PNG into a rigged .riv with cutout parts, bone-skinned head mesh, eye blink, idle/happy animations and a state machine
  • Everything verified — — generated files are loaded, rendered and state-machine-driven by the official runtime in E2E tests

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
riv_listRecursively find .riv files (size, format version)
riv_inspectFull metadata: artboards, animations (duration/fps/loop), state machines and inputs, plus data-binding structure (ViewModel definitions, instances with resolved values, enums, converters, bind wiring) when the file uses
riv_lintStatic diagnostic: broken references, oversized embedded assets, unreachable state-machine states, unconditional self-transitions (infinite-loop risk), unused inputs, easing silently discarded on a track's last keyframe,
riv_render_frameRender any moment to PNG (inline image + file)
riv_render_gifTurn an animation into a preview GIF
riv_render_apngAnimated PNG export — 24-bit color + alpha transparency (plays on GitHub)
riv_render_videoRecord an animation or state machine to WebM video
riv_render_spritesSprite-sheet PNG + JSON metadata (for game engines)
riv_batch_renderRender a list of jobs — single files or globs — to png/gif/apng/webm/sprites in one call; per-job error isolation and a timing report, built for CI
riv_play_state_machineSet/fire inputs → advance → state-transition report (+ optional frame captures)
riv_generate_codeIntegration code with real artboard/SM/input names (React / JS / Vue / Svelte / Flutter)
riv_create**Build a .riv from a JSON scene spec** — validated with the official runtime, returns a preview. Supports bezier-handled vertices, elastic easing, gradients, physics baking, particles, and **semantic motion presets** ({
riv_design_tokens**Generate design tokens before designing**: OKLCH-harmonized palette (+WCAG contrast), gradient pairs, Material-Motion durations & easing roles, spacing/radius/type scales — deterministic from seed color + mood
riv_import_svg**SVG → Rive bezier shapes** (Figma/Illustrator exports, icons, illustrations): full cubic vertices, multi-contour paths, gradients, strokes, nested transforms — so the AI composes pro artwork instead of drawing with pri

How to install the Rive MCP Server

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

Add to claude_desktop_config.json, then restart Claude Desktop.

Example prompts to try

  • “Use Rive to riv list.”
  • “Use Rive to riv inspect.”
  • “Use Rive to riv lint.”

Frequently asked questions

Free, editor-less MCP server for Rive: create, edit, inspect, render and preview .riv animations Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.