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:

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

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

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.

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