Skip to main content

MCP Tools

A full reference of every tool available through the Supercut MCP server, and what each one does.

Written by Supercut

These are the tools available once you've connected Supercut to your AI tool over MCP. For more info, refer to this documentation or see Model Context Protocol (MCP) or Connect Supercut in Claude Cowork.

Most tools take a public_id: the share ID of a recording or playlist, the last segment of its share link (supercut.ai/share/{workspaceName}/{shareId}).


Recordings

list-recordings

Lists recordings in the workspace. Choose owned, watched, or shared with the list parameter, defaults to owned. Supports a title search on the owned list, plus cursor and limit for pagination.

get-recording

Returns metadata for a single recording: title, owner, duration, processing status, and created date.

get-transcript

Fetches the full transcript for a recording.

get-frame

Returns a signed URL for a still frame at a specific timestamp. Pass a time in seconds (decimals allowed) and an optional quality tier (uhd, qhd, fhd, hd, sd). Supercut falls back to the best quality available.


Comments, reactions, and forms

list-comments

Lists comments and replies left on a recording.

list-reactions

Lists emoji reactions placed directly on a recording's timeline.

list-form-responses

Lists viewer form-response submissions for a recording. Supports cursor and limit for pagination.


Playlists

list-playlists

Lists playlists in the workspace. Supports cursor and limit for pagination.

get-playlist

Returns metadata for a single playlist.

list-playlist-recordings

Lists the recordings inside a playlist. Supports cursor and limit for pagination.

add-playlist-recording

Adds a recording to an existing playlist. Requires edit access to the playlist and view access to the recording. Fails if the recording is already in the playlist. This is currently the only MCP tool that writes data. Every other tool is read-only.


That's it!

Your AI tool can read and organize your Supercut data directly: recordings, transcripts, frames, comments, reactions, form responses, and playlists, all through these tools. New tools get added as MCP grows, and this article will track them as they ship.

Did this answer your question?