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 with the workflow tools only.) 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 27 workflow tools below, plus the thumbnail-generation tools. The Claude Connector exposes the same 27 workflow tools and no generation tools.
  • 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_editing_script — fetch a clip’s editing script
  • 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_apply_editing_script — modify a clip and re-render · consumes credits
  • 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_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 first org with API access. To target a different org, ask the agent to list your orgs and select one; the choice applies for subsequent requests in the same conversation.
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.