ClipSpeed — clip it, plan it, post it
ClipSpeed is the scheduler whose agent also makes the content. One account, one clipspeed CLI (or the
same tools over MCP at https://api.clipspeed.ai/mcp): cut a video or a live stream into scored,
captioned clips, then plan and book posts — your own words, images, videos or those clips — on the
user's connected channels. The server holds the rules (the account's daily limits, spacing, each
platform's text limits and good hours), so you never have to.
Install: npm i -g clipspeed-mcp (gives clipspeed), then clipspeed auth:key csai_live_… or
export CLIPSPEED_API_KEY=csai_live_…. Keys: https://www.clipspeed.ai/dashboard/api-key/ (paid plan or the $1 trial).
Hard rules
- Show before you book. For anything with more than one post, run
plan(orposts:create … --preview) first, show the user the slots in their time zone, and book only after they say yes. The server never moves a time the user picked: a slot that breaks the rules is refused with the reason and the next open time. - Check the channel first.
clipspeed channels:listsays what is connected and what each platform takes (text / image / video) and its limits. Do not compose a text post for YouTube or TikTok; do not exceed X's 280 (a link counts as 23), Threads 500, Bluesky 300, LinkedIn 3,000. If a channel is missing,clipspeed channels:connect <platform>returns a 10-minute link for the user to open — you cannot sign in for them, and ClipSpeed never sees platform passwords. - Your words post word for word. A text/image/video post you write is published verbatim (hashtags you pass are appended). Write it as it should appear.
- Media is a public https URL (JPG/PNG/WebP/GIF up to 25 MB, MP4/MOV/WebM up to 1 GB) or a ClipSpeed clip id. Local files: upload them somewhere public first, or clip through ClipSpeed.
- Same words = same post. Re-running a command with identical content on the same platform is refused as a duplicate, so a retry never double-posts. Change the text to post again.
- Never promise more posting than the rules allow. ClipSpeed's limits are the same for every kind of post and
protect the account from being flagged: at most 4 posts a day per platform (2 on LinkedIn and LinkedIn Pages),
spaced YouTube/Instagram 4 h, TikTok/X/Facebook 2 h, Threads/Bluesky 1 h, LinkedIn 4 h; the same words or the same
file never go to one account twice within 30 days.
channels:listgives each platform's numbers — quote them. - Report what the command returned — the post ids, local times, refusals and their next open slot.
Never claim a post went out:
posts:listshows status and the public link once the platform issued an id.
The standard flows
A link → clips → a week of posts (the full loop)
clipspeed clip <video-url> --style karaoke→ ajob_id/ project id.clipspeed status <job_id>every ~60 s untilcompleted(clips are final whenhasCaptionsis true).clipspeed plan --project <project-id> --days 7→ the plan, per day, in the user's time zone. Show it.- On yes:
clipspeed plan --project <project-id> --days 7 --approve→ booked posts with ids.
A post the user dictated
clipspeed posts:create -p x,linkedin -c "Shipping agentic scheduling today." --at 2026-12-01T14:00:00Z --previewclipspeed posts:create -p x,linkedin -c "The long LinkedIn version…" --x-text "The short X version" --preview(one post, its own copy on X; each platform is checked against its own limit) then the same without--preview. Omit--atto post as soon as the account's spacing allows (the answer says when).--media <url>for an image/video;--clip <clip-id>for a ClipSpeed clip;--titlewhere the platform has one (YouTube requires it);--privacy unlistedfor YouTube.
Manage the calendar
clipspeed posts:list [--status scheduled] [--platform x]·clipspeed posts:update <id> -c "new copy"(only before it starts sending; the time never changes) ·clipspeed posts:cancel <id>·clipspeed analytics <id>.
Ideas — clipspeed discover "<niche>" ranks fast-growing recent videos to clip.
Quick reference
| Command | Does | Key flags |
|---|---|---|
channels:list | connected channels, what each takes, limits, the account time zone | |
channels:connect <platform> | 10-minute connect link for the user | |
settings <platform> | the rules for one platform | |
posts:create | book one post on one or more platforms; adjust it per channel with --x-text, --linkedin-text, --youtube-title … or --per-platform '<json>' | -p -c --media --carousel (comma list, in order) --type story + --stories a,b (Instagram / Facebook Page stories, in order, no caption) --clip --at --title --hashtags --privacy --preview --<platform>-text --per-platform |
plan | lay a project's clips over the next days; --approve books | --project --clips -p --days --preset steady|balanced|beast |
posts:list / posts:update / posts:cancel / analytics | the calendar | --status --platform |
clip <url> / status <job> / clips / download <job> | clipping | --style --aspect --count |
discover "<niche>" / usage | ideas, balance |
Add --json to any command for machine-readable output. Errors come back as plain sentences from the server (plan required, not connected, text too long, day full with the next open time) — pass them on unchanged.