Tools & capabilities

Creator MCP lets an AI agent build and edit scenes through JavaScript, inspect the result, and export deliverables. You can use it entirely through prompts; the details below help when configuring agents or understanding a tool result.

Animation capabilities

Area	Available capabilities
Scenes	Multiple compositions; canvas dimensions, frame rate, duration, nested compositions, and markers
Shapes	Rectangles, ellipses, polygons, stars, Bézier paths, groups, rounded corners, and offset paths
Motion	Keyframes for position, scale, rotation, opacity, paths, and other properties; easing, timing, and motion helpers
Easing	Linear by default; ease in, ease out, ease in and out, holds, and custom curves, including overshoot
Time remapping	Freeze, reverse, slow down, or speed-ramp a nested composition; exports to Lottie
Audio	MP3, WAV, Ogg, FLAC, AAC, and M4A sounds; start time, trimming, offset, speed, and volume fades
Generated media	Images (PNG), SVG icons drawn from a prompt or traced from an image, music, and speech, saved to the media library
Appearance	Solid and gradient fills, strokes, blend modes, blur, shadows, fill, tint, and tritone effects
Text	Editable text, custom TrueType and OpenType fonts, styled runs, text boxes, text on a path, per-character animators
Reveals	Trim paths, masks, inverted masks, and track mattes
Imports	SVG, Lottie JSON, dotLottie (`.lottie`) with its images, sounds, slots, and themes, and Rive `.riv`; PNG images
Inspection	Named elements, scene descriptions, composition summaries, bounds, import warnings, and runtime warnings
Preview	Filmstrips, evenly spaced or at chosen times; PNG stills; a preview card in clients that support MCP Apps
Export	Lottie JSON, dotLottie, MP4, and WebM, with sound; animated GIF, AVIF, and WebP; PNG stills

Lottie compatibility

Say early if you need Lottie; the agent builds within what Lottie can play and tells you when something works only in video.

Text

Text is set in a bundled font. For a brand font or a non-Latin script, supply a TrueType (.ttf), OpenType (.otf), or collection (.ttc) file. The agent imports the font into the document's media library with creator_import_media. Loaded fonts are saved with the document.

Text renders in video, and Lottie export writes a text layer with its glyph outlines. A text_clipped warning means text runs off the canvas in a previewed frame.

Audio

Supply an MP3, WAV, Ogg, FLAC, AAC, or M4A file the agent can read. The agent imports it with creator_import_media. A sound starts at the time you choose and can run until the composition ends. The agent can trim it, skip into it, change its speed, and set or animate its volume in decibels for fades.

Format	Sound
MP4	Every sound mixed into a 48 kHz stereo AAC soundtrack
WebM	Every sound mixed into a 48 kHz stereo Opus soundtrack
Lottie JSON	Sounds embedded in the file, with their volume levels
dotLottie	Sounds stored as files in the archive; a sound type with no file extension fails
GIF, AVIF, WebP, filmstrips, stills	No sound

A dotLottie import keeps the sounds packaged in the archive.

MCP tools

Clients and agents call the exact tool identifiers below.

Tool	Purpose
`creator_exec`	Run JavaScript to build, inspect, edit, render, or export a document.
`creator_docs`	Search documentation, look up method signatures, or read a focused topic.
`creator_document`	List documents or one document's files, list or restore earlier revisions, or reset a document with confirmation.
`creator_download_file`	Retrieve an output's or media file's download link, or an output's encoding status.
`creator_delete_file`	Delete an output or media file; cancel an output's encode if it is still running.
`creator_import_media`	Upload an image, SVG, Lottie, dotLottie, Rive, audio, or font file to the document's media library.
`creator_generate_media`	Generate an image, SVG, music, or speech into the document's media library.
`creator_account`	Show the connected LottieFiles account, its workspace, AI credit balance and any Free plan free uses, and the Drafts project that saves go to.
`creator_save_to_workspace`	Save the animation as dotLottie, or a ready Lottie JSON output, to your workspace as a new file or a new version.
`creator_open_in_creator`	Save the animation to its workspace file and return a link that opens it in Lottie Creator.
`creator_load_from_workspace`	Load a Lottie file from your workspace into the document, replacing it or adding to it.
`creator_preview`	Open the saved animation in the chat in the preview card.

creator_preview appears only in clients that support MCP Apps, such as Claude and ChatGPT.

creator_document list results include the server version and Engine revision (server.version and server.engine). Include both when you report a problem to support.

Documents and edits

Each document has a documentId. If the agent omits it, the server uses default. Use separate IDs for independent animations and the same ID for follow-up edits and file operations.

In normal operation, successful mutations create durable revisions before the tool returns. An uncaught error, including a timeout, rolls back that script's changes; an error the script catches does not undo earlier changes. Documents persist between calls and server restarts; JavaScript variables do not. The agent should inspect the current scene and look up named elements when resuming.

creator_exec returns the script's result, logs, warnings, revision, and any named outputs. Rendered previews are attached as images. Treat warnings as feedback to inspect, even when the operation succeeds. A local_recovery durability result indicates temporary recovery mode; ask the agent to report it instead of treating it as a normal durable save.

Each change the agent saves is a numbered revision. creator_exec takes an optional one-line note that labels the revision. To undo changes, ask the agent to list the document's history and restore an earlier revision: creator_document lists revisions, newest first, and a restore saves that revision's content as a new revision, so nothing is lost. Restoring content the document already has saves nothing. A restore does not change output files, media, or the document's workspace file.

A reset clears the scene to an empty revision, removes the document's output files, and cancels active encodes; it keeps the document's imported media, and a restore can bring the scene back. A reset also unlinks the document from its workspace file, and a restore doesn't relink it, so the next Open in Lottie Creator creates a new file. A reset requires your confirmation through a client that supports MCP 2026-07-28 form elicitation. To remove a media file, ask the agent to delete it with creator_delete_file.

Give agents the right reference

Use the server's own reference for the deployed API. creator_docs supports three ways to find it:

Pass these arguments to creator_docs:

{ "query": "fade a shape" }

Search returns relevant methods, matching guidance, and sections to read next.

Within a script, creator.help(name) looks up a method and creator.methods("grouped") lists methods by area. creator.describeComps() summarizes compositions; creator.describe() inspects the focused scene.

Suggested agent instructions

Use Creator MCP for animation work.
Before using unfamiliar methods, look them up with creator_docs.
Use a named document for each independent animation.
Inspect the existing scene before editing it; preserve unrelated elements.
Name important elements so follow-up edits can target them.
Review filmstrips and warnings before exporting.
Deliver a working download or workspace link, not an MCP resource URI.

Script conventions

The creator API and its helpers are already in scope. Scripts run synchronously without network access, timers, imports, or top-level await. Times are absolute composition seconds, including setCurrentTime; rotations are in radians, and scale uses ratios. Colors use values from 0 to 1, including backgrounds. Entity IDs in tool results are decimal strings.