CutPro
FreeNot checkedMCP server exposing the full CutPro v1 API as 34 tools for AI clients — analyze videos, submit clipping jobs, manage clips, render, and publish posts. Supports
About
MCP server exposing the full CutPro v1 API as 34 tools for AI clients — analyze videos, submit clipping jobs, manage clips, render, and publish posts. Supports stdio, Streamable HTTP, and OAuth 2.1.
README
CutPro MCP
npm version MCP Registry smithery badge
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_clipsis 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.
Links
- Docs: cut.pro/docs/api-reference/mcp
- npm: @cutpro/mcp
- MCP Registry:
io.github.getcutpro/cutpro
License
MIT
Install CutPro in Claude Desktop, Claude Code & Cursor
unyly install cutpro-mcpInstalls into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.
First time? Get the CLI: curl -fsSL https://unyly.org/install | sh
Or configure manually
Run in your terminal:
claude mcp add cutpro-mcp -- npx -y @cutpro/mcpFAQ
Is CutPro MCP free?
Yes, CutPro MCP is free — one-click install via Unyly at no cost.
Does CutPro need an API key?
No, CutPro runs without API keys or environment variables.
Is CutPro hosted or self-hosted?
Self-hosted: the server runs locally on your machine via the install command above.
How do I install CutPro in Claude Desktop, Claude Code or Cursor?
Open CutPro on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
Fetch
Web content fetching and conversion for efficient LLM usage.
AWS KB Retrieval
Retrieval from AWS Knowledge Base using Bedrock Agent Runtime.
by modelcontextprotocolSpring AI MCP Server
Provides auto-configuration for setting up an MCP server in Spring Boot applications.
llm-analysis-assistant
A very streamlined mcp client that supports calling and monitoring stdio/sse/streamableHttp, and can also view request responses through the /logs page. It also
by xuzexin-hzCompare CutPro with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All ai MCPs
