CutPro MCP

Created By

getcutpro20 days ago

MCP server exposing the full CutPro v1 API as 34 tools for AI clients — analyze videos, submit clipping jobs, manage clips, render clips, and publish posts to social platforms. Supports stdio (Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Cline, Zed), Streamable HTTP (remote), and OAuth 2.1 (ChatGPT, Claude.ai browser). Requires CutPro Pro plan. npm: @cutpro/mcp | Remote: https://mcp.cut.pro

# video

# clipping

Overview Content Tools Comments

Overview

CutPro MCP

A Model Context Protocol (MCP) server that turns long videos into viral clips with AI. It exposes the full CutPro API as tools, so an LLM can run the whole flow: analyze a video, clip the best moments, render the final MP4, and publish to TikTok, Instagram and YouTube.

Key features

End to end. All 34 v1 endpoints as tools: workspace, balance, videos, clipping, clips, templates, renders, posts and connections.
Token efficient. Results are compact and projected to the fields that matter; list_clips is rating sorted, capped, and omits long signed URLs unless asked.
Runs everywhere. stdio for local clients (Claude Code, Cursor, Claude Desktop, Windsurf, VS Code, Cline, Zed) and a hosted Streamable HTTP endpoint with OAuth for ChatGPT and Claude.ai.

Getting started

Requirements

Node.js 18 or newer.
A CutPro account on the Pro plan and an API key. Generate one at cut.pro/studio/me/api-keys.
An MCP-compatible client.

Standard config

Most clients use the same JSON. Add your API key under env:

{
  "mcpServers": {
    "cutpro": {
      "command": "npx",
      "args": ["-y", "@cutpro/mcp"],
      "env": { "CUTPRO_API_KEY": "<your-api-key>" }
    }
  }
}

Install

After installing via a button, add your CUTPRO_API_KEY to the server's env.

Claude Code

claude mcp add cutpro --env CUTPRO_API_KEY=<your-api-key> -- npx -y @cutpro/mcp

Claude Desktop

Add to claude_desktop_config.json (Settings, Developer, Edit Config):

{
  "mcpServers": {
    "cutpro": {
      "command": "npx",
      "args": ["-y", "@cutpro/mcp"],
      "env": { "CUTPRO_API_KEY": "<your-api-key>" }
    }
  }
}

Cursor / Windsurf / VS Code (manual)

Add the standard config above to the client's MCP settings (mcp.json / mcpServers).

Cline

Open the MCP Servers panel, choose Configure, and add the standard config above.

Gemini CLI

gemini mcp add cutpro npx -y @cutpro/mcp -e CUTPRO_API_KEY=<your-api-key>

Codex

Add to ~/.codex/config.toml:

[mcp_servers.cutpro]
command = "npx"
args = ["-y", "@cutpro/mcp"]
env = { "CUTPRO_API_KEY" = "<your-api-key>" }

ChatGPT and Claude.ai (hosted, no install)

Use the hosted server. Add a custom connector pointing to:

https://mcp.cut.pro

You authorize with your CutPro API key on a consent page (OAuth), so no local setup is needed.

Configuration

The server is configured with environment variables.

Variable	Description	Required
`CUTPRO_API_KEY`	Your CutPro API key (Pro plan).	Yes (stdio)
`CUTPRO_WORKSPACE_ID`	Selects the workspace for multi-workspace keys.	No
`CUTPRO_API_URL`	Override the API base URL. Defaults to `https://api.cut.pro/api/v1`.	No

Self-hosting the remote (Streamable HTTP + OAuth)

Variable	Description
`MCP_TRANSPORT=http` / `PORT`	Serve Streamable HTTP at the root instead of stdio.
`MCP_OAUTH=1`	Enable the full OAuth 2.1 layer (discovery, DCR, PKCE) for browser clients.
`MCP_PUBLIC_URL`	Public endpoint, e.g. `https://mcp.cut.pro`. Its origin becomes the OAuth issuer.
`MCP_REDIS_URL`	Back OAuth state with Redis so it survives restarts and scales across instances.

MCP_TRANSPORT=http PORT=8787 MCP_OAUTH=1 \
MCP_PUBLIC_URL=https://mcp.cut.pro MCP_REDIS_URL=redis://127.0.0.1:6379 \
npx -y @cutpro/mcp

In OAuth mode the user authorizes with their own API key on a consent page; the access token maps server side to that key. Without MCP_REDIS_URL, an in-memory store is used (single instance, state lost on restart).

Tools

Workspace and balance

get_workspace: the workspace this key resolved to, with plan and role.
get_balance: current credit balance.
get_balance_history: ledger of credits added and consumed.

Videos and uploads

list_videos: your source video library.
start_upload: get a presigned URL to upload your own file (max 2 GB; .mp4/.mov/.webm/.mkv).
complete_upload: register a finished upload and get its credit cost.
delete_video: delete a source video and its submissions.

Clipping

analyze_video: preview metadata and credit cost of a public URL (free).
submit_clipping: start AI clipping (charges credits).
list_submissions: clipping jobs for a video.
get_submission: poll a submission until completed or failed.
delete_submission: delete a submission and its clips.

Clips and templates

list_clips: clips of a completed submission, rating sorted (URLs opt-in).
apply_template: apply an editing template to clips in bulk.
delete_clip: delete a single clip.
list_templates: editing templates to apply to clips.

Renders

render_clip: render a clip to a final MP4.
get_render: poll a render until completed.
get_render_download: signed download URL of a completed render.
cancel_render: cancel or delete a render.
get_render_limits: render quota for the workspace.
start_bulk_download / get_bulk_download: bundle several renders into one download.

Posts and connections

create_post: publish rendered clips to connected accounts (immediate or scheduled).
list_posts / get_post / update_post / delete_post: manage posts.
publish_post: trigger publishing now.
retry_post_item / delete_post_item: handle individual targets.
list_connections / get_connection: connected social accounts.

Each tool carries read-only / write / destructive annotations so clients can plan calls.

License

MIT

Server Config

{
  "mcpServers": {
    "cutpro": {
      "command": "npx",
      "args": [
        "-y",
        "@cutpro/mcp"
      ],
      "env": {
        "CUTPRO_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Recommend Servers

TraeBuild with Free GPT-4.1 & Claude 3.7. Fully MCP-Ready.

EdgeOne Pages MCPAn MCP service designed for deploying HTML content to EdgeOne Pages and obtaining an accessible public URL.

Tavily Mcp

AiimagemultistyleA Model Context Protocol (MCP) server for image generation and manipulation using fal.ai's Stable Diffusion model.

Visual Studio Code - Open Source ("Code - OSS")Visual Studio Code

BlenderBlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. This integration enables prompt assisted 3D modeling, scene creation, and manipulation.

WindsurfThe new purpose-built IDE to harness magic

DeepChatYour AI Partner on Desktop

Baidu Map百度地图核心API现已全面兼容MCP协议，是国内首家兼容MCP协议的地图服务商。

MiniMax MCPOfficial MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.

Serper MCP ServerA Serper MCP Server