Skip to main content
Connect OpusClip to an AI agent and work from natural-language prompts such as “clip this video” or “schedule this clip to post tomorrow at 9am.” Pro-tier API access is in Beta. The limits described on Limitations apply to Pro Beta and Max unless noted otherwise. Business customers have API access per their contract. This page covers the MCP Server (mcp.opus.pro/mcp) for Cursor, Cline, Claude Code, ChatGPT / Codex, and other MCP hosts. Using Claude.ai? Use the Claude Connector instead. Prefer an API-key code package? See the Skill.
1

Install

OpusClip runs as a hosted MCP server — nothing to install or run locally, and OAuth sign-in on first use (no API key):
The MCP Server exposes the full tool catalog, including thumbnail generation. (The Claude Connector is a separate endpoint for Claude.ai: workflow tools only, and publishing there requires the user to confirm in OpusClip.) Any OpusClip account can complete the OAuth flow and view the tool catalog. Calling a tool requires Pro Beta, Max, or Business plan access; without it, the host returns an upgrade prompt.

​
Install from a directory (one-click)

OpusClip is listed across the agent-discovery ecosystem — the fastest ways to add it (all connect to https://mcp.opus.pro/mcp; complete the OAuth sign-in on first use):
  • npm — npx @opusclip/mcp, or add it to your host config:
  • MCP Registry — search opusclip (server name io.github.opus-pro/opusclip).
  • Smithery — smithery.ai/servers/opusclip/opusclip.
  • Cursor — search OpusClip on cursor.directory, or use an Add to Cursor deep link.
  • Cline — search OpusClip in the Cline MCP Marketplace.

​
Other MCP hosts (manual config)

Point your host at https://mcp.opus.pro/mcp and complete the OAuth flow when prompted. For example, Cursor (~/.cursor/mcp.json) or Cline (cline_mcp_settings.json):

​
Tool catalog

The MCP Server exposes the 28 tools below (26 workflow tools plus two deprecated no-op signposts), plus the thumbnail-generation tools.The Claude Connector is not the same surface. It exposes the same 28 tools and no generation tools, and — the difference that matters most — its posting, scheduling, unscheduling, and project-sharing tools do not commit: they return a link the user confirms in OpusClip. On this endpoint those same four tools commit directly, because you configured mcp.opus.pro yourself rather than reaching it through a listed connector. Do not assume a prompt that works here behaves identically there.
  • opusclip_whoami — identity check for the connected org
  • opusclip_get_usage — show the org’s current API usage against its cap
  • opusclip_list_projects — list recent clip projects
  • opusclip_list_clips — list clips inside a project
  • opusclip_describe_clip — fetch a single clip’s detail (transcript, layout, render status)
  • opusclip_list_collections — list collections
  • opusclip_list_clips_in_collection — list clips inside a collection
  • opusclip_list_brand_templates — list brand templates
  • opusclip_list_social_accounts — list connected social accounts
  • opusclip_list_scheduled_posts — list scheduled and recent posts (returns the schedule_id that unscheduling requires)
  • opusclip_get_transcript — fetch a project’s source-video transcript
  • opusclip_get_social_copy_job — fetch a social copy job
  • opusclip_submit_project — clip a YouTube or Vimeo URL · consumes credits
  • opusclip_create_upload_link — get a signed URL to upload a local video
  • opusclip_edit_clip — edit a clip with named operations in one call: captions, emoji, and keyword-highlight toggles; filler-word and pause removal; section trim, split, drop, and reorder; phrase cutting; caption colour, position, and casing; clip dubbing; and undo · re-renders the preview
  • opusclip_create_censor_job — bleep or mask flagged content · consumes credits
  • opusclip_share_project — make a project publicly viewable
  • opusclip_create_collection — create a collection
  • opusclip_add_clip_to_collection — add a clip to a collection
  • opusclip_export_clip — get one clip’s HD download URL (ready / rendering / unavailable)
  • opusclip_export_collection — get HD download URLs for every clip in a collection
  • opusclip_duplicate_clip — copy a clip to <title> (Copy); free, no re-render
  • opusclip_create_social_copy_job — generate platform-specific social copy
  • opusclip_create_post_task — post a clip to a connected social account
  • opusclip_schedule_publish — schedule a clip for future posting
  • opusclip_unschedule_publish — cancel a previously scheduled post
  • opusclip_get_editing_script — deprecated; returns no editing script, only a pointer to opusclip_edit_clip
  • opusclip_apply_editing_script — deprecated; applies nothing and re-renders nothing, only a pointer to opusclip_edit_clip
Editing scripts were retired as a surface; opusclip_edit_clip is the only editing route. These two names remain so an agent holding an older tool list is redirected instead of hitting a hard error.
  • opusclip_create_thumbnail_job — generate thumbnail options for a clip · consumes credits
  • opusclip_get_thumbnail_job — fetch a thumbnail job’s status and results
list_clips and describe_clip return preview URLs only — the HD download URL comes from export_clip (one clip) or export_collection (a collection).

​
Troubleshooting

Sign in with the same identity provider used to create the OpusClip account (email, Google, or Apple).
The org does not have the API entitlement. Pro Beta and Max orgs receive it automatically. Otherwise, contact sales.
The one picked on the OAuth consent screen at connect time. It is fixed for the life of the connection, and no tool can switch it — there is no list_orgs. To act in a different org, disconnect and reconnect, choosing that org while signing in. whoami reports the current one.
Hosts refresh tokens automatically. If refresh fails persistently, remove the connector and re-add it.
403 indicates the monthly cap (15h / 900 credits per workspace) has been hit. The cap resets on the first day of the next month (UTC). 429 indicates the concurrent-project limit (4) has been hit and clears as in-flight projects finish. See Limitations.
Tools consume credits and inherit the Pro Beta & Max caps (15h monthly, 10-credit per-project floor, 4 concurrent projects). See Limitations.
2

Try it

Clip a video
Clip this YouTube video and give me the top 5 best clips https://youtube.com/watch?v=...
Inline edits
Fix the typo in caption 4 of clip 3.

​
What’s next

  • Using Claude.ai? See the Claude Connector.
  • Prefer an API-key code package? See the Skill.
  • Need higher limits? Contact sales.
  • On a Business plan? Your custom limits live in your contract. Talk to your account manager for details.