Motion by Frapea

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

One sentence to a finished animation: your AI writes motion graphics as code and checks real frames.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Motion by Frapea": {
      "url": "https://motion.frapea.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (20)

• close_composition destructive

  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.

  Parameters:

  • token (required) — string — The session token that connect returned.
  • id (required) — string — The composition to close. Required.

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• 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.

  Parameters:

  • code (required) — string — The eight-character pairing code shown on the Motion page.

  Hints: read-only no · destructive no · idempotent no · open-world no

• 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.

  Hints: read-only no · destructive no · idempotent no · open-world no

• wait_for_tab read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• 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'}.

  Parameters:

  • token (required) — string — The session token that connect returned.
  • text (required) — string — One friendly sentence, first person. Not a log line.
  • 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.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• read_skill read-only

  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.

  Parameters:

  • topic (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_media read-only

  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.

  Parameters:

  • token (required) — string — The session token that connect returned.
  • path — string — Folder to list. Omit for all.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• 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).

  Parameters:

  • token (required) — string — The session token that connect returned.
  • name (required) — string — Filename, including extension.
  • url — string — http(s) URL for the browser to fetch.
  • data — string — Base64 bytes, for small assets.
  • folder — string — Folder to put it in. Omit for the root.

  Hints: read-only no · destructive no · idempotent no · open-world yes

• get_media read-only

  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.

  Parameters:

  • token (required) — string — The session token that connect returned.
  • id (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• inspect_media read-only

  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.

  Parameters:

  • token (required) — string — The session token that connect returned.
  • id (required) — string
  • atSec — array — Up to 12 timestamps.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• 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.

  Parameters:

  • token (required) — string — The session token that connect returned.
  • action (required) — string
  • ids — array
  • name — string
  • folder — string
  • parent — string
  • toFolder — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• delete_media destructive

  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.

  Parameters:

  • token (required) — string — The session token that connect returned.
  • ids (required) — array — The files to delete.

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• list_compositions read-only

  Lists the compositions open in the session, and which one is on screen.

  Parameters:

  • token (required) — string — The session token that connect returned.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_composition read-only

  Returns one composition in full: manifest, every source file, and current prop values — the state an update_composition edit applies to.

  Parameters:

  • token (required) — string — The session token that connect returned.
  • id — string — Omit for the active one.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• 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.

  Parameters:

  • token (required) — string — The session token that connect returned.
  • name (required) — string
  • width (required) — number
  • height (required) — number
  • fps (required) — number
  • durationInFrames (required) — number
  • files (required) — object
  • entry — string — Defaults to composition.tsx.
  • schema — object — Props schema; drives the editable controls.

  Hints: read-only no · destructive no · idempotent no · open-world no

• update_composition destructive

  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.

  Parameters:

  • token (required) — string — The session token that connect returned.
  • id — string — Omit for the active one.
  • fps — number
  • name — string
  • files — object
  • width — number
  • height — number
  • schema — object
  • durationInFrames — number

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• set_props destructive

  Sets prop values on a composition, the same values the user's controls change. Merged by key; keys sent replace their current values.

  Parameters:

  • token (required) — string — The session token that connect returned.
  • props (required) — object
  • id — string

  Hints: read-only no · destructive yes · idempotent yes · open-world no

• inspect_composition read-only

  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.

  Parameters:

  • token (required) — string — The session token that connect returned.
  • id — string — Omit for the active one.
  • props — object — Merged over the composition's props for this render only, e.g. {partsBoard:true}.
  • atFrames — array

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• 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.

  Parameters:

  • token (required) — string — The session token that connect returned.
  • id — string — Omit for the active one.

  Hints: read-only no · destructive no · idempotent no · open-world no

• get_problems read-only

  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.

  Parameters:

  • token (required) — string — The session token that connect returned.
  • id — string — Only this composition. Omit for all of them.
  • includeWarnings — boolean — Include warnings (default true).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.