OpusClip

io.github.mindstonePublished by GitHub account mindstonev0.3.0Updated Nov 17, 2026

OpusClip MCP server — clip long-form videos, manage projects, collections, censor jobs, posts

Overview

AI-generated overview

OpusClip MCP server that lets an assistant turn long-form videos into short clips, manage projects and collections, and publish clips to social accounts.

What you can do
  • Create clipping projects from a video URL or upload a local video file, then poll project status and list generated clips
  • List brand templates and download exported clip MP4s into a workspace folder
  • Create, list, export and delete clip collections, and add or remove clips in them
  • Run censor jobs that mute or bleep profanity in a clip and poll their status
  • List connected social accounts, generate platform-specific social copy, and publish, schedule or cancel posts
  • Change a project's sharing visibility
When to use it
Useful when you want an assistant to repurpose long videos into short clips, keep clips organised in collections, or push finished clips to connected social accounts without leaving the chat.
Requirements
Runs locally via npx, so Node.js 20+ and npm are needed. Requires an OpusClip API key supplied as OPUS_API_KEY (or set through the host's connector settings). Optional variables set timeouts and the MCP_WORKSPACE_PATH folder used for uploads and downloads; network access to the OpusClip API and Google Cloud Storage is required.
Before you install
The API key is a credential; the server asks that it be configured in host settings rather than pasted into chat. Several tools are marked destructive: creating projects, uploading, sharing projects publicly, censor jobs, collection creation and deletion, and publishing or scheduling posts. Publishing to X costs 1 credit per post, and scheduled posts cannot be cancelled after their publish time. Uploaded videos and clip data go to OpusClip and Google Cloud Storage.

Installation

In SourceWeft

  1. Open OpusClip in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@mindstone/mcp-server-opus-video-clip

[License: FSL-1.1-MIT]

OpusClip MCP server for Model Context Protocol hosts. Turn long-form videos into short clips, manage projects, collections, censor jobs, and scheduled social posts through the OpusClip API.

Requirements

One-click install

[Add to Cursor] [Add to VS Code] [Add to VS Code Insiders]

After clicking the button, your host will prompt you to fill: OPUS_API_KEY, OPUS_API_TIMEOUT_MS, OPUS_UPLOAD_TIMEOUT_MS, OPUS_BRIDGE_TIMEOUT_MS.

Manual config for Claude Desktop / Claude Code / Goose / Continue.dev (OpusClip)
json
{  "mcpServers": {    "OpusClip": {      "command": "npx",      "args": [        "-y",        "@mindstone/mcp-server-opus-video-clip"      ],      "env": {        "OPUS_API_KEY": "",        "OPUS_API_TIMEOUT_MS": "120000",        "OPUS_UPLOAD_TIMEOUT_MS": "600000",        "OPUS_BRIDGE_TIMEOUT_MS": "30000"      }    }  }}

Quick Start

Install & build

bash
cd <path-to-repo>/connectors/opus-video-clipnpm installnpm run build

npx (once published)

bash
npx -y @mindstone/mcp-server-opus-video-clip

Local

bash
node dist/index.js

Configuration

Environment variables

  • OPUS_API_KEY — OpusClip API key
  • MCP_HOST_BRIDGE_STATE — optional path to a host bridge state file used for credential management
  • MINDSTONE_REBEL_BRIDGE_STATE — backwards-compatible alias for MCP_HOST_BRIDGE_STATE
  • OPUS_API_TIMEOUT_MS — outbound HTTP timeout for general Opus API calls (default 120000 ms, max 30 min)
  • OPUS_UPLOAD_TIMEOUT_MS — per-chunk HTTP timeout for GCS resumable upload (default 600000 ms, max 30 min)
  • OPUS_BRIDGE_TIMEOUT_MS — HTTP timeout for the optional host-app bridge (default 30000 ms, max 30 min)
  • MCP_WORKSPACE_PATH — workspace directory for local-file access (see below)

Local-file sandbox and input permissions

opus_download_clip writes are confined to a workspace sandbox: MCP_WORKSPACE_PATH when set, otherwise the system temp directory. Paths outside the sandbox — including .. traversal and symlinks that escape it — are refused. For standalone clients, including clients that do not negotiate files/readModes version 1, opus_upload_video reads follow these same restrictions: place source videos inside the workspace (or temp) directory before uploading. With negotiated version 1, the host selects a mode for each call: in central mode, input reads use only the host-authorized canonical path described under Host-authorized local inputs; in standalone mode, the standalone restrictions apply. In every mode, pick download targets inside the workspace (or temp) directory.

Host configuration examples

Claude Desktop / Cursor

json
{  "mcpServers": {    "OpusClip": {      "command": "npx",      "args": ["-y", "@mindstone/mcp-server-opus-video-clip"],      "env": {        "OPUS_API_KEY": "your-api-key"      }    }  }}

Local development (no npm publish needed)

json
{  "mcpServers": {    "OpusClip": {      "command": "node",      "args": ["<path-to-repo>/connectors/opus-video-clip/dist/index.js"],      "env": {        "OPUS_API_KEY": "your-api-key"      }    }  }}

Tools (22)

Configuration

  • configure_opus_api_key — Configure the OpusClip API key

Brand templates

  • opus_get_brand_templates — List brand templates

Project lifecycle

  • opus_create_project — Submit a long-form video URL for clipping (marked destructive)
  • opus_get_project — Retrieve a project's status, metadata, and clips
  • opus_get_clips — Retrieve clips generated for a project (surfaces pagination metadata: total/next/limit)
  • opus_share_project — Update a project's sharing visibility (marked destructive)

Upload

  • opus_upload_video — Upload a local video file and create a clip project (orchestrates the 4-step GCS resumable upload; standalone-mode reads confined to the workspace sandbox, central-mode reads use only the host-authorized canonical path; marked destructive)

Downloads

  • opus_download_clip — Download an exported clip MP4 to a local file inside the workspace sandbox. Only OpusClip CDN / Google Cloud Storage hosts are accepted; hostnames are DNS-resolved and every resolved address must be public

Censor jobs

  • opus_create_censor_job — Create a censor job for a clip (marked destructive)
  • opus_get_censor_job_status — Poll the status of a censor job

Collections

  • opus_create_collection — Create a clip collection (marked destructive)
  • opus_get_collections — List your collections
  • opus_export_collection — Export all clips from a collection
  • opus_delete_collection — Delete a collection (clips themselves are preserved)

Collection contents

  • opus_add_clip_to_collection — Add a clip to an existing collection
  • opus_remove_clip_from_collection — Remove a clip from a collection (uses Opus's POST-to-delete idiom)

Social posting

  • opus_get_social_accounts — List connected social accounts
  • opus_create_social_copy_job — Generate platform-specific social copy for a clip
  • opus_get_social_copy_job — Retrieve the result of a social-copy job
  • opus_publish_post — Publish a clip to a connected social account immediately (marked destructive)
  • opus_schedule_post — Schedule a clip for future publishing (marked destructive)
  • opus_cancel_scheduled_post — Cancel a scheduled social post

External text returned by the Opus API (project/clip titles, template and collection names, social account display names, generated social copy, upstream error strings and error bodies, job statuses, and continuation tokens) is wrapped in <untrusted-content> envelopes so the model treats it as data, not instructions.

Licence

FSL-1.1-MIT — Functional Source License, Version 1.1, with MIT future licence. The software converts to MIT licence on 2030-05-19.

Host-authorized local inputs

files/readModes version 1 is an experimental extension used by these connectors, not part of the MCP standard. A compatible host (the app running the connector) decides which input files a tool call may read. The connector opens only the host-approved physical path, after resolving symlinks. The host supplies this permission information with each call; it is not a tool argument you need to set. Missing or invalid permission information, or a file absent from the approved list, stops the read.

Clients that do not negotiate this extension keep the connector's existing standalone file restrictions. This extension changes input-read permissions; existing output destinations, upload formats, size limits and file checks apply.

Source: connectors/opus-video-clip/README.md at commit d908148

Tools

22

configure_opus_api_key

Host-managed setup only. The user adds the OpusClip API key in Settings → Connectors in the app. Do not ask for or accept the key in chat. HOW USER GETS THEIR KEY: go to https://app.opus.pro/settings/integration-tokens and create a new token. After configuring, all other opus_* tools will work immediately.

Parametersapi_keyrequired

opus_get_brand_templates

List the OpusClip brand templates available to your organisation. Brand templates control captions, fonts, colours, intro/outro cards, and other styling. Use a brand_template_id from this response with opus_create_project or opus_upload_video. NOTE: The Opus API requires the `q` parameter to equal "mine" — calling the endpoint without it returns an empty body. The schema below makes the only legal value compile-time enforced.

Parametersq

opus_create_project

Create a new OpusClip clipping project from a publicly importable long-form video URL. After this returns a projectId, poll opus_get_project to track stage progression (PENDING → QUEUED → IMPORT → CURATE → REFINE → RENDER → UPLOAD → COMPLETE). When complete, call opus_get_clips to retrieve the generated clips. For local files, use opus_upload_video instead — it handles upload-link generation, GCS resumable upload, and project creation in a single tool call.

ParametersvideoUrlrequiredimportPrefrenderPrefcurationPrefbrandTemplateIdconclusionActionsuploadedVideoAttr

opus_get_project

Retrieve the current status and metadata of an OpusClip project. Check the `stage` field — when it reaches "COMPLETE" the clips are ready (use opus_get_clips). If `stage` is "STALLED" or `error` is set, the project has failed.

ParametersprojectIdrequired

opus_get_clips

List the exportable clips for a given project or collection. Each clip has a full-clip id of the form `{projectId}.{curationId}`, plus preview/export URLs (`uriForPreview`, `uriForExport`) on Google Cloud Storage. Choose `q: "findByProjectId"` and pass `projectId`, OR `q: "findByCollectionId"` and pass `collectionId`. Pagination via `pageNum` (starts at 1) and `pageSize`; the response echoes pagination inputs and surfaces upstream `total`/`next`/`limit` continuation metadata when available, so a truncated page is distinguishable from a complete list.

Takes no parameters.

opus_share_project

Update the sharing visibility of an OpusClip project. `DEFAULT`: team members can open / edit / export. `PUBLIC`: anyone with the link can open / edit / export.

ParametersprojectIdrequiredvisibilityrequired

opus_upload_video

Upload a local video file to OpusClip and create a clipping project in a single step. Orchestrates the 4-step Opus / Google Cloud Storage resumable upload: (1) request an upload link, (2) start a GCS resumable session, (3) PUT the video bytes (with automatic offset-query recovery on ambiguous failures), (4) create the project. Pass `file_path` as an absolute filesystem path. Optional `brandTemplateId`, `curationPref`, `renderPref`, `importPref`, `uploadedVideoAttr`, and `conclusionActions` are forwarded to `opus_create_project`. This tool is NOT idempotent: every invocation uploads the file and creates a NEW, potentially billable project — do not call it twice for the same source video. Per-chunk upload timeout is OPUS_UPLOAD_TIMEOUT_MS (default 600s).

Parametersfile_pathrequiredimportPrefrenderPrefcurationPrefbrandTemplateIdconclusionActionsuploadedVideoAttr

opus_create_censor_job

Create a censor job that processes a specific clip and bleeps / mutes profanity. Returns a jobId. Poll opus_get_censor_job_status until status is "CONCLUDED" (success) or "FAILED". Set `options.beepSound: true` to substitute a beep for censored words; default is to mute them.

ParametersclipIdrequiredoptionsprojectIdrequired

opus_get_censor_job_status

Poll the status of an OpusClip censor job. Status values: "QUEUED" / "PROCESSING" (still running, poll again), "CONCLUDED" (success), "FAILED" (check error), "UNKNOWN" (Opus could not determine the state — surfaced as UPSTREAM_STATUS_UNKNOWN). The response includes `next_poll_after_seconds` honouring Retry-After when present.

ParametersjobIdrequiredattempt

opus_create_collection

Create a new clip collection to organise your clips. Returns the new collectionId. Use opus_add_clip_to_collection to populate it.

ParameterscollectionNamerequired

opus_get_collections

List your OpusClip collections. Use `q: "mine"` to list all collections on your account, or `q: "findByContentId"` (with `contentId` set to a full clip id like "{projectId}.{curationId}") to find which collections contain a specific clip.

Takes no parameters.

opus_export_collection

Export all clips from a collection. Returns a `contentList` of `{ contentId, uriForExport }` pairs — the uriForExport URLs are Google Cloud Storage download links for the clip MP4s.

ParameterscollectionIdrequired

opus_delete_collection

Delete a clip collection. IMPORTANT: only the collection container is deleted — the clips themselves are preserved and still accessible via opus_get_clips with `q: "findByProjectId"`.

ParameterscollectionIdrequired

opus_add_clip_to_collection

Add a clip to an existing collection. `contentId` is the full clip ID in the form `{projectId}.{curationId}` (e.g. "Q20107035eDq.CU0b92e6") — get it from opus_get_clips.

ParameterscontentIdrequiredcollectionIdrequired

opus_remove_clip_from_collection

Remove a clip from a collection. IMPORTANT: Opus exposes this operation as a POST to /api/collection-contents/delete-collection-contents (NOT a DELETE). The clip itself is not deleted — only the collection membership is removed.

ParameterscontentIdrequiredcollectionIdrequired

opus_download_clip

Download an exported clip MP4 to a local file. Pass a `uriForExport` URL from opus_get_clips or opus_export_collection. Only OpusClip CDN / Google Cloud Storage hosts are accepted; hostnames are DNS-resolved and every resolved address must be public. output_path MUST live inside the workspace sandbox (MCP_WORKSPACE_PATH when set, otherwise the system temp directory); paths outside it, `..` traversal, and symlinked targets are refused. By default, refuses to overwrite an existing file — pass overwrite: true to clobber. Overwrites are staged to a temporary sibling file and moved into place only after the download succeeds, so a failed download leaves the existing file untouched.

Parametersurlrequiredoverwriteoutput_pathrequired

opus_get_social_accounts

List the social accounts connected to your Opus organisation. Returns `postAccountId`, `subAccountId` (where applicable), `platform`, and the platform-side `extUser*` identifiers. Use these IDs with opus_publish_post, opus_schedule_post, and opus_create_social_copy_job.

Parametersq

opus_create_social_copy_job

Create an asynchronous social-copy generation job. Opus produces a platform-specific title, description, and hashtags for a clip + destination account. Returns a jobId — poll opus_get_social_copy_job until status is "COMPLETED" or "FAILED".

ParametersclipIdrequiredpromptprojectIdrequiredsubAccountIdrequiredpostAccountIdrequiredforceRegenerate

opus_get_social_copy_job

Poll the status and result of a social-copy generation job. Status values: "RUNNING" (still generating), "COMPLETED" (returns title/description/hashtags), "FAILED". Includes `next_poll_after_seconds` honouring Retry-After.

ParametersjobIdrequiredattempt

opus_publish_post

Publish a clip immediately to a connected social account. For X (formerly Twitter) each post costs 1 credit. Returns a `postId`. The clip is queued for upload by Opus to the destination platform.

ParametersclipIdrequiredprojectIdrequiredpostDetailrequiredsubAccountIdpostAccountIdrequired

opus_schedule_post

Schedule a clip for future publishing. `publishAt` must be a future UTC ISO 8601 timestamp (e.g. "2026-06-01T16:00:00.000Z"). For X (formerly Twitter) each post costs 1 credit. Returns a `scheduleId` you can pass to opus_cancel_scheduled_post.

ParametersclipIdrequiredprojectIdrequiredpublishAtrequiredpostDetailrequiredsubAccountIdpostAccountIdrequired

opus_cancel_scheduled_post

Cancel a scheduled social post BEFORE its publishAt time. After publishAt the post is irrevocably handed to the platform — cancellation is no longer possible.

ParametersscheduleIdrequired

Version history

2
  1. v0.3.0LatestNov 16, 2026
  2. v0.2.1Sep 16, 2026

Score

80% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.