OpenShorts.io

Turn long YouTube, TikTok, Instagram or Facebook videos into captioned vertical Shorts from Claude, Cursor or any MCP client.

Hosted MCP Server

npx add-mcp 'https://openshorts.io/api/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

Get an API key

Sign in, open Settings → API keys and create a key. It starts with os_ and is shown once, so store it like a password. A key acts as your account: anything it starts uses your minutes, and deleting the key stops it at once.

02

Use it from Claude, Cursor or any MCP client

Pick your client and copy the config. Replace os_your_key with your key. Supported: Claude Code, Codex, Cursor, Antigravity, VS Code (Copilot), Gemini CLI, Windsurf, Grok through the xAI API, and Claude Desktop through the mcp-remote bridge. Any other client that can send an Authorization header to a Streamable HTTP server works the same way.

Run in a terminal

claude mcp add --transport http openshorts https://openshorts.io/api/mcp --header "Authorization: Bearer os_your_key"

ChatGPT connectors currently expect OAuth sign-in rather than a key, so ChatGPT is not supported yet.

03

Tools

ToolWhat it doesArguments
clip_videoStarts a job for one YouTube video. Returns a job id.url; caption_style, aspect_ratio (optional)
get_jobStatus and progress. When done: each clip’s title, score, reason, hook line, TikTok and Instagram captions, and download links valid for one hour.job_id
list_jobsYour most recent jobs, newest first.limit (1–30)
get_usagePlan, minutes left this month and minutes left in packs.—

Caption styles: default (big uppercase, coral active word), hormozi (words appear as they are spoken), pill (solid box behind the active word), lime (bright green active word box), oneword (one big word at a time), clean (sentence case, soft shadow).

04

A typical run

Ask your assistant something like “clip this podcast into Shorts with pill captions” and paste the link. It calls clip_video, gets a job id, and checks back with get_job. Processing usually takes 10 to 20 minutes for a typical video; the job page on the site shows the same job live.

When the status is done, the assistant has every clip with its score and reason, so it can pick the strongest, download it, and draft the post from the suggested captions.

05

What the video clipping API returns

Every tool answers with a JSON object, both as text and as structuredContent, so an assistant can read it and a script can parse it. clip_video returns job_id, status (queued) and job_url, the same job page you see in the browser.

get_job returns status (queued, fetching, transcribing, selecting, rendering, done or failed), progress from 0 to 100, charged_minutes, a plain-English failure when it failed, and a clips array. Each clip has title, score (0–100), reason, hook, start_seconds, end_seconds, tiktok_caption, instagram_caption, video_url and poster_url (signed links valid for one hour; call get_job again for fresh ones) and expires_at, when the clip is deleted under your plan's retention.

A video longer than your plan or your minutes left is not refused: the start of it is clipped up to what you can use, and the job page says so.

06

Video clipping API limits and quotas

API jobs follow your plan, exactly like jobs started in the browser: the same monthly minutes, longest video per job, watermark rule and number of videos processing at once. When the monthly minutes run out, minutes from a pack are used next; see pricing.

Each key may make up to 120 requests a minute, which leaves plenty of room for polling a job every few seconds. Over the limit, the server answers HTTP 429 with a Retry-After header; wait and retry. A single batch request may hold up to 20 calls.

07

Errors

WhenHTTPJSON-RPC codeWhat to do
Missing or invalid API key401-32001Create a key in Settings → API & MCP and send it as a Bearer token
Over 120 requests a minute429-32029Wait for Retry-After, then retry
Body is not JSON400-32700Send a JSON-RPC 2.0 request
Not JSON-RPC 2.0, or batch over 20400 / 200-32600Fix the request shape
Unknown method200-32601Use initialize, tools/list, tools/call or ping
tools/call without a tool name200-32602Pass params.name

A tool that runs but cannot do the job answers normally with isError: true and a sentence to show the user, for example a link that is not one YouTube video, a video still processing, or no minutes left this month.

08

Hosted or self-hosted

The open source build ships its own MCP server, REST API and CLI, unmetered and without a key, if you run it on your own machine. The self-host guide covers that setup. The hosted server here needs no install and no GPU.

09

Video clipping API questions

Is there an OpenShorts API?

Yes. OpenShorts.io runs a hosted MCP server at /api/mcp. Create a personal API key in your account settings and any MCP client can submit videos and collect the clips.

What does a video clipping API call cost?

Calls are free; clipping uses minutes from your plan, measured on the length of the source video. A 30-minute video uses 30 minutes. If processing fails, the minutes are returned.

Does it work with Claude Desktop?

Claude Desktop connects to remote servers through a bridge that can send a header, such as mcp-remote. Claude Code and Cursor send the header directly.

Can I upload a file through the API?

Not yet. The hosted tools take YouTube links. To clip a local file, upload it in the workspace, or run the open source build, whose API accepts uploads.

Is this an alternative to the Opus Clip API?

It covers the same core job, turning one long video into captioned vertical clips, through MCP tools with a personal key and no sales call. Compare the outputs on your own footage before you switch.