Skip to main content
For AI agents: a documentation index is at /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.
The MCP server requires a paid plan with API access enabled.

​
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.

​
Add the server

The endpoint is the same everywhere: 
https://mcp.reap.video/mcp
The fastest way: just ask your agent to connect it for you. Paste this into any MCP-capable agent —
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.
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:
{
  "mcpServers": {
    "reap": {
      "url": "https://mcp.reap.video/mcp"
    }
  }
}

​
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:
1

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.
2

Log in to Reap

Sign in to your Reap account if you aren’t already.
3

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.
4

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.
Done. Your agent can now create projects, track them, and publish clips in the selected workspace.

​
What Can Your Agent Do With MCP?

Clip a video

“Clip the most quotable moments from this YouTube video and keep them under 60 seconds.”

Caption & translate

“Add captions to this video and translate them into Spanish.”

Reframe to 9:16

“Reframe this landscape interview to vertical with the speaker centered.”

Publish to socials

“Publish this clip to my YouTube and TikTok.” (The agent confirms with you before posting.)

​
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
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.

​
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 — 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 — Give your agent knowledge of the Reap Public API
  • Quickstart — Get started with the Reap API
  • Authentication — Manage API keys for direct REST access
  • Dashboard — Manage workspaces, integrations, and API access