clipatra-mcp

Drive Clipatra from Claude, ChatGPT, Cursor, or any MCP client, in plain English. One package for both sides of the marketplace:

• Brands run performance-based creator campaigns.
• Creators onboard, join campaigns, submit videos, and track earnings.

Your API key decides which side you are: a brand key unlocks the brand tools, a creator key unlocks the creator tools.

What is Clipatra

Performance-based creator marketing, not paid ads. A brand funds a budget and pays small creators a fixed fee plus an optional performance bonus to post short organic videos to their own audiences. Creators join campaigns, post, and get paid on verified views. There are no ad placements, bids, or targeting pixels.

Fastest start — no key copy-paste

npx clipatra-mcp start

Prints a browser link; sign in with Google and approve. The CLI receives your API key and auto-configures every MCP client you have installed (Claude Desktop, Claude Code, Cursor, Windsurf, VS Code). Works for brands and creators — then finish setup with the onboard command it prints.

For creators

Get your creator key from onboarding at clipatra.com (the "Generate my command" button on the creator onboarding screen gives you one).

1. Set up your account (connects TikTok and payouts for you):

npx clipatra-mcp onboard clipatra_sk_your_key_here

It prints a link for TikTok and a link for payouts, then exits — open the links, finish in the browser, and re-run the same command to confirm (it picks up where you left off). Running it yourself in a terminal? Add --wait to have it poll until both are done.

2. Connect the MCP so your agent can work for you:

npx clipatra-mcp connect clipatra_sk_your_key_here

3. Ask your agent, for example:

• "Browse open campaigns and join the ones that fit me."
• "Submit this video for that campaign: "
• "How much have I earned so far?"

Creator tools

| Tool | What it does | |------|--------------| | creator_onboarding_status | Is TikTok connected, are payouts ready, is setup complete | | connect_tiktok | Start TikTok connection and return a link to authorize | | setup_payouts | Start Stripe payout setup and return a hosted link | | browse_campaigns | Open campaigns you can join, with fee, bonus, and requirements | | join_campaign | Claim a slot on an active campaign | | submit_video | Submit your posted video URL (ownership and views verified) | | my_campaigns | Campaigns you joined, with each submission's status and views | | my_earnings | Available, pending, and lifetime earnings |

For brands

Get your brand key from onboarding at clipatra.com (the "Generate my command" button), or later from Settings → Developers → Create key.

1. Set up your account (saves your brand profile and adds a card on file):

npx clipatra-mcp onboard clipatra_sk_your_key_here \
  --name "Your Brand" --website "yourbrand.com"

Optional flags: --description "…", --category "…", --blocked "alcohol,gambling". It prints a Stripe link for the card (no charge), then exits — save the card in the browser and re-run the command to confirm. The same onboard command works for both key types; it detects which side you're on.

2. Connect the MCP (one command auto-configures every MCP client you have installed: Claude Desktop, Claude Code, Cursor, Windsurf, VS Code):

npx clipatra-mcp connect clipatra_sk_your_key_here

Restart the client, then ask your agent, for example:

• "Create a TikTok campaign with a $5 fee and a $500 budget, then activate it."
• "How are my live campaigns performing?"

Brand tools

| Tool | What it does | |------|--------------| | get_started | Call first: how Clipatra works, live wallet and campaigns, required fields | | get_wallet_balance | Available prepaid balance | | create_topup_link | Stripe Checkout link to add money to the wallet | | list_campaigns | All your campaigns | | get_campaign | One campaign by id | | estimate_campaign | Preview how many creators a budget funds (no spend) | | create_campaign | Create a draft campaign (optionally with assets) | | update_campaign | Edit a draft campaign | | activate_campaign | Fund-check, reserve budget, go live | | pause_campaign | Stop new creators from joining | | cancel_campaign | Close a campaign and release unused budget | | list_campaign_slots | Creators who joined, with status and views | | get_submission | One submission's metrics, cost, and watch-window progress | | list_campaign_assets | List a campaign's brand assets | | attach_campaign_asset | Attach a logo, demo video, or screenshot by URL | | get_campaign_report | Full performance report for a campaign |

Connect options (rarely needed)

npx clipatra-mcp connect <key> --client cursor   # configure only one client
npx clipatra-mcp connect <key> --print           # print a snippet (e.g. ChatGPT Desktop)

Manual config

connect writes a clipatra entry into your client config. To wire one by hand:

{
  "mcpServers": {
    "clipatra": {
      "command": "npx",
      "args": ["-y", "clipatra-mcp", "serve"],
      "env": { "CLIPATRA_API_KEY": "clipatra_sk_your_key_here" }
    }
  }
}

Environment

| Variable | Purpose | |----------|---------| | CLIPATRA_API_KEY | Your clipatra_sk_… key (required) |

License

MIT