clipbait

Official CLI + MCP server for Clipbait — the AI video clipping tool for streamers and clippers.

Let Claude (or any MCP-capable agent) turn long videos into viral vertical clips, check your credits, auto-clip live Twitch streams, and download finished clips to disk — on your Clipbait account. Also works as a plain terminal CLI.

Requires

• Node.js 18 or higher.
• A paid Clipbait account. Generate a key at app.clipbait.ai/me → Developers / API. Keys are prefixed cbk_live_.

Install

Fastest — one command (auto-configures Claude Code + Claude Desktop)

npx clipbait@latest

Opens Clipbait so you can copy your key, then installs a /clipbait slash command and wires the MCP server into Claude Code and Claude Desktop for you — no JSON to hand-write. Pass the key inline to skip the prompt: npx clipbait@latest cbk_live_yourkey. Restart Claude, then type /clipbait <video url>.

Claude Code

claude mcp add --transport http clipbait https://app.clipbait.ai/api/mcp --header "X-API-Key: cbk_live_your_key_here"

Cursor / Cline / Windsurf / manual

Drop this into the client's MCP config file (runs the local stdio server):

{
  "mcpServers": {
    "clipbait": {
      "command": "npx",
      "args": ["-y", "clipbait@latest", "mcp"],
      "env": { "CLIPBAIT_API_KEY": "cbk_live_your_key_here" }
    }
  }
}

ChatGPT / claude.ai take a remote URL instead of a local process — point them at https://app.clipbait.ai/api/mcp/<your_api_key> (nothing runs on your machine, nothing to update).

Tools

Seven tools are available to any agent:

| Tool | What it does | |---|---| | generate_clips | Start a clipping job (videoUrl, optional aspectRatio 9:16|16:9, maxClips 1–20). Returns a job id. | | get_job | Check a job's status and get finished clip URLs (jobId). | | list_recent_clips | List your recent jobs and clip counts. | | get_credits | Show credits remaining and your plan. No inputs. | | start_live_autoclip | Auto-clip a live Twitch stream continuously (channelUrl, optional cadenceMin). Pro plan. | | probe_video | Get a video's duration before clipping (url). | | download_clip | Save a finished clip to your ~/Downloads/ folder and return the path (jobId, clipIndex 1-based). Max 500 MB. | | list_social_accounts | Show connected accounts. Posting is X/Twitter only today (TikTok, Facebook, Instagram coming soon). | | schedule_post | Schedule a clip to post on X at a future time (clipUrl, platforms: ["x"], scheduledTime, caption). | | list_scheduled_posts / cancel_scheduled_post | Review or cancel scheduled posts. |

Terminal usage

npx clipbait login cbk_live_your_key
npx clipbait generate "https://youtube.com/watch?v=..." --aspect 9:16 --max 9
npx clipbait status <jobId>       # get finished clip URLs
npx clipbait jobs                 # list recent jobs
npx clipbait live "https://twitch.tv/somestreamer"
npx clipbait mcp                  # run the stdio MCP server (used in configs above)

Auth via the CLIPBAIT_API_KEY env var or ~/.clipbait.json.

Security

• Never commit your CLIPBAIT_API_KEY. Your agent's config file contains a secret — add it to .gitignore, or use a secrets manager (1Password CLI, direnv) instead of inline env vars.
• If you leak your key, rotate it at app.clipbait.ai/me immediately — the old key stops working at once.
• download_clip links are presigned and expire in ~1 hour. Save clips promptly.

Pricing

Requires a paid Clipbait account. Clip generation spends credits (1 credit ≈ 1 minute of source video). See clipbait.ai.

Links

• Clipbait: https://clipbait.ai
• API docs: https://app.clipbait.ai/docs
• Get an API key: https://app.clipbait.ai/me

License

MIT