About io.github.ODU33104/rive-mcp
io.github.ODU33104/rive-mcp is an MCP server in the Cloud category: free, editor-less MCP server for Rive: create, edit, inspect, render and preview .riv animations.
Install
Claude Code
claude mcp add io-github-odu33104-rive-mcp -- npx -y rive-mcp-servernpx
npx -y rive-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (32)
riv_ab_compareRender two `.riv` files under identical conditions into one labeled side-by-side (or stacked) GIF/APNG for human review — where riv_visual_diff measures a pixel-level delta, this one is for eyeballing two different things playing next to each other
Parameters not published.
riv_asset_searchSearch **Iconify's ~200k professionally designed icons** and import one directly as Rive shapes (needs network)
Parameters not published.
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
Parameters not published.
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** (`{"preset":"pop-in","target":"card"}` expands server-side into professionally tuned keyframes — entrances/exits/emphasis/ambient loops, with `stagger` for groups). Also embeds audio (WAV/MP3/FLAC) fired from timeline frames or state-machine entry — the AudioAsset/AudioEvent are written correctly but only play back in a GPU-backed Rive runtime, not this server's own preview
Parameters not published.
riv_critique**One-call review bundle that makes motion visible to a VLM**: a filmstrip (frames left→right), an onion-skin overlay (motion trails), a motion report (net displacement vector per animated object), objective metrics (bezier ratio, palette flags, easing distribution) + lint findings + a fixed 7-axis scoring checklist incl. spatial/directional coherence (does each mover travel toward its artwork's front? is the perspective consistent?)
Parameters not published.
riv_decompile**.riv → editable scene spec**: study or remix professional files (bezier paths, gradients, solos, trim paths, animations with named easings); unsupported types are counted, not silently dropped
Parameters not published.
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
Parameters not published.
riv_diffStructural diff between two `.riv` files
Parameters not published.
riv_dumpLow-level binary structure dump (typeKeys / properties / hierarchy)
Parameters not published.
riv_editLossless editing of existing `.riv` files: set properties, swap named text, delete subtrees, **add/replace/remove keyframes**
Parameters not published.
Show all 32 tools
riv_extract_assetsExtract embedded images/fonts from a `.riv`
Parameters not published.
riv_generate_codeIntegration code with real artboard/SM/input names (React / JS / Vue / Svelte / Flutter)
Parameters not published.
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 primitives. Fragments plug into riv_create via `imports`
Parameters not published.
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 it
Parameters not published.
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, **motion-quality rules** (all-linear "robotic" movement, teleporting objects, missing stagger, one-sided scale)
Parameters not published.
riv_listRecursively find `.riv` files (size, format version)
Parameters not published.
riv_lottie_import**Lottie/bodymovin JSON → Rive scene fragment** — pulls in LottieFiles' huge library of free professionally-animated assets art *and* choreography: keyframed transforms with exact bezier easing curves (not preset-approximated), path morphing (per-vertex keyframes), shape/null/precomp layers, gradients, trim-path draw-on, visibility windows. Unsupported bits (text layers, masks, mattes, …) are counted, not silently dropped
Parameters not published.
riv_optimizeShrink a `.riv` without changing its visual output: remove unreferenced interpolators/events/empty tracks left over from prior edits, thin redundant keyframes on strictly-linear runs (Douglas-Peucker, easing-safe — cubic/hold segments are never touched), with a `dryRun` report of the plan
Parameters not published.
riv_play_state_machineSet/fire inputs → advance → state-transition report (+ optional frame captures)
Parameters not published.
riv_render_apngAnimated PNG export — 24-bit color + alpha transparency (plays on GitHub)
Parameters not published.
riv_render_frameRender any moment to PNG (inline image + file)
Parameters not published.
riv_render_gifTurn an animation into a preview GIF
Parameters not published.
riv_render_spritesSprite-sheet PNG + JSON metadata (for game engines)
Parameters not published.
riv_render_videoRecord an animation or state machine to WebM video
Parameters not published.
riv_rig_character**Character PNG → fully rigged `.riv` in one call**
Parameters not published.
riv_setup**One-call environment setup**: installs the bundled `rive-design-guidelines` skill into `.claude/skills/` (project) or `~/.claude/skills/` (user) so the pro workflow auto-triggers — confirmation happens via the normal tool-permission prompt
Parameters not published.
riv_slice_imageCut character parts out of a PNG by polygon (for cutout rigging)
Parameters not published.
riv_studio**Local web Studio**: Rive-editor-style dark UI — hierarchy tree, canvas select/drag/resize, inspector, keyframe timeline editing, **bezier curve editor** (drag control points, hold/linear/cubic, 10 easing presets), **state machine graph view** (node graph, transition details, lint-highlighted states, live playback highlighting), **onion skin** overlay, undo/redo, playback speed, one-click export (PNG/APNG/GIF/WebM), live preview + hot reload, EN/JA
Parameters not published.
riv_studio_notesRead the Studio's Agent chat (with auto-attached context: selection, artboard, animation, playback time) and post replies back into it
Parameters not published.
riv_ui_detect**Read a UI screenshot** — or, with `svgPath`, a Figma/Illustrator SVG: finds panels, text runs and pictures, returns a nested element tree with rects, corner radii and fill colours plus a numbered overlay PNG. Each element says how it would be rebuilt (`vector-panel` / `vector-shape` / `vector-text` / `raster`) and what it looks like (`panel` / `text` / `image` / `line`) as separate fields. Geometry only — it does not know a button from a card
Parameters not published.
riv_ui_prototype**Screenshot → animated `.riv` in one more call**: assign a role to each detected element and get a working prototype — vector rectangles where they can be rebuilt, image slices where they cannot, an entrance per role, hover and press on cards and buttons. Text is cut out with a real alpha matte where the colour model holds; where it does not, the element fades in place instead of moving, and the warnings say so
Parameters not published.
riv_visual_diffPixel diff of two `.riv` files with a highlighted diff image
Parameters not published.
Ask AI
✦
Ask AI about io.github.ODU33104/rive-mcp
Powered by Claude · Grounded in docs
I know everything about io.github.ODU33104/rive-mcp. Ask me about installation, configuration, usage, or troubleshooting.
Security checks
6 checks have not been run yet.