Claude Code

\n\n```bash\nclaude mcp add cutpro --env CUTPRO_API_KEY= -- npx -y @cutpro/mcp\n```\n

\n\n

Claude Desktop

\n\nAdd to `claude_desktop_config.json` (Settings, Developer, Edit Config):\n\n```json\n{\n \"mcpServers\": {\n \"cutpro\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@cutpro/mcp\"],\n \"env\": { \"CUTPRO_API_KEY\": \"\" }\n }\n }\n}\n```\n

\n\n

Cursor / Windsurf / VS Code (manual)

\n\nAdd the standard config above to the client's MCP settings (`mcp.json` / `mcpServers`).\n

\n\n

Cline

\n\nOpen the MCP Servers panel, choose Configure, and add the standard config above.\n

\n\n

Gemini CLI

\n\n```bash\ngemini mcp add cutpro npx -y @cutpro/mcp -e CUTPRO_API_KEY=\n```\n

\n\n

Codex

\n\nAdd to `~/.codex/config.toml`:\n\n```toml\n[mcp_servers.cutpro]\ncommand = \"npx\"\nargs = [\"-y\", \"@cutpro/mcp\"]\nenv = { \"CUTPRO_API_KEY\" = \"\" }\n```\n

\n\n

ChatGPT and Claude.ai (hosted, no install)

\n\nUse the hosted server. Add a custom connector pointing to:\n\n```\nhttps://mcp.cut.pro\n```\n\nYou authorize with your CutPro API key on a consent page (OAuth), so no local setup is needed.\n

\n\n## Configuration\n\nThe server is configured with environment variables.\n\n| Variable | Description | Required |\n| --- | --- | --- |\n| `CUTPRO_API_KEY` | Your CutPro API key (Pro plan). | Yes (stdio) |\n| `CUTPRO_WORKSPACE_ID` | Selects the workspace for multi-workspace keys. | No |\n| `CUTPRO_API_URL` | Override the API base URL. Defaults to `https://api.cut.pro/api/v1`. | No |\n\n

Self-hosting the remote (Streamable HTTP + OAuth)

\n\n| Variable | Description |\n| --- | --- |\n| `MCP_TRANSPORT=http` / `PORT` | Serve Streamable HTTP at the root instead of stdio. |\n| `MCP_OAUTH=1` | Enable the full OAuth 2.1 layer (discovery, DCR, PKCE) for browser clients. |\n| `MCP_PUBLIC_URL` | Public endpoint, e.g. `https://mcp.cut.pro`. Its origin becomes the OAuth issuer. |\n| `MCP_REDIS_URL` | Back OAuth state with Redis so it survives restarts and scales across instances. |\n\n```bash\nMCP_TRANSPORT=http PORT=8787 MCP_OAUTH=1 \\\nMCP_PUBLIC_URL=https://mcp.cut.pro MCP_REDIS_URL=redis://127.0.0.1:6379 \\\nnpx -y @cutpro/mcp\n```\n\nIn 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).\n

\n\n## Tools\n\n

Workspace and balance

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

\n\n

Videos and uploads

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

\n\n

Clipping

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

\n\n

Clips and templates

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

\n\n

Renders

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

\n\n

Posts and connections

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

\n\nEach tool carries read-only / write / destructive annotations so clients can plan calls.\n\n## Links\n\n- Docs: [cut.pro/docs/api-reference/mcp](https://cut.pro/docs/api-reference/mcp)\n- npm: [@cutpro/mcp](https://www.npmjs.com/package/@cutpro/mcp)\n- MCP Registry: `io.github.getcutpro/cutpro`\n\n## License\n\nMIT\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"upstream",{"_98":99,"_100":101,"_102":103,"_104":105,"_106":-5,"_107":108},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_96":85,"_97":85},"ratingAvg","reviewCount","topics",[],"license","MIT","language","JavaScript","registryName","io.github.getcutpro/cutpro","homepage","packages",[109],{"_110":111,"_112":113,"_75":76},"registryType","npm","identifier","@cutpro/mcp","ENV",{"_116":117,"_118":119,"_120":121},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]