MCP SERVER

Capsule MCP

Connect your AI agent to Capsule Studio — create projects, render videos, and produce with the Capsule coproducer, right from your chat.

Connect

Pick your AI tool and follow the steps. Everything runs against the hosted server — nothing to install or self-host.

Connect to Claude

Try it

Once connected, ask Claude this to see what Capsule can do:

What can you do in Capsule? List the tools you have.

Available tools

NameDescription
list-projectsLists all projects the user has access to.
get-projectGets a single project by ID.
create-projectCreate a new empty Capsule project. Optional aspectRatioId sets the initial aspect ratio (defaults to Wide), and optional designSystemId pins the design system. Returns the project ID, design system ID and name, and Studio URL.
rename-projectRenames a Capsule project by ID.
duplicate-projectDuplicate a Capsule project. Returns the new project's ID and Studio URL.
get-project-linkGet the Capsule Studio URL for a project.
get-frame-imageRenders a project frame at a timeline timecode or a component's build time.
list-organizationsLists your Capsule organizations and shows which is your active workspace.
switch-organizationSwitches your active workspace — the same selection Studio's sidebar makes, so both stay in step.
list-aspect-ratiosLists the aspect-ratio presets a project can be set to, with the id each one is set by.
set-project-aspect-ratioSets a Capsule project's aspect ratio to one of the presets.
inspect-templateReturns the available template input fields for a project's render template.
render-variantInitiates a video render for a project template with the provided inputs.
get-render-statusChecks the status of a video render by export ID.
list-project-mediaLists the replaceable clip, B-roll, and audio media in a project, in timeline order.
replace-assetReplaces the media asset on a project node with media from a URL.
check-transcriptionChecks transcription status for uploaded media and inserts the transcript into the project when ready.
add-mediaOpens the Add Media panel in your chat to upload files or URLs, record from your camera or mic with a teleprompter, or generate media — then optionally places the result on the timeline.
replace-clip-mediaReplaces the audio, or a speaking video, on an existing timeline clip from a URL — keeping the clip's position and re-deriving its captions to match.
set-brollFills a clip's product B-roll slots from an ordered list of clip URLs, ingesting each into Capsule cloud, then re-sequences every B-roll on that clip into equal, non-overlapping windows so they play one after another rather than stacking.
list-componentsLists a project's video components — those placed on the timeline and the types available to add.
set-componentSets one or more properties on a project's video component.
set-voiceoverSets the volume of an AI voiceover audio node.
add-design-system-componentPlaces a design-system component on the timeline — as its own clip, or as an overlay on an existing clip.
anchor-to-clipPins a video component to a host clip's timeline window, positioning it relative to that clip rather than to the project.
probe-mediaReads technical metadata for a project's uploaded media — duration, container, codecs, resolution, frame rate and audio layout.
get-page-assetsFetches a public web page and returns its title, description, and the images on it — including ordered gallery photos with source and rendition metadata.
upload-asset-by-urlUploads media from a public URL onto the project timeline, returning immediately while the media uploads in the background.
check-url-uploadChecks the progress of a URL upload and places the media on the timeline once it finishes.
list-voicesLists the Capsule voices available for text-to-speech: actor voices for generate-voiceover, org voices for generate-org-voiceover.
list-voiceoversLists non-clip voiceover audio nodes placed over a project's existing visuals.
generate-voiceoverGenerates an AI voiceover from a script and reserves its timeline node — a clip, or an audio node played over the existing visuals.
generate-org-voiceoverGenerates an AI voiceover using an organization's ElevenLabs voice, without touching the timeline. Poll get-voiceover-status for the finished audio.
get-voiceover-statusChecks an AI voiceover generation and, once complete, binds the audio and its transcript to the timeline node reserved for it.
place-generated-voiceoverAdds a completed AI voiceover generation to the project timeline as a clip or an audio node.
regenerate-voiceoverReplaces an existing actor-voice AI voiceover's script or voice in place, keeping its timeline position. The current audio stays until the new take is ready.
regenerate-org-voiceoverReplaces an existing org-voice AI voiceover in place, keeping its timeline position and current audio until the new take is ready.
run-voice-magicStart Voice Magic on these clips and wait until cleaned audio can be turned on. Tags them so Studio can also turn it on if the project is open. If it is already done, turns it on now. If it is still running after waiting, call again later or ask to turn it on. Skips clips that already have it on.
set-voice-magicTurn Voice Magic on or off for these clips. On only works after the job has finished.
remove-clip-at-indexRemoves the clip at the given zero-based index from a Capsule project's timeline.
duplicate-clipDuplicates a clip in a project's timeline, identified by its id/handle.
reorder-clipsSets the order of every clip in a project's timeline from a complete ordered list of clip handles.
remove-componentRemoves a placed component (an overlay, caption, B-roll or audio layer) from a project's timeline by its key.
split-clipSplits a clip in a project's timeline into two clips at a given position, using the same split logic as Studio.
remove-voiceoverRemoves an AI voiceover clip or audio node from a project's timeline by its key.
cut-wordsCuts words out of a project's timeline by transcript node slug, closing the gap.
restore-cut-wordsRestores previously cut words back into a project's timeline by cut node slug.
do-auto-jump-cutsRuns Auto Jump Cut: finds and removes every silent gap above a minimum length, keeping all spoken words.
get-project-transcript-mdReads a project's word-level transcript as compact markdown lines.
get-compact-transcript-mdReads an uploaded asset's transcript as sentence-level cues with timecodes — the input for choosing which moments to cut.
video-cutdownCuts a short sequence out of one or more transcribed source videos by inserting the chosen time ranges as trimmed clips.
inspect-imageInspects a public image URL and returns a grounded visual summary plus an image-to-video motion prompt. Use before generate-video when the image cannot be viewed directly.
generate-videoStart an AI video generation from a text prompt or image. Returns a generation ID to poll for the result.
generate-imageStart an AI image generation from a text prompt, or edit/compose from reference images. Returns a generation ID to poll for the result.
list-voicesList the Capsule voices available for text-to-speech generation.
get-generation-statusCheck the status of an AI generation and retrieve signed asset URLs when complete.
list-ai-actorsLists AI actors available to you. Pick an id for create-actor-video.
list-ai-locationsLists AI locations available to you. Pick an id for create-actor-video.
create-actor-videoStarts an AI actor video generation from a script. Poll get-generation-status (type "actorVideo") until done.
add-actor-video-to-projectInserts a completed actor video onto a Capsule project timeline as clips.
find-soundtrackSearch Capsule's soundtrack library by mood or song name and return candidate tracks.
play-soundtrackOpens an inline audio player for a soundtrack candidate. Does not modify the project.
play-videoOpens an inline video player for a video URL — for example a finished render. Does not modify the project.
get-file-urlResolves a Payload file ID into a presigned URL, for example so play-video can play it.
set-soundtrackIngests a soundtrack candidate or custom audio URL into Capsule cloud and sets it as the project's background music, or removes the current soundtrack.
set-soundtrack-settingsUpdates volume, Adjust Selection, AutoMix, and AutoMix duck amount on the project's current soundtrack.
create-video-exportCreates video files from a Capsule project's current timeline, with options for aspect ratio and quality.
invite-to-orgInvites someone to your organization by email as an admin, creator, or reviewer — limited to the roles your own role can grant.
invite-to-projectShares a project with one or more people by email as a viewer, editor, or commentor — limited to the roles your own project access can grant.
invite-to-design-systemGrants someone access to a specific design system, inviting them to the organization first if they aren't a member yet. Org admins only.
list-skillsLists Capsule-authored video-production skills available to you.
get-skillGets the full instructions for a Capsule skill by the id list-skills returned.