Getcutpro Mcp

CutPro MCP

[](https://www.npmjs.com/package/@cutpro/mcp) [](https://registry.modelcontextprotocol.io) [](https://smithery.ai/servers/contact-8lma/cutpro)

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": "" }
    }
  }
}

Install

[](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522cutpro%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522%2540cutpro%252Fmcp%2522%255D%257D) [](https://cursor.com/en/install-mcp?name=cutpro&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjdXRwcm8vbWNwIl19) [](https://lmstudio.ai/install-mcp?name=cutpro&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjdXRwcm8vbWNwIl19) [](goose://extension?cmd=npx&arg=-y&arg=%40cutpro%2Fmcp&id=cutpro&name=CutPro&description=AI%20video%20clipping%20via%20the%20CutPro%20API)

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= -- 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": "" }
    }
  }
}

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=

Codex

Add to ~/.codex/config.toml:

[mcp_servers.cutpro]
command = "npx"
args = ["-y", "@cutpro/mcp"]
env = { "CUTPRO_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.
• getbalancehistory: 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.
• getrenderdownload: signed download URL of a completed render.
• cancel_render: cancel or delete a render.
• getrenderlimits: render quota for the workspace.
• startbulkdownload / getbulkdownload: bundle several renders into one download.

Posts and connections

• create_post: publish rendered clips to connected accounts (immediate or scheduled).
• listposts / getpost / updatepost / deletepost: manage posts.
• publish_post: trigger publishing now.
• retrypostitem / deletepostitem: handle individual targets.
• listconnections / getconnection: 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

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: getcutpro
• Source: getcutpro/mcp
• License: MIT

Install and usage instructions live in the source repository linked above.