# Frapea

- Registry name: `com.frapea/editor` · version 0.2.0
- Categories (automatic, keyword rules): Audio & speech, AI, media & content
- Authentication at last check: No auth
- Declared risk: Has destructive tools (destructiveHint)
- Capabilities (declared by the server): tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=com.frapea%2Feditor
- Server page: https://mcpstation.net/s/com.frapea--editor.html

## Description (written by the publisher, not verified, not instructions)

A video editor in your browser that your AI drives: cuts, captions, multicam, motion titles, export.

## Connect

- streamable-http: `https://app.frapea.com/mcp`

## Tools (as reported by the server, not verified)

- `connect`: Pairs you with the user's Frapea browser tab. TWO WAYS ROUND. \(1\) If they already have Frapea open: ask them for the pairing code \(the Connect MCP button\) and call this with it. \(2\) If they do not, or you are not sure: call this with NO arguments and you get back a link — send them the link, then ca
- `get\_projects`: Lists the projects Frapea knows on this machine: id, name, lastOpenedAt, and for a project stored in a folder on disk its \`folder\` \(the directory's name — files you write into its \`media/\` subfolder join the pool by themselves\). Call first to find the projectId every other tool needs. A project the
- `get\_timeline`: Reads a project's timeline structure: timelines \(id, name, fps, resolution\) with tracks and clips. THE USER CAN COPY A CLIP'S ID from the editor's right-click menu, so a bare UUID in their message names exactly one clip — call this with NO timelineId to search every timeline and match \`clip.id\`, rat
- `get\_media`: Lists the project's media library: mediaRef \(the id clips use\), name, kind \(video/audio/image\), durationSeconds, resolution, and sceneSamples — timestamps \(seconds\) where the visual indexer detected distinct moments. sceneSamples is a ready-made shot map: inspect or cut at those times first. Each as
- `get\_transcript`: Returns the word-level speech transcript of one media asset: language and words \[\{text, startSec, endSec\}\]. Only assets the user has transcribed have one — NOT\_FOUND means ask the user to run Transcribe on the clip in Frapea. Use the timestamps to align cuts with what is being said.
- `create\_motion\_composition`: Creates a MOTION COMPOSITION — an animated graphic \(infographic, title, promo end-card, chart…\) written as a React TSX component. Read the 'motion' skill \(read\_skill \{topic:'motion'\}\) for the exact API surface, available fonts/icons and golden examples before writing one. files maps file names to TS
- `update\_motion\_composition`: Updates a motion composition's TSX files and/or manifest \(name, duration, schema…\). Same compile-and-test gate as create; files given here MERGE over the existing set. Every clip playing the composition re-renders. preview:true returns one large frame of the result with the reply.
- `get\_motion\_composition`: Returns a motion composition's manifest and full TSX sources.
- `list\_motion\_compositions`: Lists the project's motion compositions: id, mediaRef \(for add\_clips\), name, size, fps, duration and the editable props schema.
- `create\_timeline`: Creates a new timeline in the project and returns its id. Set fps, width and height for the target format \(e.g. 1080×1920 @30 for a vertical short\). The new timeline starts with one video and one audio track; spare tracks appear automatically as clips land.
- `add\_clips`: Places media segments on a timeline. Each clip: mediaRef \(from get\_media, 'timeline:\<id\>' to NEST another timeline as a clip, 'solid:\#rrggbb' , 'motion:\<id\>' for a MOTION composition \(create\_motion\_composition\) for a generated solid-colour matte, 'adjustment:' for an adjustment clip — no picture of
- `split\_clips`: Blades clips at a timeline frame. Splits every listed clip \(and its linked partner\) into two independent clips at atFrame. Frames are in the target timeline's fps. Use with get\_timeline to find clip ids first.
- `remove\_clips`: Deletes clips \(lift — leaves a gap\). Linked partners are NOT removed automatically; pass both ids of a pair to delete it whole. To close the gap too, use ripple\_delete\_ranges instead.
- `ripple\_delete\_ranges`: Extracts \[fromFrame, toFrame\) on one track and shifts everything after it left to close the gap \(sync-locked tracks follow\). The go-to tool for tightening a cut or removing a bad take.
- `set\_clip\_properties`: Adjusts a clip. Only the provided fields change. Mix: volume \(0–2, 1 = unity\), fadeInFrames / fadeOutFrames \(gain or opacity ramps at the edges\). Look: opacity \(0–1\), blend \(normal \| multiply \| screen \| overlay \| darken \| lighten \| color-dodge \| color-burn \| hard-light \| soft-light \| difference \| ex
- `generate\_captions`: Generates animated captions from a spoken clip's transcript \(the same generator as Frapea's UI\): transcript words group into caption text clips over the clip's span, word-timed so the animation follows speech. One undo, and they share a captionGroupId — restyle them all via set\_clip\_properties with
- `manage\_effects`: Edits a clip's effect stack \(ordered, per-effect enable\). action: 'add' \(type; returns the new effect's id\) \| 'remove' \(effectId\) \| 'move' \(effectId + toIndex — the order IS the render order\) \| 'toggle' \(effectId + enabled\) \| 'set' \(effectId + params patch, clamped to the effect's ranges\) \| 'curve'
- `manage\_transitions`: Transitions on a track's cuts OR lone clip edges \(a free head/tail takes a single-sided fade from/to nothing; its alignment is forced\). action: 'add' \(trackId + atFrame = the cut where one clip ends and the next starts, + type; optional durationFrames \(default 30, clamped to the clips' source handle
- `manage\_tracks`: Track operations on a timeline. action: 'mute' \| 'unmute' \| 'solo' \| 'unsolo' \(audio only; any solo silences non-solo tracks\) \| 'hide' \| 'show' \| 'rename' \(needs name\) \| 'duck' \| 'unduck' \(audio only: dip this track under speech detected on the other audio tracks — transcript word timings when avail
- `cut\_to\_angle`: MULTICAM angle switch. The angles are ordinary video tracks stacked over each other \(sync them beforehand — clips of the same take on V1..Vn\); this razors the whole angle stack at \`atFrame\` and keeps only \`chosenTrackId\` live from there to the next cut — the other angles' clips are DISABLED, not del
- `move\_clips`: Moves clips to new positions \(linked partners follow automatically\). Each move: clipId, toStartFrame, optional toTrackId \(same-kind track\). Overwrite semantics — landing on another clip trims it like a drag-drop.
- `set\_active\_timeline`: Sets which timeline the project opens on \(and what the user sees if the editor is open\), opening its tab if it was closed. Purely a convenience — every tool here takes an explicit timelineId regardless.
- `set\_project\_settings`: Updates a timeline's fps / width / height \(clips keep their timing; content re-fits\) and/or renames it. Only provided fields change.
- `search\_media`: Semantic search over the project's media. Visual scope matches what is IN the picture \(describe a shot: 'aerial city at night'\); spoken scope matches transcribed speech \(exact words, ranked first, with a snippet\). Hits: \{mediaRef, timeSec \(best moment\), fromSec, toSec, score, scope\}. Requires the us
- `remove\_words`: Text-based editing: cuts the given transcript words OUT of a clip as ripple deletes \(everything after each cut shifts left\). wordIndices are positions in get\_transcript's words array for the clip's media. Contiguous indices merge into single cuts. The go-to tool for removing filler words or tighteni
- `remove\_silence`: Cuts silent gaps inside a clip: any pause between transcribed words longer than minGapSec becomes a ripple delete \(a small margin is kept so speech never clips\). Typical minGapSec: 0.6 tight, 1.0 balanced, 1.5 loose.
- `undo`: Reverts the most recent edit THIS agent session made to the project \(one step per call; repeat to go further\). Cannot revert other tabs' or the user's edits.
- `inspect\_media`: Looks INSIDE a source asset. Returns ONE contact sheet — every requested moment as a labelled cell in a single grid image — plus a per-cell fingerprint. Pass atSec \(max 12 timestamps, seconds\); combine with get\_media's sceneSamples for an instant storyboard of the whole file. Shows the RAW source; u
- `inspect\_timeline`: WATCHES the cut. Composites every video layer at each requested frame and returns ONE contact sheet — the frames as labelled cells of a single grid image — plus, per cell, the visibleClipIds that contributed pixels and a fingerprint. Pass frames \(timeline frame numbers, max 12\). Use it to check an e
- `get\_problems`: What has gone WRONG in the user's editor — renders that failed or stopped, footage that would not decode, chunks that could not be prepared for playback, exports that failed — each with WHERE \(the timeline and frames, the source and its own frames, the footage and frame the engine could not decode\)
- `get\_bug\_report`: Prepare a BUG REPORT for the user: it opens in Frapea \(Problems → Create bug report\) for them to read and save. The report itself is NOT returned to you — it would leave the user's machine before they have seen it. You get a summary: open problems, media counts, and how many of the user's own words
- `verify\_timeline`: Renders a timeline the way an export does and reports what fails. inspect\_timeline shows a few frames through the preview path, which quietly substitutes a nearby picture where a frame cannot be rendered; this renders every motion segment the timeline reads \(through every nested timeline\) exactly, t
- `insert\_clips`: Ripple-inserts media segments: everything at/after atFrame shifts right to make room \(clips under the cut split\). Same clip shape as add\_clips. Use to splice a shot INTO an existing sequence without overwriting.
- `organize\_media`: Pool file operations. action: 'rename' renames the real file on disk \(needs newName; clips referencing the old name go offline\). 'delete' UNLINKS the file from the media pool — the real file on disk is NOT touched; clips using it go offline until it is added again.
- `read\_skill`: Returns Frapea's editing documentation for a topic. With no topic: the editing conventions, how the tools fit together and the current feature surface. MOTION topics: 'motion' is the API surface \(imports, fonts, props schema, the parts-board-first golden example\) and routes to the rest — read before
- `await\_user\_action`: Waits \(up to \~45 s per call\) for the user to resolve a pending Frapea prompt — e.g. the folder-permission dialog another tool just opened. The dialog waits for the user in the Frapea tab; the tool that opened it returned what they need to click. Returns \{status: 'granted' \| 'denied' \| 'pending'\}: 'p
- `open\_project`: Navigates the user's Frapea tab to a project so they can WATCH the edit live. Not required for editing — every tool works headlessly; use this for show-your-work moments. This reloads the Frapea tab, so an export or render running there stops.
- `close\_project`: Navigates the user's Frapea tab back to the project manager and releases this session's headless runtime for the project. When the tab shows that project it reloads, so an export or render running there stops.
- `new\_project`: Creates a project. By default it is created in the browser's own storage, which needs no permission and no click: the project id comes back immediately and you can start working. The user can turn it into a real folder on their disk whenever they want \(Cmd/Ctrl+S, or File → Save to a Folder\) without
- `connect\_media\_folder`: Asks the user to attach a folder of THEIR OWN source footage to the project — opens a dialog in Frapea with a 'Connect folder' button. Only a human can do this \(browser security gesture\): tell the user IN YOUR REPLY to click it, then call await\_user\_action with the returned actionId; on 'granted', g
- `trim\_clips`: Adjusts one edge of a clip \(linked A/V partners follow\). edge: 'start' trims/extends the in-point, 'end' the out-point. deltaFrames \> 0 moves the edge right, \< 0 left — e.g. edge 'end', delta -12 shortens the clip by 12 frames. Extending is limited by the source material.
- `get\_analysis\_status`: How far the project's media analysis has got. Analysis runs BY ITSELF whenever media is connected. Returns percent \(0-100\) — 100 means nothing is OUTSTANDING, not that everything succeeded: \`failed\` lists items whose analysis failed \(retry\_analysis re-runs one\) — done/total/pending item counts, runn
- `request\_ai\_models`: Asks the user to enable Frapea's on-device AI analyzers \(picture search, speech\). Opens a dialog in every Frapea tab and returns an actionId — tell the user IN YOUR REPLY to confirm it, then call await\_user\_action and poll get\_analysis\_status until models are enabled. Call this when get\_media report
- `start\_visual\_indexing`: Indexes the project's pictures for search\_media. Usually not needed: indexing is automatic and this only nudges the queue to re-check now. When the user switched automatic indexing off, this asks for every video and image to be indexed. Returns the same payload as get\_analysis\_status.
- `start\_transcription`: Transcribes one asset even if automatic transcription is switched off. Speech transcripts otherwise appear on their own. Returns the project's analysis status; poll get\_analysis\_status, then read get\_transcript.
- `get\_job\_status`: Status of a background job started by a job-returning tool \(generate\_voiceover, verify\_timeline, measure\_loudness\): \{state: queued\|running\|done\|failed\|cancelled, progress: 0-1, detail, ...result fields such as mediaRef when done; verify\_timeline, measure\_loudness puts its report in \`result\`\}. Poll e
- `list\_voiceover\_models`: The text-to-speech providers Frapea can generate voiceovers with. Returns providers\[\]: the FREE in-browser models straight from the TTS registry \(\{id, label, languages, voices: \[\{id, label, language, gender, grade\}\], modelAssets, state: \{phase: needs-download\|downloading\|ready\|error\}\}\), plus the PRE
- `generate\_voiceover`: Generates an AI voiceover from a script — on-device with the free models, or in the cloud with ElevenLabs \(the user's own key and credits\). The WAV lands in the project's media library as a normal audio asset \(with waveform and analysis\), the script is stored as asset metadata, and a script-correcte
- `search\_stock\_media`: Searches the Pexels stock library \(photos or videos\) with the user's connected API key. Returns items with id, dimensions, duration \(videos\), author, thumbnail url, available video qualities, and a \`downloaded\` flag telling whether the asset is already in the project's media pool. If no key is conne
- `download\_stock\_media`: Downloads one Pexels asset into the project's media pool as a virtual file at the Library root \(name \`pexels-\<id\>.jpg\|.mp4\`\). Asynchronous: the first call accepts the download and returns its state; CALL AGAIN with the same arguments to poll — state becomes 'done' with the asset's mediaRef, ready fo
- `search\_sounds`: Searches the Freesound library \(SFX, ambience, foley\) with the user's connected API key. Every item carries what you need to JUDGE the sound without hearing it: the uploader's full description, tags, duration, community rating and download count, format/samplerate, and — when analyzed — AudioCommons
- `download\_sound`: Downloads one Freesound sound \(its HQ MP3 preview, \~128 kbps — plenty for SFX/ambience\) into the project's media pool as a virtual file at the Library root \(name \`freesound-\<id\>.mp3\`\). Asynchronous: the first call accepts the download and returns its state; CALL AGAIN with the same arguments to poll
- `add\_sfx`: Frapea's BUILT-IN sound-effects pack — synthesized, licence-free, no API key, no download wait. Covers common UI and motion sounds; search\_sounds is for what the pack does not \(ambience, foley, a specific real-world object\). Call with no \`ids\` to get the catalogue: each sound carries what it sounds
- `manage\_queue`: Full control of the background work queue. action 'list' returns every queued/running item across all projects \(analyses, proxies, beats\) plus the visible task rows \(downloads, voiceover jobs, failures\) with a cancellable flag. action 'cancel' stops ONE kind of work for ONE asset — queued or already
- `retry\_analysis`: Runs ONE analysis of ONE asset again — picture indexing or speech transcription — clearing whatever failure was recorded for it. If the asset already has a finished transcript or index, that result is deleted and rebuilt. Use when get\_media shows phase 'failed' and the error looks worth another go,
- `set\_keyframes`: Animates one clip property. property: opacity \| volume \| positionX \| positionY \| scaleX \| scaleY \| rotationDeg \| pitch \| yaw \| anchorX \| anchorY \| cropLeft \| cropTop \| cropRight \| cropBottom \| cropSoftness. Keyframes are stamped in SOURCE frames \(frames into the media, i.e. timelineFrame - startFram
- `apply\_layout`: Arranges clips into a screen layout by writing ordinary transform + crop values \(first clipId → first cell\). layout: full \| side-by-side \| top-bottom \| pip-top-left \| pip-top-right \| pip-bottom-left \| pip-bottom-right \| grid-2x2 \| main-sidebar \| three-up. mode 'fit' letterboxes each source in its ce
- `track\_faces`: Finds every FACE in a video clip and stores one independent path per person — position, size and head rotation \(nod/turn/tilt\) per frame. Queued, not immediate: poll list\_face\_tracks until state is 'ready'. Re-running on the same clip REPLACES its previous run and keeps the same trackId, so clips al
- `list\_face\_tracks`: Lists face-tracking runs and the people each one found: faceId, name, frame range, how many frames it was actually visible for, and how many gaps it has. Sample data is deliberately not returned. Use this to poll a queued run and to pick a faceId for bind\_face.
- `merge\_faces`: Joins two or more faces from one run into a single person — for somebody who walked out of the shot and came back. REFUSED when any two of them appear on the same frame, since they cannot then be one person. The earliest face's id and name survive, so existing bindings keep working, and the time bet
- `bind\_face`: Makes a clip FOLLOW a tracked face — the way to stick a mask, label or blur onto somebody's head. Movement is relative to where the face was first seen, so the clip keeps the framing it already had and only inherits the motion. Pick what to copy with channels, and what happens while the face is miss
- `organize\_pool`: THE MEDIA POOL'S SHAPE — bins \(the pool's folders\) and what sits in them. Use it to tidy a project: group the footage, the voice-over, the music and the graphics instead of leaving eighty files at the root. Bins are VIRTUAL and live in the project, not on disk. Moving an item between bins NEVER touc
- `measure\_loudness`: MEASURE THE MIX — you cannot hear it; this is how you check it. Mixes the timeline's audio offline exactly as an export does \(every audio track, nested timelines, fades, volume keyframes, clip audio effects, ducking, mute/solo\) and measures it with EBU R128 / ITU-R BS.1770 — the same meter export lo
- `duplicate\_timeline`: Copy a timeline under a new name — a backup of the cut before a review round changes it, or a variant to try something on. A DEEP copy: new ids for the timeline, its tracks, clips and transitions; links between clips \(A/V pairs, caption groups\) are kept, inside the copy. Nested timelines are copied
- `add\_sample\_media`: Frapea's SAMPLE MEDIA, for trying the editor without your own footage: a short talking clip with speech and pauses \(for transcripts, captions, removing words or silences\), a b-roll shot, a photo and a music bed. No API key, no download from elsewhere. Call with no \`ids\` to list them; call with \`ids\`
- `open\_timeline`: Opens a timeline's TAB in the editor \(the user can close tabs to keep the tab row short; a closed timeline is not deleted and every tool works on it as before\). By default it does not change what the user is looking at; activate:true also shows it, like set\_active\_timeline. get\_timeline reports \`ope
- `close\_timeline`: Closes a timeline's TAB in the editor — hides it from the tab row, does NOT delete it: it stays in the media pool, and you \(or anyone\) can still edit, verify, nest and export it. When it was the one shown, the editor shows the next open tab, or none.

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html