text2animate
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@text2animate animate a goose waddling through grass, playful style"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
text2animate
Turn plain-language descriptions into animated SVGs — and refine them in a live chat, right from your editor.
An MCP server that lets Claude (or any MCP client) compose animated SVGs from text, preview them in a clean floating UI, and iterate on them conversationally.

Why
LLMs are good at writing SVG, but "make me an animation" usually produces something stiff and templated. text2animate fixes that two ways:
It bakes in motion-design best practices — layered scenes, natural easing, anticipation/overshoot, seamless loops, restrained palettes — and hands them to the model before it draws anything.
It closes the feedback loop. The result renders instantly in a local preview, and a chat box under the animation lets you say "make the goose have webbed feet and add parallax mountains" — the change applies live, through your own Claude Code session.
No API key, no separate billing — edits run on the model you're already using.
Related MCP server: PinePaper MCP Server
How it works
create_animation
┌──────────┐ ──────────────────► ┌──────────────────┐ ──► Preview UI
│ Claude │ │ text2animate │ (floating,
│ (MCP host)│ ◄────────────────── │ MCP server │ ◄── live over SSE)
└──────────┘ await_edit_request └──────────────────┘
▲ (long-poll for your │ embeds best practices
│ typed changes) │ validates + stores SVG
└─ apply_patch / apply_edit ───────────┘ serves the local UIThe model is the renderer's brain. Guided by the embedded best practices, it writes
a self-contained <svg> with @keyframes/SMIL animation. The server validates it,
stores it, and serves a preview. When you type a change, the server queues it and the
in-session agent picks it up, edits the SVG, and the preview refreshes.
Install
Option A — Claude Code plugin (recommended)
No clone, no build. In Claude Code:
/plugin marketplace add tom-pettit/text2animate
/plugin install text2animate@tom-pettitThat registers the MCP server (it runs a prebuilt, dependency-free bundle), so just ask:
"Use text2animate to animate a goose waddling through the grass, playful style."
The preview opens automatically at http://127.0.0.1:4321. The CLI equivalent:
claude plugin marketplace add tom-pettit/text2animate
claude plugin install text2animate@tom-pettitOption B — from source (for development)
git clone https://github.com/tom-pettit/text2animate.git
cd text2animate
npm installnpm install builds the server and auto-registers it in the surrounding
workspace's .mcp.json (merging — it never clobbers other servers). Restart Claude
Code to pick it up.
Registering somewhere specific, or not at all:
npm run register -- ~/.mcp.json # a specific config file
npm run unregister # remove the entry
T2A_NO_AUTO_REGISTER=1 npm install # skip auto-registrationResolution order: explicit path → T2A_MCP_TARGET env → <repo-parent>/.mcp.json.
Styling the look
Tell it the aesthetic and the server feeds concrete art direction (palette, shape language, motion feel, typography) to the model. Use a preset or any freeform phrase:
"Animate a loading spinner, minimalistic but modern."
Built-in presets: minimal-modern, playful, neon-cyber, flat-corporate,
hand-drawn, retro-80s. The chosen style is recorded and shown in the preview's
properties panel.
Live editing (the chat box)
Under the animation is a ChatGPT-style box. Type a change and it round-trips through your Claude Code session:
The box queues your request on the server.
The agent's watch loop (
await_edit_request) is long-polling — it unblocks with your text and the current SVG.The agent applies the change; the preview updates live.
Fast iteration. Small tweaks (color, size, timing, text, easing) go through
apply_patch — the agent sends a tiny find/replace instead of re-emitting the whole
document, so a recolor is ~10 tokens rather than a full regeneration. Structural
changes fall back to apply_edit. A bad patch is rejected wholesale (nothing
changes) so the request stays open to retry.
To turn it on, tell Claude once: "watch the preview for edits" — it keeps calling
await_edit_request. Pairs naturally with /loop, and /fast makes each turn
snappier. The box shows a green dot when a watcher is connected, amber when it
isn't.
Preview UI
A light, floating interface (no chrome docked to the edges):
Artboard — the animation in a 16:9 frame, centered on a warm canvas.
Animations panel (left) — everything created this session.
Properties panel (right) — style, duration, loop, and Export SVG.
Playback (bottom-right) — play/pause (
Space) and restart (R); pausing freezes both CSS@keyframesand SMIL timelines.Chat dock (bottom) — the live-edit box plus the watcher status.
Tools, resources & prompts
Tool | Purpose |
| The animation guidelines. Optional |
| List the built-in style presets. |
| Render a self-contained animated |
| List animations created this session. |
| Long-poll for a change typed into the preview's chat box. |
| Fast edit: apply small find/replace tweaks in place. |
| Apply a fully regenerated SVG in place. |
| Ensure the preview server is running and open it. |
Also exposed: an animation-best-practices resource and an animate prompt.
Configuration
Variable | Default | Meaning |
|
| Preferred preview port (walks upward if taken). |
|
| Where |
| – | Set to skip auto-registration on |
Development
npm run build # compile TypeScript → dist/
npm run dev # tsc --watch
npm run typecheck # tsc --noEmit
npm test # node:test suite (via tsx)
npm run serve # run just the preview UI (no MCP stdio channel)Stack: TypeScript + @modelcontextprotocol/sdk (stdio) for the MCP server, Express +
Server-Sent Events for the preview. Animations are self-contained SVGs — no runtime
dependencies in the browser.
src/
├─ index.ts # entry: stdio transport + --web-only mode
├─ config.ts # ports, timeouts, paths
├─ core/ # framework-free domain logic (unit-tested)
│ ├─ svg.ts # validate + patch helpers (pure)
│ ├─ store.ts # in-memory animation store
│ └─ edits.ts # edit-request queue + long-poll
├─ content/ # styles.ts, best-practices.ts (the guidance)
├─ web/server.ts # Express preview server + SSE
└─ mcp/server.ts # MCP tools, resources & prompts
public/ # the preview UI (vanilla HTML/CSS/JS)
test/ # node:test specs for core/
bundle/index.mjs # prebuilt single-file server for the plugin (generated)
.claude-plugin/ # plugin.json + marketplace.jsonThe plugin ships a prebuilt bundle (npm run bundle, via esbuild) so it runs on
node alone with no install step. CI fails if the committed bundle is stale, so run
npm run bundle and commit it whenever src/ changes.
License
MIT
Available Tools
8 toolsapply_editApply an edit to an animationB
Apply a regenerated SVG to the animation referenced by an edit request (from await_edit_request). Updates the animation in place — the preview UI refreshes live. Pass the complete new .
Inputs: svg (required), requestId (required).
apply_patchPatch an animation (fast edit)A
Apply small find/replace edits to an animation's SVG in place — the fast path for tweaks like color, size, position, timing, text, or easing. Prefer this over apply_edit: it avoids resending the whole document. Each find must match the current SVG exactly (verbatim substring). If a find isn't found, the patch is rejected wholesale (nothing changes) — fix the find or fall back to apply_edit. The preview refreshes live.
Inputs: edits (required), requestId (required).
await_edit_requestWait for an edit request from the preview UIA
Long-poll for the next change the user typed into the preview UI's chat box. This is how live edits work: call it, and it blocks until a request arrives (or ~25s passes). When it returns an edit, apply the change FAST: for small tweaks (color, size, position, timing, text, easing) call apply_patch with minimal find/replace edits — do NOT regenerate the whole SVG. Use apply_edit (full SVG) only for structural changes. Then call await_edit_request again to keep watching. When it returns 'idle', simply call it again. Keep this loop running while the user iterates.
Inputs: no named parameters.
create_animationCreate & preview an animationA
Render a self-contained animated SVG in the local preview UI and open it in the browser. First compose the scene as a layered SVG with an explicit viewBox, then animate it with CSS @keyframes (or SMIL) embedded in the SVG, using natural easing. Call get_best_practices (optionally with a style) first if you need the full guidance. Pass the same style you designed for so it is recorded and shown. The svg argument must be a complete ... document that animates on its own with no external assets or scripts.
Inputs: svg (required), title (required), prompt (required), loop, +3 more.
get_best_practicesGet animation best practicesA
Return the guidelines for composing and animating SVGs. Read this before generating an animation. Pass a style (a preset key like "minimal-modern" or a freeform phrase like "minimalistic but modern") to also get concrete art direction for that look.
Inputs: style.
list_animationsList animationsB
List animations created this session, newest first.
Inputs: no named parameters.
list_stylesList style presetsA
List the built-in animation style presets. You can also pass any freeform style phrase to create_animation/get_best_practices.
Inputs: no named parameters.
open_previewOpen the preview UIA
Ensure the preview web server is running and open it in the browser.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool targets a distinct action: applying full SVGs, patching, polling user edits, creating animations, fetching guidelines, listing animations/styles, and opening preview. No overlap in purpose.
All tool names follow a consistent verb_noun pattern with underscores (e.g., apply_edit, list_animations, open_preview), making them predictable and easy to understand.
8 tools cover the full workflow of creating, editing, listing, and previewing animations without excess. The scope is well-defined and each tool earns its place.
Core CRUD operations are covered except for explicit deletion or retrieval of a single animation. The interactive edit loop is robust, but missing a delete tool is a minor gap.
Related MCP Connectors
Lets AI assistants draw: logos, posters, illustrations and scenes, as editable SVG and PNG.
Create professional SVG artwork, icons and vector logos from a prompt, or vectorize any image.
One sentence to a finished animation: your AI writes motion graphics as code and checks real frames.
Create and edit architecture diagrams from your AI agent; get an SVG and a live editable canvas.
Related MCP Servers
- AlicenseBqualityDmaintenanceAI-powered animation generator that transforms static images into animated SVG components using the Model Context Protocol, allowing users to create animations through natural language prompts.18Apache 2.0
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to create and animate graphics in PinePaper Studio using natural language, supporting text, shapes, behavior-driven animations, procedural backgrounds, and SVG export.1,653 npm5MIT
- AlicenseNot gradedqualityBmaintenanceA design studio where AI draws, charts and animates: agents create fully editable hand-drawn visuals, build charts from data, and their edits become stop-motion GIF and video animations. Free, offline, zero-dependency, MIT.4MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to generate professional SVG artwork, icons, and vector logos from text prompts, and to vectorize raster images into clean, editable SVG files.MIT