One sentence to a finished animation: your AI writes motion graphics as code and checks real frames.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Plays a composition on the user's stage from the first frame to the last, through the same preview a person watches (which inspect_composition does not use), and reports whether it got to the end. Buffering is allowed; any error ends the run. Answers within about 20 s: {status:"running", at, total} means call again with the same id to keep waiting on the same run. Then {status:"done", verdict:"ok"|"problems", problems, warnings} or {status:"incomplete", reason} (tab hidden, interrupted, edited). It takes over the stage while it runs: the composition under test becomes the one on screen and the preview plays from frame 0. The composition's source and props are not changed.
The session token that connect returned.
Omit for the active one.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Plays a composition on the user's stage from the first frame to the last, through the same preview a person watches (which inspect_composition does not use), and reports whether it got to the end. Buffering is allowed; any error ends the run. Answers within about 20 s: {status:"running", at, total} means call again with the same id to keep waiting on the same run. Then {status:"done", verdict:"ok"|"problems", problems, warnings} or {status:"incomplete", reason} (tab hidden, interrupted, edited). It takes over the stage while it runs: the composition under test becomes the one on screen and the preview plays from frame 0. The composition's source and props are not changed.
| Argument | Type | Description |
|---|---|---|
| id | string | Omit for the active one. |
| token* | string | The session token that connect returned. |
{
"type": "object",
"required": [
"token"
],
"properties": {
"id": {
"type": "string",
"description": "Omit for the active one."
},
"token": {
"type": "string",
"description": "The session token that connect returned."
}
},
"additionalProperties": false
}Closes a composition and removes it from the user's tabs; its source is not kept. Meant for drafts made along the way. Needs an explicit id and never falls back to the active composition.
| Argument | Type | Description |
|---|---|---|
| id* | string | The composition to close. Required. |
| token* | string | The session token that connect returned. |
{
"type": "object",
"required": [
"token",
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The composition to close. Required."
},
"token": {
"type": "string",
"description": "The session token that connect returned."
}
},
"additionalProperties": false
}Pairs this agent with a Motion browser tab using the eight-character code the user sees under the Connect MCP button (for example K7M4-P2Q9). Returns a session token that every other tool takes. The code works once; the token is what stays valid.
| Argument | Type | Description |
|---|---|---|
| code* | string | The eight-character pairing code shown on the Motion page. |
{
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"description": "The eight-character pairing code shown on the Motion page."
}
},
"additionalProperties": false
}Creates a new composition from TSX source and opens it as a tab in the user's Motion page. `files` maps path to source and must include the entry (default composition.tsx). The API is specific to Motion and documented in read_skill {topic:'motion'}; design guidance is in {topic:'motion-craft'}. A partsBoard prop (default false) can lay out UI-like parts for checking before scenes are built.
| Argument | Type | Description |
|---|---|---|
| fps* | number | |
| name* | string | |
| entry | string | Defaults to composition.tsx. |
| files* | object | |
| token* | string | The session token that connect returned. |
| width* | number | |
| height* | number | |
| schema | object | Props schema; drives the editable controls. |
| durationInFrames* | number |
Starts a Motion session when the user has no pairing code. Compositions can be created and edited at once; the returned link opens the session in a browser. Rendering frames, playback and anything touching media need that tab open (see wait_for_tab). The scene is kept for 24 hours after the last change.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Deletes files from the user's media library by id. A copied file is gone from the browser; a linked file stays on the user's disk and only leaves the library. Compositions that use a deleted file report it as missing footage.
| Argument | Type | Description |
|---|---|---|
| ids* | array | The files to delete. |
| token* | string | The session token that connect returned. |
{
"type": "object",
"required": [
"token",
"ids"
],
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "The files to delete."
},
"token": {
"type": "string",
"description": "The session token that connect returned."
}
},
"additionalProperties": false
}Returns one composition in full: manifest, every source file, and current prop values — the state an update_composition edit applies to.
| Argument | Type | Description |
|---|---|---|
| id | string | Omit for the active one. |
| token* | string | The session token that connect returned. |
{
"type": "object",
"required": [
"token"
],
"properties": {
"id": {
"type": "string",
"description": "Omit for the active one."
},
"token": {
"type": "string",
"description": "The session token that connect returned."
}
},
"additionalProperties": false
}Returns the raw bytes of one file, base64, capped at about 600 KB. For larger files and for video, inspect_media describes the content at a fraction of the size.
| Argument | Type | Description |
|---|---|---|
| id* | string | |
| token* | string | The session token that connect returned. |
{
"type": "object",
"required": [
"token",
"id"
],
"properties": {
"id": {
"type": "string"
},
"token": {
"type": "string",
"description": "The session token that connect returned."
}
},
"additionalProperties": false
}Lists what went wrong in the user's tab: frames that failed to render (with the frame and the engine's message), a preview that stopped moving and why, compositions that would not load, clips that will not decode, missing footage, failed exports, a page the browser killed — plus warnings. Works while the tab is hidden or closed. `current` belongs to the composition as it is now; `earlier` counts problems an edit has since left behind. Other tool results may also carry a `problems` list of what is new. An empty list covers only what the tab has played; check_playback does a full pass.
| Argument | Type | Description |
|---|---|---|
| id | string | Only this composition. Omit for all of them. |
| token* | string | The session token that connect returned. |
| includeWarnings | boolean | Include warnings (default true). |
{
"type": "object",
"required": [
"token"
],
"properties": {
"id": {
"type": "string",
"description": "Only this composition. Omit for all of them."
},
"token": {
"type": "string",
"description": "The session token that connect returned."
},
"includeWarnings": {
"type": "boolean",
"description": "Include warnings (default true)."
}
},
"additionalProperties": false
}Renders frames of a composition in the user's tab and returns them as one labelled contact sheet; nothing is saved or changed. atFrames takes up to 12 frames; omitted, the sheet is an even spread plus the joins between scenes (labelled "end of a scene", "start of a scene", "mid transition"). One frame comes back at 1560 px, two at 960, for checking detail. `props` are merged over the composition's for this render only, e.g. {partsBoard:true}. Each frame reports its content share (how much is not background); one far below its neighbours is usually a gap between scenes.
| Argument | Type | Description |
|---|---|---|
| id | string | Omit for the active one. |
| props | object | Merged over the composition's props for this render only, e.g. {partsBoard:true}. |
| token* | string | The session token that connect returned. |
| atFrames | array |
{
"type": "object",
"required": [
"token"
],
"properties": {
"id": {
"type": "string",
"description": "Omit for the active one."
},
"props": {
"type": "object",
"description": "Merged over the composition's props for this render only, e.g. {partsBoard:true}."
},
"token": {
"type": "string",
"description": "The session token that connect returned."
},
"atFrames": {
"type": "array",
"items": {
"type": "number"
}
}
},
"additionalProperties": false
}Looks inside an image or video and returns one contact sheet: each requested moment as a labelled cell in a single image. atSec takes up to 12 timestamps in seconds; omitted, the moments are spread evenly over the clip.
| Argument | Type | Description |
|---|---|---|
| id* | string | |
| atSec | array | Up to 12 timestamps. |
| token* | string | The session token that connect returned. |
{
"type": "object",
"required": [
"token",
"id"
],
"properties": {
"id": {
"type": "string"
},
"atSec": {
"type": "array",
"items": {
"type": "number"
},
"description": "Up to 12 timestamps."
},
"token": {
"type": "string",
"description": "The session token that connect returned."
}
},
"additionalProperties": false
}Lists the compositions open in the session, and which one is on screen.
| Argument | Type | Description |
|---|---|---|
| token* | string | The session token that connect returned. |
{
"type": "object",
"required": [
"token"
],
"properties": {
"token": {
"type": "string",
"description": "The session token that connect returned."
}
},
"additionalProperties": false
}Lists the user's media library: folders, and files with id, name, kind, size and folder. `storage` says whether a file is 'linked' (still on their disk) or 'copied' (held by the browser); a linked file can need the user to re-grant access after a reload.
| Argument | Type | Description |
|---|---|---|
| path | string | Folder to list. Omit for all. |
| token* | string | The session token that connect returned. |
{
"type": "object",
"required": [
"token"
],
"properties": {
"path": {
"type": "string",
"description": "Folder to list. Omit for all."
},
"token": {
"type": "string",
"description": "The session token that connect returned."
}
},
"additionalProperties": false
}Moves files and manages folders. action: 'move' (ids + toFolder), 'createFolder' (name + optional parent), 'deleteFolder' (folder; the files inside move up one level, nothing is deleted). Deleting files is delete_media.
| Argument | Type | Description |
|---|---|---|
| ids | array | |
| name | string | |
| token* | string | The session token that connect returned. |
| action* | string | |
| folder | string | |
| parent | string | |
| toFolder | string |
{
"type": "object",
"required": [
"token",
"action"
],
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string"
}
},
"name": {
"type": "string"
},
"token": {
"type": "string",
"description": "The session token that connect returned."
},
"action": {
"enum": [
"move",
"createFolder",
"deleteFolder"
],
"type": "string"
},
"folder": {
"type": "string"
},
"parent": {
"type": "string"
},
"toFolder": {
"type": "string"
}
},
"additionalProperties": false
}Adds a file to the library as a new item; nothing existing is replaced. With `url`, the user's browser fetches it, so only public https hosts that send CORS headers work. `data` takes base64 bytes and is limited to about 700 KB, for small generated assets. Larger files on the caller's disk can be sent as an HTTP POST of the raw bytes to /media/upload?token=TOKEN&name=NAME on this server's origin (up to 10 MB).
| Argument | Type | Description |
|---|---|---|
| url | string | http(s) URL for the browser to fetch. |
| data | string | Base64 bytes, for small assets. |
| name* | string | Filename, including extension. |
| token* | string | The session token that connect returned. |
| folder | string | Folder to put it in. Omit for the root. |
{
"type": "object",
"required": [
"token",
"name"
],
"properties": {
"url": {
"type": "string",
"description": "http(s) URL for the browser to fetch."
},
"data": {
"type": "string",
"description": "Base64 bytes, for small assets."
},
"name": {
"type": "string",
"description": "Filename, including extension."
},
"token": {
"type": "string",
"description": "The session token that connect returned."
},
"folder": {
"type": "string",
"description": "Folder to put it in. Omit for the root."
}
},
"additionalProperties": false
}Returns one of Motion's authoring guides as text. 'motion' is the API contract: what compiles, resolves and renders — compositions written without it usually fail. 'motion-craft' covers timing and design so results do not look generated; 'motion-text' typography; 'motion-effects' named looks; 'motion-transitions' sequencing scenes; 'motion-examples' two contrasting complete pieces; 'motion-workflow' working while the user watches and checking frames; 'motion-review' a structured critique for pieces with an audience and a purpose.
| Argument | Type | Description |
|---|---|---|
| topic* | string |
{
"type": "object",
"required": [
"topic"
],
"properties": {
"topic": {
"enum": [
"motion",
"motion-craft",
"motion-text",
"motion-effects",
"motion-transitions",
"motion-examples",
"motion-workflow",
"motion-review"
],
"type": "string"
}
},
"additionalProperties": false
}Sets prop values on a composition, the same values the user's controls change. Merged by key; keys sent replace their current values.
| Argument | Type | Description |
|---|---|---|
| id | string | |
| props* | object | |
| token* | string | The session token that connect returned. |
{
"type": "object",
"required": [
"token",
"props"
],
"properties": {
"id": {
"type": "string"
},
"props": {
"type": "object"
},
"token": {
"type": "string",
"description": "The session token that connect returned."
}
},
"additionalProperties": false
}Shows one short status sentence in the user's Motion tab while work is in progress, so they can tell progress from a stall. kind 'done' marks the job finished and 'problem' marks a blocker; step and of draw a progress bar. Changes nothing else. How it fits the workflow: read_skill {topic:'motion-workflow'}.
| Argument | Type | Description |
|---|---|---|
| of | number | How many there are in total, e.g. 5 — draws a progress bar. Send both or neither, and only when you genuinely know the total; a bar that goes backwards is worse than none. |
| kind | string | Omit while working. 'done' ends the job, 'problem' flags a blocker. |
| step | number | Which one you are on, e.g. 2. |
| text* | string | One friendly sentence, first person. Not a log line. |
| token* | string | The session token that connect returned. |
{
"type": "object",
"required": [
"token",
"text"
],
"properties": {
"of": {
"type": "number",
"description": "How many there are in total, e.g. 5 — draws a progress bar. Send both or neither, and only when you genuinely know the total; a bar that goes backwards is worse than none."
},
"kind": {
"enum": [
"working",
"done",
"problem"
],
"type": "string",
"description": "Omit while working. 'done' ends the job, 'problem' flags a blocker."
},
"step": {
"type": "number",
"description": "Which one you are on, e.g. 2."
},
"text": {
"type": "string",
"description": "One friendly sentence, first person. Not a log line."
},
"token": {
"type": "string",
"description": "The session token that connect returned."
}
},
"additionalProperties": false
}Edits an existing composition. Each file sent replaces the file at that path; files not sent are kept. Changing the schema keeps prop values that still have a matching field.
| Argument | Type | Description |
|---|---|---|
| id | string | Omit for the active one. |
| fps | number | |
| name | string | |
| files | object | |
| token* | string | The session token that connect returned. |
| width | number | |
| height | number | |
| schema | object | |
| durationInFrames | number |
{
"type": "object",
"required": [
"token"
],
"properties": {
"id": {
"type": "string",
"description": "Omit for the active one."
},
"fps": {
"type": "number"
},
"name": {
"type": "string"
},
"files": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"token": {
"type": "string",
"description": "The session token that connect returned."
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"schema": {
"type": "object"
},
"durationInFrames": {
"type": "number"
}
},
"additionalProperties": false
}Waits until the user's Motion tab connects to the session, for example after they open the link from create_session. Returns as soon as it connects, or after about 25 seconds with tabConnected false. Tools that render or touch media need the tab.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}{
"type": "object",
"required": [
"token",
"name",
"width",
"height",
"fps",
"durationInFrames",
"files"
],
"properties": {
"fps": {
"type": "number"
},
"name": {
"type": "string"
},
"entry": {
"type": "string",
"description": "Defaults to composition.tsx."
},
"files": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"token": {
"type": "string",
"description": "The session token that connect returned."
},
"width": {
"type": "number"
},
"height": {
"type": "number"
},
"schema": {
"type": "object",
"description": "Props schema; drives the editable controls."
},
"durationInFrames": {
"type": "number"
}
},
"additionalProperties": false
}