clipspeed-mcp

Turn any video into scored, captioned, ready-to-post vertical clips — right inside Claude, Cursor, Cline, or Windsurf. clipspeed-mcp is a stdio MCP server that wraps the ClipSpeed public API with your personal API key, and (unlike a hosted MCP) can download the finished .mp4 clips straight to your ~/Downloads folder.

Requires a ClipSpeed paid plan or the $1 trial. 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)

Prefer a remote server with no local process? ClipSpeed also exposes a hosted MCP:

claude mcp add --transport http clipspeed https://api.clipspeed.ai/mcp \
  --header "Authorization: Bearer csai_live_your_key"

The hosted server can do everything except write files to your disk — use this local package if you want download_clip.

Related MCP server: podcli

Environment

Node >= 18 (uses global fetch).

Tools

Caption styles: karaoke (default), hormozi, beasty, fire, youshaei, cinematic, bold. Aspect ratios: 9:16 (default), 1:1, 16:9.

To let ClipSpeed publish to your socials, connect each platform in the ClipSpeed 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 ClipSpeed's servers.

License

MIT