# Capsule MCP

> Capsule MCP is a Model Context Protocol server that lets AI agents operate Capsule Studio: create projects, render videos, and chat with the Capsule coproducer.

## Endpoint

MCP transport (Streamable HTTP): https://mcp.capsule.video/mcp

Authentication: OAuth 2.1 with PKCE via WorkOS AuthKit. Users sign in with the same account they use at https://studio.capsule.video.

## Connecting

Most MCP clients can connect directly to https://mcp.capsule.video/mcp. Clients without OAuth support should bridge through mcp-remote:

  npx -y mcp-remote https://mcp.capsule.video/mcp

## Tools

- whoami: Returns the authenticated user's profile.
- list-projects: Lists all projects the user has access to.
- get-project: Gets a single project by ID.
- create-project: Create a new empty Capsule project. Returns the project ID and Studio URL.
- coproducer-chat: Send a message to the Capsule coproducer AI agent for a project. The agent guides you through video production: Context & Goal → Source Material → VO Script → Voiceover Recording → Screen Recordings → Handoff.
- get-project-link: Get the Capsule Studio URL for a project.
- inspect-template: Returns the available template input fields for a project's render template.
- render-variant: Initiates a video render for a project template with the provided inputs.
- get-render-status: Checks the status of a video render by export ID.

## Discovery

- MCP manifest: https://mcp.capsule.video/.well-known/mcp
- OAuth resource metadata: https://mcp.capsule.video/.well-known/oauth-protected-resource
- Human-readable docs: https://mcp.capsule.video/

## About Capsule

Capsule Studio (https://studio.capsule.video) is a video production platform. The MCP server gives agents programmatic access to the same workflows a human user has in the web app.