Summary
Connects Claude to the full CutPro API for AI-driven video clipping. You get 34 tools covering the entire workflow: analyze a long video, submit it for clipping, list the AI-generated clips sorted by rating, apply editing templates, render to MP4, and publish to TikTok, Instagram, or YouTube. Works over stdio for local clients and a hosted Streamable HTTP endpoint with OAuth for ChatGPT and Claude.ai. Requires a CutPro Pro plan and API key. Token-efficient by design: list operations cap results and omit signed URLs unless requested. Reach for this when you want to automate virality from raw footage without leaving the LLM context.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
34 tools
get_workspaceThe workspace this key resolved to, with plan and role.
The workspace this key resolved to, with plan and role.
No parameter schema in public metadata yet.
get_balanceCurrent credit balance of the workspace.
Current credit balance of the workspace.
No parameter schema in public metadata yet.
get_balance_historyLedger of credits added and consumed.4 params
Ledger of credits added and consumed.
Parameters* required
pageintegertypestringlimitintegerreference_typestringlist_videosYour source video library.3 params
Your source video library.
Parameters* required
pageintegersortstringlimitintegerdelete_videoDelete a source video and its submissions/clips.1 params
Delete a source video and its submissions/clips.
Parameters* required
video_idstringstart_uploadGet a presigned URL to upload your own video file. PUT the bytes to upload_url (same content_type), then call complete_upload. Max 2 GB; .mp4/.mov/.webm/.mkv.3 params
Get a presigned URL to upload your own video file. PUT the bytes to upload_url (same content_type), then call complete_upload. Max 2 GB; .mp4/.mov/.webm/.mkv.
Parameters* required
file_namestringfile_sizenumberFile size in bytes.
content_typestringMIME type. Defaults to video/mp4.
complete_uploadRegister a finished upload (after the PUT) and get its metadata and credit cost. Returns a video_id for submit_clipping.5 params
Register a finished upload (after the PUT) and get its metadata and credit cost. Returns a video_id for submit_clipping.
Parameters* required
widthnumberheightnumberdurationnumbervideo_idstringfile_namestringanalyze_videoPreview metadata and credit cost of a public video URL (YouTube, Twitch, Kick, TikTok). Free. Returns a video_id for submit_clipping.1 params
Preview metadata and credit cost of a public video URL (YouTube, Twitch, Kick, TikTok). Free. Returns a video_id for submit_clipping.
Parameters* required
urlstringPublic video URL.
submit_clippingStart AI clipping. Charges credits immediately (call analyze_video first). Returns submission_id to poll with get_submission.5 params
Start AI clipping. Charges credits immediately (call analyze_video first). Returns submission_id to poll with get_submission.
Parameters* required
video_idstringFrom analyze_video or complete_upload.
timeframeobjectSeconds [start, end) to process. Omit for the whole video.
strategy_idstringClipping strategy id.
template_idstringEditing template id.
source_languagestringone of
auto · en · ptlist_submissionsClipping jobs for a video.3 params
Clipping jobs for a video.
Parameters* required
pageintegerlimitintegervideo_idstringget_submissionPoll a submission until status is 'completed' or 'failed'.2 params
Poll a submission until status is 'completed' or 'failed'.
Parameters* required
video_idstringsubmission_idstringdelete_submissionDelete a submission and its clips.2 params
Delete a submission and its clips.
Parameters* required
video_idstringsubmission_idstringlist_clipsClips of a completed submission, rating-sorted. URLs omitted unless include_urls is true (they are long).5 params
Clips of a completed submission, rating-sorted. URLs omitted unless include_urls is true (they are long).
Parameters* required
limitintegerMax clips to return. Default 10.
video_idstringmin_ratingnumberOnly clips with at least this rating (0-10).
include_urlsbooleanInclude play/download URLs. Default false.
submission_idstringapply_templateApply an editing template to clips of a submission in bulk. Omit clip_ids to apply to all.4 params
Apply an editing template to clips of a submission in bulk. Omit clip_ids to apply to all.
Parameters* required
clip_idsarrayvideo_idstringtemplate_idstringsubmission_idstringdelete_clipDelete a single generated clip.3 params
Delete a single generated clip.
Parameters* required
clip_idstringvideo_idstringsubmission_idstringlist_templatesEditing templates to apply to clips. Use an id as template_id.4 params
Editing templates to apply to clips. Use an id as template_id.
Parameters* required
pageintegersortstringlimitintegerfilterstringrender_clipRender a clip to a final MP4. Returns render_id (poll with get_render). download_url is included when served from cache.3 params
Render a clip to a final MP4. Returns render_id (poll with get_render). download_url is included when served from cache.
Parameters* required
clip_idstringvideo_idstringsubmission_idstringlist_rendersYour render jobs.3 params
Your render jobs.
Parameters* required
pageintegerlimitintegerstatusstringget_render_limitsRender quota and limits for the workspace.
Render quota and limits for the workspace.
No parameter schema in public metadata yet.
get_renderPoll a render until status is 'completed'.1 params
Poll a render until status is 'completed'.
Parameters* required
render_idstringget_render_downloadSigned download URL of a completed render.1 params
Signed download URL of a completed render.
Parameters* required
render_idstringcancel_renderCancel an in-progress render or delete a finished one.1 params
Cancel an in-progress render or delete a finished one.
Parameters* required
render_idstringstart_bulk_downloadBundle several renders into one download. Returns a jobId to poll with get_bulk_download.1 params
Bundle several renders into one download. Returns a jobId to poll with get_bulk_download.
Parameters* required
render_idsarrayRender ids to bundle.
get_bulk_downloadPoll a bulk download job until ready.1 params
Poll a bulk download job until ready.
Parameters* required
job_idstringcreate_postPublish rendered clips to connected accounts. Each video has an editId (the render's edit_setting_id) and targets (connectionId + per-platform metadata). Set scheduled_at (ISO 8601) to schedule.2 params
Publish rendered clips to connected accounts. Each video has an editId (the render's edit_setting_id) and targets (connectionId + per-platform metadata). Set scheduled_at (ISO 8601) to schedule.
Parameters* required
videosarrayClips to publish and where.
scheduled_atstringISO 8601 future time to schedule the post.
list_postsYour posts.3 params
Your posts.
Parameters* required
pageintegerlimitintegerstatusstringget_postA post with its per-account items and statuses.1 params
A post with its per-account items and statuses.
Parameters* required
idstringupdate_postUpdate a pending post, e.g. reschedule or adjust items.3 params
Update a pending post, e.g. reschedule or adjust items.
Parameters* required
idstringitemsarrayscheduled_atstringpublish_postTrigger immediate publishing of a post.1 params
Trigger immediate publishing of a post.
Parameters* required
idstringretry_post_itemRetry a single failed post item without disturbing the others.2 params
Retry a single failed post item without disturbing the others.
Parameters* required
idstringitem_idstringdelete_post_itemRemove a single item from a post.2 params
Remove a single item from a post.
Parameters* required
idstringitem_idstringdelete_postDelete an entire post.1 params
Delete an entire post.
Parameters* required
idstringlist_connectionsConnected social accounts. Use an id as connectionId in create_post.3 params
Connected social accounts. Use an id as connectionId in create_post.
Parameters* required
pageintegerlimitintegerplatformstringget_connectionA single connected account.1 params
A single connected account.
Parameters* required
idstringCutPro 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_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
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
CUTPRO_API_KEY*secretYour CutPro API key (Pro plan). Generate one at https://cut.pro/studio/me/api-keys.
CUTPRO_WORKSPACE_IDOnly needed for multi-workspace keys.
Categories
Registryactive
Package@cutpro/mcp
TransportSTDIO, HTTP
AuthRequired
UpdatedJun 1, 2026
