Describe it
Tell your agent what to animate — a loader, a logo reveal, an icon morph, a bouncing ball. No timeline scrubbing, no keyframe wrangling.
Connect any MCP-capable coding agent to the IconKing engine. Describe the motion in plain English — your agent creates the shapes, keyframes the timing, checks each frame, and exports a production Lottie.
prompt: “a box rolling across the floor, 3 rolls in 3s” → 3 layers, 26 keyframes
How it works
The editor is command-driven: every edit is a JSON command on a headless engine. The MCP server hands that engine to your agent — it edits through the exact same code paths as the editor UI.
Tell your agent what to animate — a loader, a logo reveal, an icon morph, a bouncing ball. No timeline scrubbing, no keyframe wrangling.
It creates layers and shapes, keyframes properties with real easing, then renders frames to actually see them and corrects itself.
Export to Lottie, dotLottie, TGS, animated SVG or video — and open it right here in the IconKing editor for final polish.
Capabilities
25 tools across inspection, authoring, animation and export — down to a single gradient stop, a trim-path arc, or a per-keyframe spring.
render_frame and preview_in_browser — render any moment to SVG or open a live player. The agent verifies its own work.
get_document, inspect_layer, get_colors — layer tree, keyframes, easing, paints, effects and palette.
create_layer (shape / null / text / solid) and add_shape rects, ellipses and stars with fill & stroke.
set_layer_transform, set_property, set_shape_property, plus parent, reorder and duplicate.
animate batches keyframes in one step, with linear / bezier / step / spring easing per keyframe.
add_effect drop-shadow, gaussian-blur and more, with set_effect_param for fine control.
apply_commands — raw access to the full command catalogue: groups, bezier paths, gradients, trim, masks, text.
export_animation to 8 formats plus save_project lossless IKF. Opens straight in the editor.
Setup
One-time: build the engine, then point your agent at the launcher.
pnpm install && pnpm --filter @iconking/engine-wasm build:wasm. Find your repo path with pwd and use it for <REPO>.Launch Claude Code from the repo folder and approve the iconking server (verify with /mcp). To register it globally from anywhere:
claude mcp add iconking <REPO>/apps/mcp/bin/iconking-mcpA .mcp.json at the repo root already registers it for in-repo sessions.
Try it
Once connected, just talk to your agent — it picks the tools itself. A few prompts to start:
“Make a 1.5s looping spinner: three rounded arcs on a rotating rig with a pulsing center dot. Preview it in the browser when done.”
“Create a 2s logo intro: a text layer that fades and scales up with a spring, on a clean white background. Export it as Lottie.”
“Open ./heart.json and add a heartbeat: scale to 120% and back twice over 1s with bezier easing. Render frame 0.5 so I can check it.”
“Animate a checkmark drawing on with a trim-path from 0 to 100% over 0.6s, then a soft drop shadow. Save it as dotLottie.”
Connect your agent, describe a motion, and open the result in the editor.
Built on the Model Context Protocol.