clipspeed-mcp

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.

Install

Claude Desktop (one command)

npx clipspeed-mcp@1.0.1 install

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:

npx clipspeed-mcp@1.0.1 install --key csai_live_your_key

Then quit and reopen Claude Desktop.

Claude Code

claude mcp add clipspeed -- npx -y clipspeed-mcp@1.0.1
export CLIPSPEED_API_KEY=csai_live_your_key

Cursor / Cline / Windsurf

Add this to your MCP servers config (~/.cursor/mcp.json, Cline's MCP settings, or Windsurf's mcp_config.json):

{
  "mcpServers": {
    "clipspeed": {
      "command": "npx",
      "args": ["-y", "clipspeed-mcp@1.0.1"],
      "env": { "CLIPSPEED_API_KEY": "csai_live_your_key" }
    }
  }
}

Hosted (no install, no API key) — recommended

The hosted server authenticates with OAuth, so there is no key to copy and nothing to install:

claude mcp add --transport http clipspeed https://api.clipspeed.ai/mcp

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.

Environment

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).

Tools (npm package / local stdio)

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.

The demo prompt

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).

Security

Your API key is never logged. It only ever lands in your MCP client's config file (or your shell env).
Never commit your key or share it. Rotate it any time at https://www.clipspeed.ai/dashboard/api-key/.
Keys are tied to one account, rate-limited per plan, and hashed at rest on ClipSpeedAI's servers.

License

MIT

clipspeed mcp