clipspeed-mcp

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.

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

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. ClipSpeed'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 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