{
  "markdown": "# clipspeed-mcp\n\nTurn any video **or live stream** into scored, captioned, ready-to-post vertical clips — right inside **Claude**, **Cursor**, **Cline**, or **Windsurf**.\n\n[ClipSpeedAI](https://www.clipspeed.ai) ships **two MCP transports**, and they expose **different tools**:\n\n| | Hosted (remote) | This npm package (local) |\n|---|---|---|\n| Transport | `streamable-http` at `https://api.clipspeed.ai/mcp` | stdio |\n| Auth | **OAuth — one click, no API key** | `CLIPSPEED_API_KEY` |\n| Install | none | `npx clipspeed-mcp` |\n| **Clip a LIVE stream while it airs** | **yes** — `clip_livestream`, `check_livestream`, `extend_livestream`, `stop_livestream` | **no** |\n| Save .mp4s to your disk | no | **yes** — `download_clip` |\n| Schedule posts | via `publish_to_youtube` | `schedule_post` (5 platforms) |\n\n**Most people want the hosted server** — it needs no install, no API key, and it is the only one\nthat can clip a stream that is still running. Use this npm package when you specifically need\nfinished files written to your local disk.\n\nRequires a ClipSpeedAI **paid plan or the $1 trial**. For the npm package, get your key at\n**https://www.clipspeed.ai/dashboard/api-key/** — keys look like `csai_live_...`.\n\n> **Always pin `clipspeed-mcp@1.0.1`.** Pinning keeps a bad publish from silently upgrading your setup.\n\n---\n\n## Install\n\n### Claude Desktop (one command)\n\n```bash\nnpx clipspeed-mcp@1.0.1 install\n```\n\nIt prompts for your API key and writes the `clipspeed` server into your Claude Desktop config for you. You can also pass the key directly:\n\n```bash\nnpx clipspeed-mcp@1.0.1 install --key csai_live_your_key\n```\n\nThen **quit and reopen Claude Desktop.**\n\n### Claude Code\n\n```bash\nclaude mcp add clipspeed -- npx -y clipspeed-mcp@1.0.1\nexport CLIPSPEED_API_KEY=csai_live_your_key\n```\n\n### Cursor / Cline / Windsurf\n\nAdd this to your MCP servers config (`~/.cursor/mcp.json`, Cline's MCP settings, or Windsurf's `mcp_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"clipspeed\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"clipspeed-mcp@1.0.1\"],\n      \"env\": { \"CLIPSPEED_API_KEY\": \"csai_live_your_key\" }\n    }\n  }\n}\n```\n\n### Hosted (no install, no API key) — recommended\n\nThe hosted server authenticates with **OAuth**, so there is no key to copy and nothing to install:\n\n```bash\nclaude mcp add --transport http clipspeed https://api.clipspeed.ai/mcp\n```\n\nYour client opens a browser once, you approve, and it is connected. In **claude.ai** or\n**ChatGPT**, add it as a custom connector with the same URL.\n\n**Hosted tools** (10):\n\n| Tool | Does |\n|---|---|\n| `submit_to_clipspeed` | Video URL → a clip job. |\n| `check_clips` | Poll a job → finished clips with viral scores. |\n| **`clip_livestream`** | **Attach to a stream that is STILL LIVE and cut clips while it airs.** |\n| **`check_livestream`** | Clips produced so far from a live session. |\n| **`extend_livestream`** | Keep clipping past the original window. |\n| **`stop_livestream`** | End the live session. |\n| `discover_trending` | Fastest-growing recent video in a niche. |\n| `list_templates` | Available caption/layout templates. |\n| `creator_pack` | Titles, hooks and hashtags for a finished clip. |\n| `publish_to_youtube` | Publish a finished clip to YouTube. |\n\nThe four livestream tools exist **only** on the hosted server. If you want to clip a Twitch,\nKick or YouTube stream while it is running, use the hosted transport — the npm package cannot\ndo it. Conversely, only the npm package can write .mp4 files to your local disk.\n\n---\n\n## Environment\n\n| Var | Required | Default | Notes |\n|---|---|---|---|\n| `CLIPSPEED_API_KEY` | yes (to serve) | — | Your personal `csai_live_` key. |\n| `CLIPSPEED_BASE_URL` | no | `https://api.clipspeed.ai` | Override for testing. |\n\nNode **>= 18** (uses global `fetch`).\n\n---\n\n## Tools (npm package / local stdio)\n\nThese are the tools **this package** exposes. For the hosted server's tool set — including the\nfour livestream tools — see [Hosted](#hosted-no-install-no-api-key--recommended) above.\n\n| Tool | Does |\n|---|---|\n| `clip_video` | Video URL → a clip job (`job_id`). Options: `aspect_ratio`, `caption_style`, `clip_count`, `platform`. |\n| `get_clip_status` | Poll a `job_id` → status + finished clips (title, viral_score, duration, video_url). |\n| `list_clips` | List your recent clip jobs to find a past `job_id`. |\n| `download_clip` | **Save the .mp4 files to `~/Downloads`** — all clips, or one by `clip_index`. Skips files > 500MB. |\n| `get_usage` | Credits remaining / total / used this month, plan, trial status. |\n| `discover_trending` | Find the fastest-growing recent video in a niche to clip. ClipSpeedAI's differentiator. |\n| `schedule_post` | Schedule a finished clip to tiktok / youtube / instagram / x / linkedin. |\n| `list_scheduled_posts` | Review scheduled / posted / failed posts. |\n| `cancel_scheduled_post` | Cancel a post that's still `scheduled`. |\n| `restyle_captions` | Re-caption a project in a new style without re-clipping. |\n\n**Caption styles:** `karaoke` (default), `hormozi`, `beasty`, `fire`, `youshaei`, `cinematic`, `bold`.\n**Aspect ratios:** `9:16` (default), `1:1`, `16:9`.\n\nTo let ClipSpeedAI **publish to your socials**, connect each platform in the ClipSpeedAI app first (Scheduler). `schedule_post` posts under those connections.\n\n---\n\n## The demo prompt\n\n> Clip this video into 9:16 shorts with Hormozi captions, then download the top 3 to my Downloads folder: https://youtu.be/…\n\nClaude runs `clip_video` → polls `get_clip_status` → `download_clip` → the .mp4s land in `~/Downloads`.\n\nA Claude **Skill** (`SKILL.md`) ships with this package — it teaches the outcome-first flow (find → clip → check → download → schedule).\n\n---\n\n## Security\n\n- Your API key is **never logged**. It only ever lands in your MCP client's config file (or your shell env).\n- **Never commit your key** or share it. Rotate it any time at https://www.clipspeed.ai/dashboard/api-key/.\n- Keys are tied to one account, rate-limited per plan, and hashed at rest on ClipSpeedAI's servers.\n\n## License\n\nMIT\n",
  "bytes": 6042,
  "sha": "b0500268691ff6c51d5064701e88f2d71669d39aea94ea84fc977a138489e00a",
  "repo_slug": "thestockgoatballs/clipspeed-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_thestockgoatballs_clipspeed_mc_549bf27b/readme"
}