Variations MCP is the set of variations_ tools in the Creator OS hosted MCP server, backed by /v1/variations. You give it one finished video and it makes up to 20 distinct versions, one per account, each with its own hook, caption and hashtags written by Claude. The variations_post tool then posts each version to exactly one account.
finished video (mp4)
|
v
variations_ tool ---> /v1/variations
|
+-- v1 grade A hook 1 caption 1 ---> account @brand_a
+-- v2 grade B hook 2 caption 2 ---> account @brand_b
+-- v3 zoom hook 3 caption 3 ---> account @brand_c
| ... up to 20 ...
v
uniqueness check drops lookalikes
|
v
variations_post (publish guard: Proceed / Cancel)
|
v
one file, one caption, one cover per accountWhat is Variations MCP and what does it do
Variations answers a narrow question: how do you post the same video to a dozen accounts without every account getting the identical file?
You give it one finished vertical video. It produces up to 20 distinct versions and pairs each one with a different account. Every version keeps the content but changes the look and the copy:
- A colour grade, a zoom or a different fit.
- An on-screen hook with its own font, size and position.
- An overlay such as grain, a vignette or a bar.
- GIF b-roll cutaways, a trimmed length and a faint sound bed.
- A fresh hook, caption and hashtag set, written by Claude for that account.
A uniqueness check compares the finished files and holds back any that look the same, so you do not get two near-identical exports queued for two accounts.
It is available on any paid plan with unlimited runs, two at a time. During a free trial you get one run. It is a production tool that saves you exporting and captioning the same clip by hand.
How the variations_ tools and /v1/variations API work
There are two doors into the same engine: the variations_ tools inside the MCP server, and the /v1/variations endpoints on the REST API.
If you work in a chat app, the tools are the simpler route. Connect the hosted MCP server at https://mcp.creatoros.ca/mcp, which needs nothing installed, then ask in plain words. In Claude that is Settings > Connectors > Add custom connector, paste the URL, sign in, and choose a workspace and read only or read & write. ChatGPT takes the same URL as a connector in developer mode. Cursor, Windsurf and VS Code get an mcpServers entry with type http, the URL and an Authorization: Bearer cos_live_... header. The MCP docs walk through each client.
If you are building a pipeline, call /v1/variations directly with a cos_live_ key. Keys are pinned to one workspace, and every ID you get back is an opaque typed token, so a key for one set of socials cannot act on another. Find the base URL and the full request shape in the Creator OS docs.
Practical difference between the two:
| Route | Best for | What you hand over |
|---|---|---|
MCP variations_ tools |
Chat with Claude, ChatGPT, Cursor | The video, the account list, a plain-language brief |
/v1/variations |
Your own script or agent loop | Structured request, cos_live_ key, typed IDs |
variations_post tool |
Publishing the finished set | The run, the pairings, the schedule |
Do not guess at parameter names beyond what the docs list. Read the docs page, then ask the tool to confirm what it needs.
How to post 20 video variations from Claude with the MCP server
The whole job is one conversation and one confirming click, so here is a prompt you can copy and adjust.
Make 12 variations of this video: https://example.com/master.mp4
Accounts: @brand_main, @brand_clips, @brand_deals,
@brand_es, @brand_uk, @brand_fitness, @brand_mom,
@brand_bts, @brand_reviews, @brand_daily,
@brand_story, @brand_lab
Keep the content. Change the grade, the hook styling and the
on-screen hook text. Write a different hook, caption and
hashtags for each account, sounding like that account.
Post all of them now.
What Claude does, roughly:
- Calls the
variations_tool with the file and your account list. - Waits while the versions render, then runs the uniqueness check and returns the set.
- Pairs each version with one account and shows you the run page, where you can change a pairing or skip a version.
- Calls
variations_postonce you confirm.
You can also spread the posts instead of firing all at once: one every 10 minutes, up to one every 8 hours, or from a start time you pick. Ask for that in the same prompt, for example “stagger them one every 30 minutes starting 9am Eastern.”
Every version gets its own caption, hashtags and cover. If you want to check copy lengths before anything goes out, the separate check_caption_length tool is there for exactly that.
What the publish guard Proceed or Cancel step does
The Claude Code plugin adds a guard that asks before anything is published, spent or deleted, and variations_post runs behind it.
Install it once:
/plugin marketplace add kevinbadi/creatoros-claude-plugin
/plugin install creatoros@creatoros
/plugin configure creatoros@creatoros
The configure step asks for your cos_live_ key. From then on the plugin carries the MCP server plus campaign builder and Agent Posts skills, a live pane at /creatoros, the /cos-stats and /cos-health commands, and the publish guard. When a variation run is ready to post, you get Proceed or Cancel. Pick Cancel and nothing is posted. The plugin needs Claude Code 2.1.287 or later.
Why this matters for a 12 or 20 account run: one misread instruction could put a clip on the wrong brand. The guard makes the final step a deliberate one. Details are in the Claude Code plugin docs.
Can Claude MCP post video to Instagram, Facebook and TikTok
Yes. The MCP server includes create_post and variations_post, and Reels, Facebook video and TikTok are supported posting targets, each with its own rules applied for you.
That includes Reels covers and frames, TikTok’s required consent flags, and Stories on Instagram and Facebook. Captions with links are a separate issue: Instagram captions have no clickable links, so put the URL in TikTok’s description or a profile link, or use firstComment where the platform allows it.
What the variation step adds is volume without copy-paste. Twenty accounts with the same file and same words is a chore you cannot sustain by hand. Twenty files with twenty hooks and twenty captions is the same job done in one prompt. The video variations for multiple accounts guide covers the detail of running variations across a set of accounts.
CapCut MCP and Claude: why variations start with the edit
No, there is no CapCut MCP server from Creator OS, and we make no claim about what other editing tools offer.
Variations takes a finished video as its input. It does not cut your raw footage into a story. So the edit comes first, and that is where an agent helps most. Agent Posts in the web app does this: you hand it a finished vertical video, it transcribes it, writes the copy per platform, books the next free slot and posts. It also renders a 9:16 version for Reels, TikTok and Shorts, a 720p version for X and 4:5 for LinkedIn, each trimmed to that network’s length limit.
You can try the same brief in Claude before you commit: watch the walkthroughs on the KevBuildsApps YouTube channel, then sketch the workflow in chat. If you want to see the wider tool in motion, the launch video is a good place to start.
Launch video with Claude: one brief, many accounts
A concrete use: a launch clip for a product going to 20 accounts in three languages and four niches, without 20 manual exports.
The pattern is four moves and no new tools:
- Finish the vertical master. One file, one story.
- Run the
variations_tool with your account list and the “keep content, change look” instruction. - Review the run page: swap a pairing, skip a version, or change a hook you do not like.
- Confirm at the publish guard and let
variations_postpublish, either now or staggered.
The same engine handles shorter sets too. Five accounts for a quiet week is fine. Twenty is the ceiling.
For the full picture of what the hosted server can do beyond variations (roughly 160 tools across posts, analytics, comments, DMs, automations, webhooks, Skool and ads), start with the MCP server explainer.
FAQ
How many video variations can I post from Claude with the MCP server?
Up to 20 distinct versions per run, one per account. No account receives two versions and no version goes to two accounts. Any paid plan gets unlimited runs, two at a time.
What is the variations_post tool in the Creator OS MCP server?
It is the publishing tool for a finished variation run. Each version goes to one account with its own caption, hashtags and cover, posted all at once, staggered, or from a start time you choose.
Does the Claude Code plugin publish guard ask before posting?
Yes. The plugin asks Proceed or Cancel before anything is published, spent or deleted, and it includes a mod with a live pane, /cos-stats and /cos-health, a status line and the skills. It needs Claude Code 2.1.287 or later.
Can Claude MCP post the same video to multiple accounts?
It can, but that is not what variations are for. The point of the set is that each account gets its own file, hook and caption, so no two accounts show the same post.
Is there a CapCut MCP server for Claude?
Creator OS does not ship one. Variations starts from a finished video, so do your edit first, then hand the file to the variations_ tool.
Get started with Creator OS
Connect the hosted MCP server, upload one master video, and ask Claude for a set of variations across your accounts. The MCP docs have the client setup, and the launch video shows the wider picture.
Creator OS plans start at $14.99/month for 11 platforms plus Skool, with the API, the MCP server and the CLI included. Sign up and start a trial.
Get started for $0
Free trial for new subscribers. Cancel anytime.