> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reap.video/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> Connect your AI agent to your Reap workspace — create clips, add captions, reframe, dub, and publish via Model Context Protocol

> **For AI agents:** a documentation index is at [/llms.txt](/llms.txt). Every page is also available as markdown, just append `.md` to the URL.

## Overview

The Reap MCP server connects your AI agent directly to your Reap workspace. Once connected, your agent can run the full pipeline for you -- upload a video, generate clips, add captions, reframe, dub, transcribe, and publish to social platforms -- all from inside your chat.

Works with **Cursor**, **Claude Code**, **VS Code**, **GitHub Copilot**, **Codex**, **Gemini CLI**, and any other MCP-compatible agent.

<Note>
  The MCP server requires a paid plan with API access enabled.
</Note>

## How it works

1. **Add** the endpoint `https://mcp.reap.video/mcp` to your agent.
2. **Authorize** once via OAuth — sign in and pick the workspace the agent may use.
3. **Use** the tools in chat. No API key to copy, no local server to run.

The agent only ever has access to the single workspace you select, and you can revoke it anytime from your [dashboard](https://app.reap.video).

## Add the server

The endpoint is the same everywhere:

```text theme={"system"}
https://mcp.reap.video/mcp
```

<Tip>
  The fastest way: just ask your agent to connect it for you. Paste this into any MCP-capable agent —

  ```text theme={"system"}
  Add reap to my user-scoped MCP servers and connect:

  "reap": {
    "url": "https://mcp.reap.video/mcp"
  }
  ```

  The agent writes the config and kicks off the sign-in below. The rest of this page is the manual path if you'd rather wire it up yourself.
</Tip>

<Tabs>
  <Tab title="Cursor / VS Code">
    Add to `.cursor/mcp.json` (Cursor) or `.vscode/mcp.json` (VS Code) in your project root — or to your global MCP settings to make it available everywhere:

    ```json theme={"system"}
    {
      "mcpServers": {
        "reap": {
          "url": "https://mcp.reap.video/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Claude Code">
    Add it as a user-scoped HTTP server, then run `/mcp` to sign in:

    ```bash theme={"system"}
    claude mcp add --transport http reap "https://mcp.reap.video/mcp"
    ```
  </Tab>

  <Tab title="Other agents">
    Any MCP-compatible agent works. Point its MCP config at the streamable HTTP endpoint:

    ```text theme={"system"}
    https://mcp.reap.video/mcp
    ```

    The OAuth sign-in below is triggered automatically by the agent — there's nothing extra to configure.
  </Tab>
</Tabs>

## Sign in to your workspace

The first time the agent connects (Claude Code prompts this on `/mcp`; Cursor and others trigger it on first tool use), a one-time OAuth sign-in runs:

<Steps>
  <Step title="A browser window opens">
    The agent opens the Reap authorization page automatically. If it doesn't open, your agent shows the URL to copy into a browser manually.
  </Step>

  <Step title="Log in to Reap">
    Sign in to your Reap account if you aren't already.
  </Step>

  <Step title="Choose a workspace and authorize">
    The consent screen shows that the app will be able to **manage your videos & clips** in the workspace you pick. Choose the workspace from the dropdown and click **Authorize**. The agent only ever gets access to the workspace you select.
  </Step>

  <Step title="Return to your agent">
    The browser shows **Authentication successful** — close the tab and go back to your agent. It reconnects automatically and the Reap tools are now live.
  </Step>
</Steps>

<Check>
  **Done.** Your agent can now create projects, track them, and publish clips in the selected workspace.
</Check>

## What Can Your Agent Do With MCP?

<CardGroup cols={2}>
  <Card title="Clip a video" icon="scissors">
    "Clip the most quotable moments from this YouTube video and keep them under 60 seconds."
  </Card>

  <Card title="Caption & translate" icon="closed-captioning">
    "Add captions to this video and translate them into Spanish."
  </Card>

  <Card title="Reframe to 9:16" icon="crop">
    "Reframe this landscape interview to vertical with the speaker centered."
  </Card>

  <Card title="Publish to socials" icon="share">
    "Publish this clip to my YouTube and TikTok." (The agent confirms with you before posting.)
  </Card>
</CardGroup>

## Tools

The MCP exposes the full Reap workspace as 24 tools.

**Create projects**

* `request_upload_url` -- get a presigned URL to upload a source video
* `create_clips` -- generate AI clips from a video or URL
* `add_captions` -- add styled, animated captions
* `transcribe` -- transcribe a video to timestamped text
* `reframe` -- change aspect ratio with auto face tracking
* `dub_video` -- voice-dub into another language

**Track & retrieve**

* `list_videos` -- list projects in the workspace
* `get_video` -- full metadata for one project
* `get_status` -- processing status plus a live time estimate
* `get_results` -- generated clips with download URLs
* `get_clip` -- details for a single clip
* `list_uploads` -- videos uploaded to the workspace

**Edit metadata**

* `update_video` -- rename a project
* `update_clip` -- edit a clip's title or caption

**Publish**

* `list_integrations` -- connected social accounts
* `publish_clip` -- post a clip immediately
* `schedule_clips` -- schedule clips for later
* `list_publisher_posts` -- list scheduled and published posts
* `get_publisher_post` -- details for one post
* `update_publisher_post` -- edit a scheduled post

**Reference catalogs**

* `get_caption_styles` -- built-in caption styles
* `list_templates` -- saved caption-style presets
* `get_translation_languages` -- supported transcription/translation languages
* `get_dubbing_languages` -- supported dubbing languages

<Warning>
  `publish_clip`, `schedule_clips`, and `update_publisher_post` post or modify content publicly. These tools require an explicit confirmation, so your agent will ask you before posting on your behalf.
</Warning>

## MCP vs Agent Skill

Both connect Reap to your agent, but they do different jobs:

* **MCP server** -- connects your agent to your workspace live over OAuth so it creates clips, tracks projects, and publishes for you.
* **[Agent Skill](/api-reference/agent-skills)** -- *teaches* your agent the Reap Public API so it can write integration code. Offline, versioned with your repo.

Use both together: the skill to write code against the API, the MCP to let your agent run your workspace directly.

## Learn More

* [Agent Skills](/api-reference/agent-skills) -- Give your agent knowledge of the Reap Public API
* [Quickstart](/api-reference/3_quickstart) -- Get started with the Reap API
* [Authentication](/api-reference/2_authentication) -- Manage API keys for direct REST access
* [Dashboard](https://app.reap.video) -- Manage workspaces, integrations, and API access