clipatra

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 every workspace owned by that account, while a creator key unlocks the creator tools.

What is Clipatra

Performance-based creator marketing, not paid ads. A brand can run an open campaign or bid from its funded wallet on a creator's direct sponsorship package. Creators publish organic posts to their own audiences and get paid through the campaign workflow. There are no ad placements or targeting pixels.

Fastest start (no key copy-paste)

npx clipatra 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. Finish setup with the onboard command it prints.

Run start directly; don't register it as a server. start is one-time interactive onboarding, not the MCP server. Do not do claude mcp add clipatra -- npx clipatra start, which blocks on browser approval and never connects. start auto-writes the correct server entry (which runs clipatra serve) for you. Wiring a server by hand? Use serve, never start.

For creators

1. Sign in and connect your agent. One keyless command (no key to copy):

npx clipatra start

It opens a browser sign-in, saves your key locally (~/.clipatra), and auto-configures your MCP clients (Claude Desktop, Claude Code, Cursor, Windsurf, VS Code).

2. Connect a social account. Add TikTok, Instagram, YouTube, or X by public handle. No key is needed; it reads the one start saved:

npx clipatra onboard

npx clipatra onboard --platform tiktok --handle @yourname

That returns a caption code to put in your first campaign video's caption (verification is automatic when you submit the link). You can then browse, join campaigns, submit videos, and earn without setting up payouts.

Payout setup is optional until you withdraw earnings. When you are ready, run npx clipatra onboard --country US with the legal registration country for Stripe or destination bank country for Wise. Secure payout setup opens in your browser; bank details never pass through the CLI or your agent. Re-run the command to resume, or add --wait when running it directly in a terminal.

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_get_started | Explain the creator flow and guide the next setup step | | creator_onboarding_status | Which social accounts are connected, are payouts ready, is setup complete | | claim_social_account | Add TikTok, Instagram, YouTube, or X by public handle (no login); verified by a code in the first campaign video's caption | | connect_social_account | Retired — points to claim_social_account | | connect_tiktok | Retired legacy alias — points to claim_social_account | | disconnect_account | Disconnect a social account after clear confirmation | | setup_payouts | Start secure payout setup and return a hosted link | | change_payout_account | Safely replace the current Stripe or Wise payout account | | browse_campaigns | Open campaigns you can join, with fee, bonus, and requirements | | join_campaign | Claim a slot on an active campaign | | submit_video | Submit one selected-platform video link; repeat for another selected platform | | request_video_review | Ask the brand to review one rejected video (once per campaign, 10 credits) | | my_campaigns | Campaigns you joined, with each submission's status and views | | my_earnings | Available, under-review, processing, pending, and lifetime earnings | | creator_sponsorship_auctions | Recent direct sponsorship auctions and the secure page to create or manage one | | creator_bid_page | Your public bid page, the funded offers brands placed, and whether a decision is open | | decide_open_bids | Run one funded offer (any of them, or the top) — the other holds are released instantly — or clear them all; preview first, confirm=true only after a clear yes |

For brands

1. Sign in and connect your agent. One keyless command (no key to copy):

npx clipatra start

It opens a browser sign-in, saves your key locally, and auto-configures every MCP client you have installed (Claude Desktop, Claude Code, Cursor, Windsurf, VS Code).

2. Finish account setup. This saves your brand profile and adds a card on file. No key needed; it reads the one start saved:

npx clipatra onboard --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 npx clipatra onboard to confirm. The same onboard command works for both key types; it detects which side you're on.

Restart your client if needed, 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 | Total balance, committed amount, and funds available for new campaigns | | 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) | | review_video_request | Approve or reject a creator's pending review request | | update_campaign | Edit a draft campaign | | activate_campaign | Check the first creator place can be funded, then 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 | | list_brand_workspaces | List every brand workspace owned by this account | | switch_brand_workspace | Select a workspace without reconnecting (local MCP) | | move_campaign_to_workspace | Move an untouched draft to another owned workspace | | browse_sponsorship_auctions | Compare live creator-run auctions (bids from $10) | | lookup_creator_bid_page | Any X creator's bid page + board — offers from $100, funded up front, no deadline | | review_open_bid_offer | Check one exact open bid; returns a confirmation token when the wallet covers it, or a funding link that tops up and places it in one payment | | place_open_bid_offer | Place a separately approved open bid — the amount is held in your wallet until the creator picks, released instantly if it isn't you | | withdraw_open_bid_offer | Pull an offer back before it is picked; the held amount returns to your balance | | brand_open_bids | Every open-bid offer you made, with each offer's id and whether it leads | | review_sponsorship_offer | Review the exact wallet reserve and cancellation penalty before approval | | place_sponsorship_offer | Place a separately approved offer from the funded wallet | | brand_sponsorships | Won auctions that need a private brief, with deadline and penalty |

Multiple brand workspaces

One account, MCP connection, and API key can manage multiple brands. In the local CLI/MCP, select one with workspace use. Hosted agents pass a workspace ID per call, so different agents can safely work in different brands at once. No reconnect or extra key is needed.

npx clipatra workspace list
npx clipatra workspace use "Outrank"
npx clipatra campaign move <id> --workspace "Outrank"

Only untouched drafts can move; campaigns with assets, creator activity, or payment activity stay in their current workspace.

Drive it from the terminal (no MCP client needed)

The CLI isn't just onboarding. It can run the whole flow, so you (or an agent over a shell) can manage campaigns without any MCP client loaded. It uses the key start saved locally. Money flags are in dollars.

Brand:

npx clipatra campaign estimate --fee 20 --budget 500
npx clipatra campaign create --name "Launch" --fee 20 --budget 500 \
    --brief "Show the product in action" --bonus-type cpm --cpm 5 --bonus-cap 200
npx clipatra campaign list
npx clipatra campaign move <id> --workspace "Outrank"
npx clipatra campaign activate <id>      # checks first place, goes live
npx clipatra campaign slots <id>         # who joined + views
npx clipatra campaign report <id>
npx clipatra wallet                       # balance
npx clipatra wallet topup --credits 100   # Stripe link, 1 credit = $1

npx clipatra sponsor lookup @handle       # any X creator's bid page
npx clipatra sponsor offer @handle --product "…" --amount 150 --yes
npx clipatra sponsor offers               # your offers, with their ids
npx clipatra sponsor withdraw <offer-id>  # hold returns to your balance

Creator:

npx clipatra browse                       # open campaigns
npx clipatra join <id>
npx clipatra submit <id> --url "https://…"
npx clipatra bids                         # offers waiting on your bid page
npx clipatra bids accept --offer <id> --yes
npx clipatra earnings
npx clipatra profile set --name "…" --categories tech,ai

create makes a draft (spends nothing); after activate, wallet money is reserved one creator at a time as creators join. Run npx clipatra help for every flag.

Connect options (rarely needed)

start already connects every detected client. To (re)configure manually, with no key needed since it uses the one start saved:

npx clipatra connect --client cursor   # configure only one client
npx clipatra connect --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@latest", "serve"],
      "env": { "CLIPATRA_API_KEY": "clipatra_sk_your_key_here" }
    }
  }
}

Environment

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

License

MIT