Lets an AI client find, preview, and render brand-aware motion graphics like lower thirds, titles, and 3D elements as code.
Also known as monarcpro/volito
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.4.0
- Last commit
- Nov 8, 2026
- License
- —
What is Volito MCP?
Volito lets an AI client find, preview, and render brand-aware motion graphics like lower thirds, titles, and 3D elements as code.
Summary generated from the project's README
About Volito MCP server
Generating brand-aware motion graphics through code is what Volito enables for developers and AI agents. It functions as a motion graphics engine that allows users to find, preview, and render elements like lower thirds, 3D titles, and kinetic typography. Because every graphic is a small program, an AI client can write, fix, or modify the code directly to achieve specific visual results.
Users interact with the engine via a CLI, a Node API, or an MCP server that provides tools to Claude Code, Cursor, and other agents. The system includes 217 ready-made graphics across fifteen packs, such as Social, Data, and Transitions. It supports various aspect ratios including 16:9, 9:16, 1:1, and 4:5, and can render to formats like ProRes 4444, HEVC, WebM, MP4, GIF, PNG, or SVG. To render video formats, ffmpeg must be available on the system path.
What you can do with it
- 1Create voice-synced captionsDevelopers can use a transcript to ensure text overlays land exactly on the spoken words.
- 2Automate complex motion choreographyYou can instruct an agent to apply specific entrance and exit animations to different parts of a graphic.
Written from the project's README. Every use case is checked against a quote from it.
How to install Volito MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Volito MCP in Claude Code
$ claude mcp add volito -- npx -y volitoInstall Volito MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"volito": {
"command": "npx",
"args": [
"-y",
"volito"
]
}
}
}Install Volito MCP in VS Code
.vscode/mcp.json
{
"servers": {
"volito": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"volito"
]
}
}
}Install Volito MCP in VS Code CLI
$ code --add-mcp '{"name":"volito","type":"stdio","command":"npx","args":["-y","volito"]}'Install Volito MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"volito": {
"command": "npx",
"args": [
"-y",
"volito"
]
}
}
}Install Volito MCP in Codex
$ codex mcp add volito -- npx -y volitoInstall Volito MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.volito] command = "npx" args = ["-y", "volito"]
Install Volito MCP in Gemini CLI
$ gemini mcp add -s user volito npx -- -y volitoInstall Volito MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"volito": {
"command": "npx",
"args": [
"-y",
"volito"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachablemonarcpro/volito is public and reachablegithub.com/monarcpro/volito ↗Pass
- Package names this repository as its sourcevolito names monarcpro/volito as sourcenpmjs.com/package/volito ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-09github.com/monarcpro/volito ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from volitoPass
- No critical advisory in the package or its dependencies123 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubBy MONARC STUDIOS, the team behind MONARC PRO. Volito is the motion graphics engine
inside the MONARC PRO video editor, opened up; the name is Latin for “to flutter”.
Every graphic is a small program — function frame(t, $) returns the SVG of one frame — so it is
readable, diffable, seekable to any frame, and something an AI agent can write and fix. It ships with
217 ready-made graphics in fifteen packs (3D, maps, transitions, kinetic type, captions on the voice, interactive UI and filter effects among them), 36 brand styles,
sixteen animated patterns, a CLI, a Node API, a browser player and an MCP server, and renders to ProRes 4444 or HEVC with alpha, WebM, MP4, GIF, PNG frames or SVG.
- One design, every brand. Items draw with colour roles and faces, not fixed colours: pass one of 36
built-in styles, your
DESIGN.md, or a couple of overrides, and the whole pack re-skins. - One design, every aspect. Layouts follow the canvas and keep to title-safe areas, including the space platforms reserve on 9:16. 16:9, 9:16, 1:1 and 4:5 from the same item.
- On the voice. Give a transcript and text lands on the words that say it.
- Drops onto footage. Overlays render with real alpha for Premiere, Resolve, Final Cut, After Effects and CapCut.
- Sounds like it moves.
--soundgives any render a sound track Volito synthesises itself — a pop for every spring, a whoosh for every move across the frame, ticks for letters, a hit for a slam, a bed in a key — and a program can design its own cues beside its frames. - Agent-native. An MCP server gives Claude Code, Cursor and other agents tools to find, preview (as an image they can see), check and render graphics — or to write their own.
- Many scripts. Latin, Latin Extended, Vietnamese, Cyrillic, Greek and Devanagari (Hindi), shaped properly.
npx volito render lower-third \
--prop name="Priya Sharma" --prop role="Product designer" \
--style ember --aspect 16:9 --out priya.mov
Install
npm install volito # or run it with npx, nothing to install
Volito was first published as @monarcpro/motion; that package is deprecated in favour of this one.
Node 20.10 or newer. Video formats need ffmpeg on your PATH (or VOLITO_FFMPEG);
stills, contact sheets and PNG frames do not. WebM needs an ffmpeg built with libvpx.
The packs
217 graphics in fifteen packs. Every one takes any brand style and any aspect, and every part of it takes any move.
| Pack | Items |
|---|---|
| Essentials (19) | lower-third · title-card · headline (kinetic, on the voice) · subscribe · social · callout · stat · bar-chart · steps · quote · banner · end-card · logo-sting · wipe · chapter (outlined number, chapter segments) · logo-wall ("trusted by" wordmarks) · progress-bar (export, upload) · before-after (a handle that sweeps) · agenda (topics and timestamps) |
| Broadcast (10) | Lower thirds in five looks — lt-bars, lt-reveal (mask reveal), lt-kicker, lt-pill (picture or initials, status dot), lt-news (tight boxes) — ticker (crawl), live-badge (viewers, clock), score-bug (teams, scores, clock, goal flash), location (pin and place card), countdown |
| Social (13) | follow-card (profile, count, Follow press) · notification (phone or desktop) · notifications (a stack that cascades) · comments (typing on) · chat (thread with typing dots) · post (counts and a heart) · now-playing (music card) · rating (stars, score, review) · poll (bars fill to results) · milestone (count rolls to the goal, confetti) · story (story frame over footage) · live-chat (stream chat) · joined (avatar group) |
| Data (14) | line-chart (draws on, target line) · donut · bar-race (overtaking across periods) · goals (meters) · versus · timeline (milestone cards) · funnel · world-map (a choropleth: one colour scale, legend, source, regions) · flight (a great-circle route between two places) · heatmap (calendar) · gauge (needle dial) · kpi-grid (tiles with change chips and trends) · waffle (one cell a percent) · leaderboard |
| 3D (9) | logo-3d (extruded wordmark, light sweep) · title-3d (letters flip up) · number-3d (an extruded counter) · card-flip (front and back) · cube (a word prism that rolls) · bars-3d (orbiting camera) · globe (spins to a country, routes arc in) · exploded-stack (isometric layers spread apart with labels) · iso-blocks (an isometric block chart) |
| Carousels (5) | Your pictures, or tiles in the brand's colours: ring-carousel (a ring that swings card to card) · orbit-carousel (cards orbit a title) · path-carousel (a conveyor along a curve) · text-ring (words circling a centre) · cover-flow |
| Transitions (11) | Cover the frame by the cut, reveal the next shot: iris (circle, diamond, star, square) · blinds · doors (with a Bauhaus disc) · glitch · ink (wobbly blooms) · clock · tiles (Bauhaus shapes) · pixels · stripes · slices · whip — each with a word at the cut |
| Annotate (15) | Point at things in footage (places in % of the frame): arrow (hand-drawn or clean) · circle · spotlight (feathered dim) · focus (brackets that lock on) · highlight (highlighter, underline, box, strike) · stamp (pressed ink) · reactions (live hearts, likes, fire) · pointer (leader line and card) · emphasis · markers (numbered) · bracket (curly brace and note) · box-label (box with a tab) · cursor (glides in and clicks) · measure (dimension line) · check (tick or cross) |
| Cursors (5) | Over screen recordings: agent-cursor (an AI agent types each step and clicks) · multiplayer (people's cursors with name tags) · drag-drop (a file dragged to a drop zone) · text-select (a selection and its toolbar) · context-menu (a right-click menu) |
| Type (16) | Kinetic type: typewriter · word-swap (a word that keeps changing) · split-flap · marquee (tilted scrolling bands) · echo · liquid-fill · decode · word-by-word · key-phrase (marker on marked words) · stack (editorial) · slot (a reel that rolls and lands) · outline-draw (traced, then filled) · flex (weight in a wave) · shimmer (a sheen sweeps across) · stream (an AI answer streaming in) · tile-flip (tiles turn over to a second headline) |
| Captions (67) | On the voice from a transcript (see Captions on the voice): camera-follow (a camera that follows the words) · karaoke · pop · subtitles, 30 motion styles (marker, neon-tubes, scramble, slam, typed, flipboard, lyrics, messages, crawl …), 23 social looks — line styles (index-card, tape-bars, punch-outline, ember-caps …) and key-word lockups (headline-word, tide-poster, circled-word, notebook …) — and 10 script styles: pen-write · cursive-neon · groovy-script · script-sandwich · swash-mark · vow-script · brush-ribbon · script-fill · doodle-script · script-duet |
| Backdrops (14) | Moving grounds: pattern (any of the sixteen) · aurora · tiles (Bauhaus field) · retro-grid (synthwave) · blobs (lava goo) · gradient · starfield · bokeh · topo · halftone (riso screens) · waves · orbits · dot-grid (ripples) · paper-cut (layered hills) |
| Promo (8) | sale-badge (starburst) · price-card (counts down, strike, click) · coupon (copy the code) · offer-countdown (D:H:M:S) · features (checklist) · cta (button and cursor) · launch · ribbon (crossing tapes) |
| UI (5) | Interactive states (see Interactive states): button (idle, hover, press, loading, done) · toggle · like (rolling count) · loader (success or failure) · bell (badge, read) |
| Effects (6) | SVG filters, no GPU: grain (film grain, re-rolled every film frame) · light-leak · glass (frosted card over drifting colour) · chromatic (channels split and snap) · warp (liquid ripple settling) · neon (flickers on) |
volito info <item> lists every prop. To see them all live, serve this package's folder and
open examples/gallery.html.
Motion without limits
Every item is made of named parts (volito info lower-third lists them: scrim, spine, plate,
name, role). Any part takes any move, and the moves combine freely:
volito render lower-third \
--motion name.in=typewriter --motion plate.in=iris --motion "*.ease=bouncy" \
--motion role.emphasis=pulse@2 --motion spine.idle=pulse --out priya.mov
| Setting | Takes |
|---|---|
in, out |
38 moves — rise drop slide smear arc pop zoom push grow wipe iris shutter blinds diagonal blur flip turn spin roll swing skew stretch squash bounce elastic slam tilt float glitch flicker typewriter scramble … An exit plays its move backwards. |
ease |
out inOut expo back elastic bounce, springs snappy punchy bouncy calm wobbly, or spring(f,d), steps(n), cubic(x1,y1,x2,y2) |
from, outFrom |
the side a move comes from or leaves to (left, right, up, down, diagonals) |
dur, delay, at, outAt, distance, intensity, origin, blur |
timing, travel, scale, pivot, motion blur |
idle |
a loop while it holds: float bob pulse breathe wiggle sway drift jitter spin heartbeat shimmer |
emphasis |
hits at a time, a beat or a spoken word: "shake@1.2, pop@now" (pulse pop shake jump wobble flash spin rubber tada) |
split, order, stagger |
text whole, or by lines / words / letters, forward reverse center edges random |
keys |
your own keyframes: [{"t":0,"x":-300,"op":0},{"t":0.8,"x":0,"op":1,"ease":"bouncy"}] — any path |
Or let it choreograph itself: --mood energetic | elegant | playful | cinematic | glitchy | minimal | retro | kinetic,
and --seed <n> for a new take on every number (the same number always moves the same way). --speed 2 plays
it all twice as fast. volito moves lists everything. Programs you write get the same kit:
const M = motion($, t); M.part("card", { at, in: "pop", box }, markup).
3D and maps
The 3D items are real geometry, not tricks: meshes are lit, faces turned away are culled, everything is sorted far to near and projected through a perspective camera — then drawn as SVG paths, so 3D renders on any machine with no GPU, at the same speed as the rest. 3D text is extruded from the outlines of the bundled faces (read straight from the font files), so a logo turns in the brand's own type.
function frame(t, $) {
const S = scene3d($, { camera: { yaw: -20 + 40 * (t / $.dur), pitch: -8 } });
S.add(S.text("VOLITO", { face: $.font("display"), size: 220 * $.k, depth: 60 * $.k, color: $.c.fg, side: $.c.accent }));
return S.render();
}
Maps use Natural Earth's countries (177, packed into 30 KB): worldMap($, { center, zoom }) projects them
flat (Equal Earth), worldGlobe(S, …) puts them on a 3D globe, and worldFind("UK") finds one by name,
short name or ISO number. volito api documents both.
Captions on the voice
The captions pack turns a transcript into captions: each word comes in when it is said, phrases break
where a reader would, and a sentence's last word stays with its line. Give Whisper JSON (or [{w, s, e}])
with --words; add text to caption your own wording timed to the voice, or give text alone to pace it
evenly.
volito render captions/karaoke --words talk.json --aspect 9:16 --out captions.mov
volito render captions/pen-write --words talk.json --prop accents=launch,free --out signed.mov
volito render captions/tape-bars --words talk.json --style cobalt --prop palette=brand --out brand.mov
Starred words in text, or the words listed in accents, are key words; the lockup styles build each
phrase around its key word (the longest one when none is marked). Styles with colours of their own take
palette: brand to use the brand's accents instead. Over footage, render ProRes 4444 or WebM with alpha.
Sound design
Every render can carry sound, and Volito makes it the way it makes pictures: from code, from nothing. No
sample library, no files to find. --sound reads the graphic's own motion — every part's move leaves a
mark — and gives each its sound: a spring pops, a move across the frame whooshes (louder the further it
travels), letters tick, a typewriter types, a slam hits, a glitch zaps, a burst sparkles. --bed Dm lays
a pad under it in a key, and it steps back under every hit on its own.
volito render logo-sting --prop wordmark=VOLITO --sound --bed Dm --format mp4 --out sting.mp4
volito sound lower-third --prop name="Priya Sharma" --out priya.wav # the track alone, with its cue list
A program designs its own sound beside its frames — function sound($) runs once with the same $
($.dur, $.beat, $.at(word), $.data), so cues land on the same beats the picture uses:
function sound($) {
return {
cues: [
{ at: 0.2, kind: "riser", dur: 1.1 },
{ at: $.beat("in", 1.3), kind: "hit", level: 1.1 },
{ at: 1.5, kind: "shimmer", dur: 1.2, pan: 0.3 },
{ at: -0.6, kind: "ding", note: "A5", level: 0.6 }, // negative counts from the end
],
bed: { key: "D", mode: "minor", from: 0.8, to: -0.4, level: 0.5 },
auto: false, // true adds the motion's own cues on top
};
}
| Kind | |
|---|---|
whoosh swell riser fall |
air past, soft air rising, a climb into a moment, the fall after it |
hit stamp sub pop |
an impact, a heavy slam, a low drop, a bubble pop |
tick click type scratch |
one letter or step, a UI click, keys for a while, pencil on paper |
shimmer ding zap |
sparkle, a bell (note: "A5"), a glitch |
tone chord |
a note, the bed's chord — for a sting that resolves |
Each cue takes at, dur, level (0–2), pitch (semitones), pan (-1…1) and seed. The track is
stereo 48 kHz, limited, with a room; --sound-out track.wav writes it alone for an editor's timeline
beside a ProRes overlay. MP4 and HEVC carry AAC, ProRes carries PCM, WebM carries Opus; PNG and GIF carry
none. volito api prints the whole sound reference.
CLI
volito list # every item
volito info stat # what it is, every prop
volito styles # the built-in brand styles
volito moves # every move, ease, idle, hit and mood
volito sheet title-card --mood playful --seed 7 # a new choreography
volito sheet stat --prop value=72 --prop suffix=% --prop chart=ring # frames across time, one PNG
volito still title-card --aspect 9:16 --t 1.5 --out frame.png
volito render banner --prop headline="Doors open at 9" --format webm --out banner.webm
volito check ./my-graphic.js # run it at every aspect, report problems
Graphic specs
Any set of options can be saved as a spec: one JSON file for one graphic that every command takes in place of an item. Keep it in your repo, review it, hand it to an agent; options on the command line win over it.
volito spec lower-third --prop name="Priya Sharma" --style ember --aspect 9:16 --out priya.volito.json
volito validate priya.volito.json # its props, parts, files and aspect against the item
volito render priya.volito.json --prop role="Founder"
volito schema # the JSON Schema (also at https://volito.dev/schema/graphic.v1.json)
{
"$schema": "https://volito.dev/schema/graphic.v1.json",
"volito": 1,
"item": "essentials/lower-third",
"props": { "name": "Priya Sharma", "role": "Product designer" },
"style": "./DESIGN.md",
"aspect": "9:16",
"motion": { "name": { "in": "typewriter" } },
"mood": "elegant",
"seed": 4,
"sound": { "bed": "Dm" },
"render": { "format": "mov", "out": "renders/priya.mov" }
}
Paths inside a spec (a DESIGN.md, a program, a transcript, image props) are relative to the spec file.
program points at your own frame(t, $) file, or code holds it inline. volito bundle priya.volito.json
packs the spec and those files into one priya.volito that every command takes, anywhere.
Review before you render
volito review lower-third --prop name="Priya Sharma" --aspect 9:16
The check at each aspect, then what the frames show: when the graphic settles, how long it holds still and
when it leaves (with a warning when the entrance is slow or the hold too short for its words), how much of
an overlay sits under Reels', Shorts' and TikTok's interface at 9:16, and a contact sheet per aspect in
volito-review/<item>/ with a review.md.
| Option | |
|---|---|
--prop name=value |
a prop (repeat). Lists: "a; b; c". Chart rows: "Label: 42; Other: 17" |
--props <json or file> |
every prop at once |
--image name=path |
a picture for an image prop (a file or URL) |
--style <name or DESIGN.md> |
a built-in style or your brand's DESIGN.md |
--accent --accent2 --ink --paper #hex · --mode dark|light · --display --text Font:900 |
overrides on the style |
--aspect 16:9|9:16|1:1|4:5|WxH · --duration s · --fps n · --width px |
the frame |
--bg #hex|transparent |
a ground under the graphic |
--words transcript.json · --offset s |
land text on a voice ([{w, s, e}] or Whisper JSON) |
--motion part.setting=value |
how a part moves (repeat; * for every part) — see Motion without limits |
--mood m · --seed n · --speed x |
a choreography, a new take per seed, faster or slower |
--beat in=0.4 --beat out=-0.6 |
move the entrance and exit (negative counts from the end) |
--sound · --bed Dm · --sound-level x · --sound-out file.wav |
a sound track synthesised by Volito (see Sound design), a pad in a key, its level, the track alone |
--packs <dir> |
more packs (also VOLITO_PACKS) |
--format mov|webm|mp4|hevc|gif|png |
for render; png/svg for still |
| Format | |
|---|---|
mov |
ProRes 4444 with alpha — the default; for every desktop editor |
hevc |
HEVC with alpha in .mov — small files for Final Cut, iMovie, Safari (macOS) |
webm |
VP9 with alpha — for the web and CapCut |
mp4 |
H.264, no alpha — drawn on --bg (black) |
gif |
animated GIF, 1-bit transparency |
png |
a folder of PNG frames with alpha |
AI agents (MCP)
npx volito init # adds the server for Claude Code, Cursor and VS Code, and the skill
npx volito doctor # what is ready: Node, FFmpeg formats, fonts, each agent's setup
Or by hand: claude mcp add volito -- npx -y volito mcp, codex mcp add volito -- npx -y volito mcp, and for
Cursor, Windsurf and other MCP clients:
{ "mcpServers": { "volito": { "command": "npx", "args": ["-y", "volito", "mcp"] } } }
| Tool | |
|---|---|
motion_list |
find graphics by words or category |
motion_info |
an item's props (and its source with code: true) |
motion_styles |
the brand styles |
motion_preview |
a contact sheet as an image — the agent sees how it moves and whether text fits |
motion_still |
one frame as an image |
motion_check |
errors and warnings at every aspect |
motion_render |
render to a file and return its path (sound: true muxes a synthesised track, bed: "Dm" a pad) |
motion_sound |
the graphic's sound alone as a .wav, with its cue list |
motion_moves |
every move, ease, idle, hit and mood the motion settings take |
motion_validate |
check a Graphic spec (inline or a file) against its item before rendering |
motion_review |
timing, 9:16 platform safe zones and a contact sheet per aspect, measured before rendering |
motion_api |
the program API and the motion kit, for writing new graphics |
The preview, still, check, review, render and sound tools take an item, your own code or a spec file, plus motion, mood, seed and speed. A ready-made agent skill is in skills/volito/SKILL.md — npx volito init installs it for Claude Code, npx skills add monarcpro/volito for other agents, or copy it
to ~/.claude/skills/volito/ for Claude Code.
Node API
import { findItem, renderVideo, renderStill, renderSheet, checkItem } from "volito";
const item = findItem("essentials/lower-third");
const result = await renderVideo(item, {
props: { name: "Priya Sharma", role: "Product designer" },
style: "ember", // or the text of a DESIGN.md, or { colors, fonts, … }
colors: { accent: "#00A86B" }, // overrides
aspect: "9:16",
out: "priya.mov",
});
console.log(result.file, result.frames, result.warnings);
Browser
import { loadRegistry, findItem, createPlayer } from "volito/browser";
const registry = await loadRegistry(); // the packs, from jsDelivr (or pass your own base URL)
const player = await createPlayer(canvas, findItem(registry, "headline"), {
props: { text: "Stop editing. *Start directing.*" },
style: "neon",
aspect: "16:9",
});
player.play(); // also: pause(), seek(t), update({ props }), destroy()
The player runs each program in a sandboxed Web Worker and draws through the same SVG path as the
renderer, so what plays on the page is what renders. Fonts load from base (the package's own
fonts/ on jsDelivr by default); serve the package's fonts/ and dist/registry.json to stay offline.
Volito MCP questions
How do I add Volito MCP to Claude Code?
Run claude mcp add volito -- npx -y volito in your terminal. Add --scope user to make it available in every project.
How do I add Volito MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How does Volito handle branding?
It uses color roles and faces rather than fixed colors, allowing you to apply one of 36 built-in styles, a custom DESIGN.md, or specific overrides to reskin entire packs.
Can AI agents use Volito?
Yes, Volito includes an MCP server that provides tools for agents like Claude Code and Cursor to find, preview, check, and render graphics or write their own.