The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Clipspeed MCP listing page.
Turn any video or live stream into scored, captioned, ready-to-post vertical clips — right inside Claude, Cursor, Cline, or Windsurf.
ClipSpeedAI ships two MCP transports, and they expose different tools:
| Hosted (remote) | This npm package (local) | |
|---|---|---|
| Transport | streamable-http at https://api.clipspeed.ai/mcp | stdio |
| Auth | OAuth — one click, no API key | CLIPSPEED_API_KEY |
| Install | none | npx clipspeed-mcp |
| Clip a LIVE stream while it airs | yes — clip_livestream, check_livestream, extend_livestream, stop_livestream | no |
| Save .mp4s to your disk | no | yes — download_clip |
| Schedule posts | via publish_to_youtube | schedule_post (5 platforms) |
Most people want the hosted server — it needs no install, no API key, and it is the only one that can clip a stream that is still running. Use this npm package when you specifically need finished files written to your local disk.
Requires a ClipSpeedAI paid plan or the $1 trial. For the npm package, get your key at
https://www.clipspeed.ai/dashboard/api-key/ — keys look like csai_live_....
Always pin
clipspeed-mcp@1.0.1. Pinning keeps a bad publish from silently upgrading your setup.
It prompts for your API key and writes the clipspeed server into your Claude Desktop config for you. You can also pass the key directly:
Then quit and reopen Claude Desktop.
Add this to your MCP servers config (~/.cursor/mcp.json, Cline's MCP settings, or Windsurf's mcp_config.json):
The hosted server authenticates with OAuth, so there is no key to copy and nothing to install:
Your client opens a browser once, you approve, and it is connected. In claude.ai or ChatGPT, add it as a custom connector with the same URL.
Hosted tools (10):
| Tool | Does |
|---|---|
submit_to_clipspeed | Video URL → a clip job. |
check_clips | Poll a job → finished clips with viral scores. |
clip_livestream | Attach to a stream that is STILL LIVE and cut clips while it airs. |
check_livestream | Clips produced so far from a live session. |
extend_livestream | Keep clipping past the original window. |
stop_livestream | End the live session. |
discover_trending | Fastest-growing recent video in a niche. |
list_templates | Available caption/layout templates. |
creator_pack | Titles, hooks and hashtags for a finished clip. |
publish_to_youtube | Publish a finished clip to YouTube. |
The four livestream tools exist only on the hosted server. If you want to clip a Twitch, Kick or YouTube stream while it is running, use the hosted transport — the npm package cannot do it. Conversely, only the npm package can write .mp4 files to your local disk.
| Var | Required | Default | Notes |
|---|---|---|---|
CLIPSPEED_API_KEY | yes (to serve) | — | Your personal csai_live_ key. |
CLIPSPEED_BASE_URL | no | https://api.clipspeed.ai | Override for testing. |
Node >= 18 (uses global fetch).
These are the tools this package exposes. For the hosted server's tool set — including the four livestream tools — see Hosted above.
| Tool | Does |
|---|---|
clip_video | Video URL → a clip job (job_id). Options: aspect_ratio, caption_style, clip_count, platform. |
get_clip_status | Poll a job_id → status + finished clips (title, viral_score, duration, video_url). |
list_clips | List your recent clip jobs to find a past job_id. |
download_clip | Save the .mp4 files to ~/Downloads — all clips, or one by clip_index. Skips files > 500MB. |
get_usage | Credits remaining / total / used this month, plan, trial status. |
discover_trending | Find the fastest-growing recent video in a niche to clip. ClipSpeedAI's differentiator. |
schedule_post | Schedule a finished clip to tiktok / youtube / instagram / x / linkedin. |
list_scheduled_posts | Review scheduled / posted / failed posts. |
cancel_scheduled_post | Cancel a post that's still scheduled. |
restyle_captions | Re-caption a project in a new style without re-clipping. |
Caption styles: karaoke (default), hormozi, beasty, fire, youshaei, cinematic, bold.
Aspect ratios: 9:16 (default), 1:1, 16:9.
To let ClipSpeedAI publish to your socials, connect each platform in the ClipSpeedAI app first (Scheduler). schedule_post posts under those connections.
Clip this video into 9:16 shorts with Hormozi captions, then download the top 3 to my Downloads folder: https://youtu.be/…
Claude runs clip_video → polls get_clip_status → download_clip → the .mp4s land in ~/Downloads.
A Claude Skill (SKILL.md) ships with this package — it teaches the outcome-first flow (find → clip → check → download → schedule).
MIT