Official MCP RegistryListed
Motion by Frapea
One sentence to a finished animation: your AI writes motion graphics as code and checks real frames.
First seen 11 Oct 2026. Evidence as of 29 Oct 2026.
20
Tools
From an anonymous probe
1
Source listings
Each with its own history
50
Recorded changes
Since first seen
Tools
| Tool | Description | Behaviour |
|---|---|---|
| check_playback | 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. | Changes data |
| close_composition | 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. | Destructive |
| connect | 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. | Changes data |
| create_composition | 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. | Changes data |
| create_session | 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. | Changes data |
| delete_media | 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. | Destructive |
| get_composition | Returns one composition in full: manifest, every source file, and current prop values — the state an update_composition edit applies to. | Read-only |
| get_media | 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. | Read-only |
| get_problems | 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. | Read-only |
| inspect_composition | 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. | Read-only |
| inspect_media | 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. | Read-only |
| list_compositions | Lists the compositions open in the session, and which one is on screen. | Read-only |
| list_media | 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. | Read-only |
| organize_media | 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. | Changes data |
| put_media | 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). | Changes data |
| read_skill | 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. | Read-only |
| set_props | Sets prop values on a composition, the same values the user's controls change. Merged by key; keys sent replace their current values. | Destructive |
| tell_user | 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'}. | Changes data |
| update_composition | 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. | Destructive |
| wait_for_tab | 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. | Read-only |
Change history
- wait_for_tab: title changed
- wait_for_tab: description changed (+"Waits until the user's Motion tab connects" +"session, for example after they" +"link from create_session. Returns")
- wait_for_tab: annotations changed
- update_composition: title changed
- update_composition: description changed (+"Each file sent replaces the file at that path; files not sent are kept." +"matching field." -"`files` is MERGED by path, so send only what changed.")
- update_composition: annotations changed
- tell_user: title changed
- tell_user: description changed (+"Shows one short status sentence in" +"user's" +"work is in progress, so they can tell progress")
- tell_user: annotations changed
- set_props: title changed
- set_props: description changed (+"composition," +"Merged by key; keys sent replace their current values." -"composition —")
- set_props: annotations changed
- read_skill: title changed
- read_skill: description changed (+"Returns one of" +"guides as text. 'motion'" +"resolves and renders —")
- read_skill: annotations changed
- put_media: title changed
- put_media: description changed (+"as" +"new item; nothing existing is replaced. With `url`," +"user's browser")
- put_media: annotations changed
- organize_media: title changed
- organize_media: input schema changed
- organize_media: description changed (+"Moves files and manages folders." +"(folder;" +"deleted). Deleting files is delete_media.")
- organize_media: annotations changed
- list_media: title changed
- list_media: description changed (+"Lists the" +"browser);" -"The")
- list_media: annotations changed
- list_compositions: title changed
- list_compositions: description changed (+"Lists the" +"session," -"The")
- list_compositions: annotations changed
- inspect_media: title changed
- inspect_media: description changed (+"inside an image or video and returns one" +"sheet: each" +"takes up")
- inspect_media: annotations changed
- inspect_composition: title changed
- inspect_composition: description changed (+"in the user's tab" +"sheet; nothing is saved or changed." +"takes up")
- inspect_composition: annotations changed
- get_problems: title changed
- get_problems: description changed (+"Lists what went wrong" +"message)," +"why,")
- get_problems: annotations changed
- get_media: title changed
- get_media: description changed (+"Returns the" +"base64, capped" +"KB. For larger files")
- get_media: annotations changed
- get_composition: title changed
- get_composition: description changed (+"Returns one" +"values — the state an" +"applies to.")
- get_composition: annotations changed
- delete_media: tool added
- create_session: title changed
- create_session: description changed (+"when" +"has" +"code. Compositions")
- create_session: annotations changed
- create_composition: title changed
- create_composition: description changed (+"Creates" +"from TSX source" +"user's Motion page.")
- create_composition: annotations changed
| Source | Listing | First seen | Last seen | Versions |
|---|---|---|---|---|
| Official MCP Registry | com.frapea/motion | 11 Oct 2026 | 29 Oct 2026 | 1 |