The farm, API-first.

One key turns any script or AI agent into a clipping machine: send a VOD, get back ranked vertical clips. Same engine, same queue, same quality as the dashboard.

Get a key

Sign in at app.clip-farm.com, open Settings → API keys, and create one. The key is shown once — copy it immediately. Keys act as your account: they spend your VOD hours, so share them only with agents you trust, and revoke them from the same screen when you are done.

Authenticate

Every request carries the key as a bearer token. Base URL is https://tzjihxghiwzvliolpghm.supabase.co/functions/v1:

Authorization: Bearer cfk_YOUR_KEY

Errors come back as { "error": code, "message": ... } — 401 invalid_api_key for a bad or revoked key, 402 insufficient_credits when the hours run out, 429 when you hit the creation rate limits.

Endpoints

GET /me

Who the key belongs to.

GET /balance

VOD-seconds remaining. Jobs are billed in VOD-seconds.

GET /plan

Plan tier and caps (max VOD length, max source resolution).

POST /twitch/inspect

Body { "vod_url" }. Duration, game, and platform metadata before you submit.

POST /jobs

Body { "vod_url", "game"? }. Creates a clip job. 201 { job, queue_position }. Debits VOD-seconds; 402 insufficient_credits when the balance is short.

GET /jobs

Your recent jobs with status and progress.

GET /jobs/:id

One job plus its clip results as they land.

POST /jobs/:id/cancel

Cancels a queued/running job; refunds the unprocessed share.

GET /results?job_id=

Clips for a job: score, captions, transcript, storage_key, thumbnail_key.

POST /media/sign

Body { "keys": [storage_key, ...] } → { urls }. 15-minute download URLs for your clips.

GET /live · POST /live/start · POST /live/:id/stop

Live-watch sessions that clip a stream in near-real-time.

VOD to clips in three calls

# 1. create a job (game is auto-detected for Twitch; required for YouTube)
curl -X POST https://tzjihxghiwzvliolpghm.supabase.co/functions/v1/jobs \
  -H "Authorization: Bearer cfk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vod_url": "https://www.twitch.tv/videos/123456789", "game": "cod"}'

# 2. poll until status is "done" (results appear as they are cut)
curl https://tzjihxghiwzvliolpghm.supabase.co/functions/v1/jobs/JOB_ID \
  -H "Authorization: Bearer cfk_YOUR_KEY"

# 3. sign download URLs for the clips you want
curl -X POST https://tzjihxghiwzvliolpghm.supabase.co/functions/v1/media/sign \
  -H "Authorization: Bearer cfk_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys": ["u/.../j/.../clip_01.mp4"]}'

Use it from Claude

Clip Farm ships a native MCP connector for the Claude desktop app, so Claude can clip for you without leaving the conversation — no curl, no agent brief. Connect once and Claude gets 61 tools covering the whole farm: Content Rewards discovery and campaign creation, VOD clipping and moment search, live sessions, the clip library and reviews, MemeCut, publishing drafts, and your credits.

Before you connect: the Claude desktop app (macOS or Windows), signed in, and a Clip Farm account — sign in with Google at app.clip-farm.com.

Connect, once:

In Claude, open Settings → Connectors → Add custom connector.
Name it Clip Farm and paste the MCP URL:

Connector name: Clip Farm
Connector URL:  https://app.clip-farm.com/mcp

Claude opens the Clip Farm consent screen. Sign in, approve the account shown, done. Approving mints a dedicated key named Claude connector · <date> — revoke it any time in Settings → API keys.
When we ship connector updates, pull them in with Settings → Connectors → Clip Farm → ⋯ → Refresh tools list.

Scripts and other MCP clients can call the same endpoint with a bearer key instead of OAuth: Authorization: Bearer cfk_YOUR_KEY.

First prompts to try

"What can I do with Clip Farm here?"
"Show the highest-paying Content Rewards campaigns."
"Clip this VOD up: <twitch VOD url>"
"Find the moment chat lost it in this VOD: <url>"
"Open MemeCut."
"Show my clip library."
"How many Clip Farm credits do I have left?"

Ask Claude to clip a VOD and it inspects the link first (free), shows you a credit quote, and only starts the job when you say go.

How it behaves

One panel, not fifty

open_clipfarm is the only tool that opens the embedded workspace panel — home, create, jobs, live, library, MemeCut, settings, the free file editors. Every other tool answers with data right in the chat, so lookups never stack panels.

Quotes before spend

Billable actions — clip jobs, campaign content, Farm runs, MemeCut renders, link conversions, VOD moment exports — show a credit quote and wait for your yes. Inspecting a VOD is always free.

Nothing publishes itself

Publishing creates drafts. Scheduling a post or posting right now needs your explicit approval, every time.

Credits count seconds

Jobs bill in seconds of source video. Ask "How many Clip Farm credits do I have left?" any time.

Changed your mind?

Cancel a queued or running job and the unprocessed share of the quote is refunded.

Download links expire

Clips come back as signed URLs that live for 15 minutes. If one lapses, just ask again for a fresh link.

What’s inside

Content Rewards discovery and campaign creation · VOD clipping for Twitch, YouTube and Kick (auto or manual-only, portrait or landscape) · live clipping with your secret word · VOD moment search and export · clip library and review queue · MemeCut meme overlays · free in-browser file tools (cutter, crop, compressor, MP3, audio balancer, speech enhancer) · link converter (9:16 and 4:5) · publishing drafts via Postiz · clip alerts · billing and ledger. Everything runs against the same services and account permissions as the website.

Troubleshooting

Tools look missing or stale

Claude → Settings → Connectors → Clip Farm → ⋯ → Refresh tools list. Do this after we ship a connector update.

The panel looks stale

Hit the Refresh button in the panel header — it reloads the embedded workspace, not your chat.

Billing, OAuth providers, Kick linking

Those stay on the website. Checkout and external account authorization open on app.clip-farm.com (Settings), never inside the chat.

Hand it to an agent

Paste this brief plus your key into any AI agent (Claude, Cursor, a Discord bot, your own scripts) and it can clip for you:

You can create TikTok-ready clips from Twitch, YouTube, and Kick VODs
using the Clip Farm API.
Base URL: https://tzjihxghiwzvliolpghm.supabase.co/functions/v1
Auth: send "Authorization: Bearer cfk_YOUR_KEY" on every request.
Flow: POST /jobs {"vod_url", "game"?} -> poll GET /jobs/:id until status is
"done" -> GET /results?job_id=:id -> POST /media/sign {"keys":[storage_key]}
to get download URLs. Check GET /balance first; jobs cost the VOD's length in
seconds. Trained games: cod, bo7, souls, minecraft, overwatch, lol, valorant,
fortnite, palworld, poe, gta5, cs2.

Plan caps, credit billing, and the 6-jobs-per-hour creation limit apply to keys exactly as they do in the dashboard.