Octoclip MCP connector

Run Octoclip from your AI assistant.

Connect Octoclip to Claude, ChatGPT or another AI assistant and work from the chat. Brands write a brief, publish it, send offers and review videos. Creators find jobs, apply, answer offers and deliver their links.

Your assistant does the thinking; Octoclip keeps the rules and the money.

Money stays on octoclip.io: hiring and approving always finish there.

  1. 1
    Copy your Octoclip linkhttps://octoclip.io/api/mcp
  2. 2
  3. 3
  4. 4
  5. 5

MCPThe open standard AI assistants use to connect to apps.

Your Octoclip linkNames and logos belong to their owners.
https://octoclip.io/api/mcp
  • Sign in with your Octoclip account. Brand or creator, the link is the same.
  • Nothing to install. You paste the link and sign in.
  • Disconnect any time at octoclip.io/connect.
Works in
  • Claude
  • ChatGPT
  • Gemini
  • Grok
  • Claude Code
  • Codex
  • Gemini CLI
  • Cursor
  • VS Code
Exact steps for each assistant
Prompts to start

Copy one and paste it in your chat.

Or open it straight in ChatGPT or Claude. Starting with “Use Octoclip” makes sure your assistant picks it.

01 · Your first job
Use Octoclip to post a UGC job for [your website]. Read the site, then ask me what the videos should show.
It asks a few questions, writes the brief and shows you a preview.
ChatGPTClaude
02 · Applicants
Use Octoclip: who applied to my job? Show the longest wait first, with their example videos.
Then ask it to send offers to the ones you pick.
ChatGPTClaude
03 · Every morning
Use Octoclip: what needs me today?
Videos to review, applicants waiting and offers about to expire, in that order.
ChatGPTClaude
Set up

Copy the link, paste it, sign in.

The same three steps work in every assistant on this page. Only the menu where you paste the link changes.

  1. 1Copy.

    Copy your Octoclip link, https://octoclip.io/api/mcp. It’s the same for every account, so a whole team can use it.

  2. 2Paste.

    Add it in your assistant as a custom connector or remote MCP server, and name it Octoclip. Pick your assistant below for the exact clicks.

  3. 3Sign in.

    Your assistant opens Octoclip. Sign in, check it’s the right account and select Allow. You’re back in the chat, connected.

Example · the Octoclip sign-in page
OCTOCLIP

Connect Claude to Octoclip?

Claude wants to use your Octoclip account on your behalf, inside its chat.

  • It can read your jobs, applications, offers and videos, and act as you.
  • It cannot pay, charge a card or move money. Funding always happens on Octoclip.
  • You can disconnect it any time at octoclip.io/connect.
Requested access: openid, email, profile.Signed in as you@example.com. Not you? Sign out.
Step 3 in your browser. Every assistant gets this same page, with its own name at the top.
Step by step

Exact steps for your assistant.

Checked against each maker’s own help pages on 16 Oct 2026. If a menu has moved, look for “custom connector” or “MCP server” and paste the same link.

Chat apps
Coding tools

Claude

claude.ai and the Claude desktop app

Checked 16 Oct 2026

  1. 1
    Open your connectors

    CustomizeConnectorsAdd custom connector

  2. 2
    Paste the link

    Name it Octoclip and paste https://octoclip.io/api/mcp as the MCP server URL.

  3. 3
    Keep the sign-in Claude detects

    If Claude asks how people sign in, leave what it detected. There’s no client ID or secret to enter. Click Add.

  4. 4
    Sign in with Octoclip

    Sign in with your Octoclip account and select Allow. If the sign-in doesn’t open by itself, click Connect next to Octoclip.

  5. 5
    Turn it on in a chat

    Open + › Connectors in a chat and check Octoclip is on. Then ask “What needs me today?”

ChatGPT

chatgpt.com on the web

Checked 16 Oct 2026

  1. 1
    Open Plugins

    chatgpt.com/plugins+Add custom MCP server

  2. 2
    Paste the link

    Name it Octoclip. Under Connection, paste https://octoclip.io/api/mcp as the Server URL.

  3. 3
    Choose OAuth

    Set authentication to OAuth. Read the warning, then select I understand and want to continue.

  4. 4
    Create, install, sign in

    Select Create as a plugin, open it in your plugins and install it. When ChatGPT asks, sign in with your Octoclip account and select Allow.

  5. 5
    Use it in a chat

    In a new chat, type @ and pick Octoclip.

Gemini

gemini.google.com

Checked 16 Oct 2026

  1. 1
    Open Connected Apps

    SettingsConnected AppsAdd a custom app

    Settings is at the bottom of gemini.google.com. Don’t see Connected Apps? Open Personal Intelligence first.

  2. 2
    Paste the link

    Under Custom apps, paste https://octoclip.io/api/mcp as the MCP server URL. Leave Advanced features closed: there’s no client ID or secret to enter.

  3. 3
    Sign in with Octoclip

    Select Next, follow the steps on screen, sign in with your Octoclip account and select Allow.

  4. 4
    Use it in a chat

    Type @ and pick Octoclip.

Grok

grok.com

Checked 16 Oct 2026

  1. 1
    Open Connectors

    grok.com/connectorsNew ConnectorCustom

  2. 2
    Paste the link

    Paste https://octoclip.io/api/mcp as the MCP server URL.

  3. 3
    Sign in with Octoclip

    Complete the sign-in with your Octoclip account and select Allow. Grok then finds Octoclip’s tools and uses them when your question needs them.

Claude Code

In your terminal

Checked 16 Oct 2026

  1. 1
    Add Octoclip
    Terminal
    claude mcp add --transport http --scope user octoclip https://octoclip.io/api/mcp

    --scope user makes it work in every project. Leave it out to add it to this project only.

  2. 2
    Sign in
    Inside Claude Code
    /mcp

    Pick octoclip and sign in with your Octoclip account in the browser that opens. From your shell, claude mcp login octoclip does the same.

  3. 3
    Share it with your team
    .mcp.json at the project root
    {
      "mcpServers": {
        "octoclip": {
          "type": "http",
          "url": "https://octoclip.io/api/mcp"
        }
      }
    }

    Optional. Commit it with the project, and each person signs in with their own Octoclip account.

Codex

Codex CLI and the Codex app

Checked 16 Oct 2026

  1. 1
    Add Octoclip
    Terminal
    codex mcp add octoclip --url https://octoclip.io/api/mcp
  2. 2
    Sign in
    Terminal
    codex mcp login octoclip

    This starts the Octoclip sign-in. Sign in and select Allow.

  3. 3
    Or add it to config.toml
    config.toml
    [mcp_servers.octoclip]
    url = "https://octoclip.io/api/mcp"

    Then run codex mcp login octoclip once to sign in.

Gemini CLI

In your terminal

Checked 16 Oct 2026

  1. 1
    Add Octoclip
    Terminal
    gemini mcp add --transport http --scope user octoclip https://octoclip.io/api/mcp

    Without --scope user, Gemini CLI adds it to the current project only.

  2. 2
    Sign in
    Inside Gemini CLI
    /mcp auth octoclip

    A browser opens on the same computer. Sign in with your Octoclip account and select Allow.

  3. 3
    Or add it to settings.json
    settings.json
    {
      "mcpServers": {
        "octoclip": {
          "httpUrl": "https://octoclip.io/api/mcp"
        }
      }
    }

Cursor

The Cursor editor

Checked 16 Oct 2026

  1. 1
    Add Octoclip to mcp.json

    In one click: Add Octoclip to Cursor, then select Install. Or add it yourself:

    ~/.cursor/mcp.json
    {
      "mcpServers": {
        "octoclip": {
          "url": "https://octoclip.io/api/mcp"
        }
      }
    }

    ~/.cursor/mcp.json works in every project. Use .cursor/mcp.json inside a project for that project only.

  2. 2
    Sign in

    Cursor supports OAuth for remote servers. When it asks, sign in with your Octoclip account and select Allow.

  3. 3
    Check it’s on

    Open Customize in the sidebar and make sure Octoclip is switched on.

VS Code

With GitHub Copilot chat

Checked 16 Oct 2026

  1. 1
    Add the server

    In one click: Add Octoclip to VS Code, then select Install. Or add it yourself:

    Command PaletteMCP: Add ServerHTTP

    Paste the link and name it octoclip. Or add it to the workspace file:

    .vscode/mcp.json
    {
      "servers": {
        "octoclip": {
          "type": "http",
          "url": "https://octoclip.io/api/mcp"
        }
      }
    }
  2. 2
    Sign in

    VS Code signs in with OAuth. The first time the server connects, a browser window opens: sign in with your Octoclip account and select Allow.

  3. 3
    Use it in chat

    In the Chat view, select Configure Tools and check Octoclip’s tools are on. VS Code may ask you to confirm each tool call.

Any other assistant

Windsurf and other MCP clients
  1. 1
    Find where it adds a server

    Look in its settings for custom connector, remote MCP server or add server by URL.

  2. 2
    Paste the link
    mcp.json in most tools
    {
      "mcpServers": {
        "octoclip": {
          "url": "https://octoclip.io/api/mcp"
        }
      }
    }

    Config files usually take it as url. Windsurf takes serverUrl or url in its mcp_config.json, and Gemini CLI takes httpUrl.

  3. 3
    Sign in with Octoclip

    Choose OAuth if it asks. The assistant registers itself with Octoclip, so there’s no client ID or secret to enter.

What to ask

Ask in plain words.

Your assistant picks the Octoclip tool for you. Start with these, grouped by the job you’re doing.

Write a brief

  • “Draft a job for our new sleep feature”
  • “Read our website, then ask me what the video should show”
  • “Give each of the 3 videos its own angle”

Before drafting, it asks what the video should show, which messages must land and what tone.

Usesbrief_playbookbrand_contextdraft_job

Publish

  • “Show me the job as creators will see it”
  • “Change the price to €90 a video, then publish it”
  • “Make it ongoing, with 14 days to deliver”

Your first job is reviewed by Octoclip before it goes live. Later jobs go live when you publish.

Usesupdate_jobpublish_job

Who applied

  • “Who applied to the bedtime job?”
  • “Show the longest wait first, with their example videos”
  • “Decline the applicants I didn’t pick”

Useslist_applicantsdecline_application

Send an offer

  • “What do 3 creators at €120 a video cost?”
  • “Send Mia an offer for 2 videos”
  • “Withdraw the offer to Jake”

Sending an offer charges nothing. The card is charged only if the creator accepts, on Octoclip.

Usesquote_hiresend_offerwithdraw_offer

Review videos

  • “What needs me today?”
  • “Show videos waiting for review”
  • “Ask for a revision: the app name isn’t on screen”
  • “Open the approval page for Mia’s video”

Approving pays the creator, so you approve on Octoclip, at the link.

Useswhat_needs_mereview_videosrequest_revisionprepare_video_approval

Monthly retainers

  • “Propose a monthly retainer to Mia: 3 videos a month”
  • “Skip next month for Noah”
  • “Give next month’s videos their own angles”

Proposing charges nothing. Each month is a separate hire, charged before work starts.

Usespropose_monthlyskip_next_retainer_monthset_next_month_angles

Agencies with several brands

  • “Which brands am I in?”
  • “List open jobs for Duolingo”
  • “Draft a job for Headspace, not the agency brand”

One connection covers every brand you’re in. A change that doesn’t name a brand changes nothing: your assistant asks which one first.

Useslist_brandsand every brand tool

Find jobs

  • “Find UGC jobs I can apply to”
  • “Which open jobs fit my profile?”
  • “Show jobs that pay at least €100 a video”

Each job comes with why it fits you and anything that would stop you applying.

Usesfind_jobs

Apply

  • “Help me write a pitch for the Headspace job, in my words”
  • “Apply with this pitch: …”
  • “Withdraw my application to Duolingo”

You read the pitch before it’s sent. Octoclip checks the language, your connected account and your country.

Usesapply_to_jobwithdraw_application

Offers

  • “Do I have any offers?”
  • “What do I get if I accept this offer?”
  • “Decline the offer from Duolingo”

Accepting happens on Octoclip, at the link. Payouts and bank details stay there too.

Usesmy_applicationsprepare_offer_acceptancedecline_offer

Deadlines

  • “What’s due this week?”
  • “What did the brand ask me to change?”
  • “Did the brand propose a new angle?”

Usesmy_deadlines

Submit

  • “Deliver my video for the Headspace job: [Drive link]”
  • “Send my post link for video 2”

A UGC video goes as a Google Drive link, a creator post as the link to the live post.

Usessubmit_video

Monthly retainers

  • “Accept the monthly retainer from Headspace”
  • “Should I film yet this month?”

Until a month is paid, your deadlines say “Don’t film yet”.

Usesanswer_monthly_proposalmy_deadlines

Tool reference

Every Octoclip tool, and what it can change.

Your assistant calls these by name. Reads change nothing, writes wait for your yes, and anything that moves money finishes on Octoclip.

Brandbrand accountsCreatorcreator accountsAnyeither

Reads · 13

Answer questions and change nothing.

Your assistant can call these whenever it needs to know where things stand.

  • how_octoclip_works

    How Octoclip works. The rules for brands and creators: price per approved video, the two job types, limits, deadlines and the hiring flow.

    Any
  • quote_hire

    Quote a hire. What a hire costs for a number of creators and videos, from creator pay to the total.

    Any
  • my_account

    My Octoclip account. Whether you’re signed in as a brand or a creator, with your name and email.

    Any
  • list_brands

    List my brands. The brands you work in, your role in each and the one in use on your dashboard.

    Brand
  • list_jobs

    List my jobs. Your jobs with status, price, creators hired, applicants and videos waiting, and what needs you next.

    Brand
  • list_applicants

    List applicants for a job. Creators waiting for your answer, longest wait first, with pitch, example videos and Octoclip record.

    Brand
  • brief_playbook

    How to write a brief that works. Octoclip’s guide to a brief a creator can film from: what to ask, what goes in it and the quality bar.

    Brand
  • brand_context

    What Octoclip knows about this brand. Facts from your brand’s site, its standing dos and don’ts, and past jobs with what got approved.

    Brand
  • what_needs_me

    What needs the brand today. Videos to review, accepted offers to fund and new applicants, most urgent first.

    Brand
  • review_videos

    Videos waiting for review. Delivered videos with their link, the points the creator accepted, the angle and when each approves itself.

    Brand
  • find_jobs

    Jobs a creator can apply to. Open jobs with price, platform, dates and must-include points, why each fits you and what would block applying.

    Creator
  • my_applications

    My applications and offers. Your applications and their status, and any offer waiting for your answer.

    Creator
  • my_deadlines

    My deadlines and deliveries. Every video to film, resubmit or fix, with its deadline, amount, points and how to deliver it.

    Creator

Prepares · 4

Get a step ready that you finish on Octoclip.

They show what the decision means and give you the Octoclip page where you take it. They change nothing themselves.

  • prepare_video_approval

    Prepare a video approval. The video, what the creator is paid and the Octoclip page where you approve it.

    Brand
  • prepare_video_rejection

    Prepare a video rejection. What rejecting means and the Octoclip page where you reject it and give the reason.

    Brand
  • prepare_offer_acceptance

    Prepare an offer acceptance. The terms, what you keep, payout costs and the agreement, with the Octoclip page where you accept.

    Creator
  • prepare_retainer_resume

    Prepare resuming a monthly retainer. What resuming a paused monthly retainer costs and the Octoclip page where you resume it.

    BrandMonthly

Writes · 21

Preview first, then change only after your yes.

Each one returns a preview and changes nothing until your assistant sends your yes with it. None of them moves money.

  • draft_job

    Draft a job. Saves a draft from a finished brief, as one batch with a final date or as an ongoing job.

    Brand
  • update_job

    Edit a job. Changes a draft, a job in review or a live job. Offers already sent and hires stay as they are.

    Brand
  • publish_job

    Publish a job. Submits a draft so creators can apply. Your first job is reviewed by Octoclip first.

    Brand
  • delete_draft

    Delete a draft. Deletes a draft. A published job is closed on Octoclip instead.

    Brand
  • send_offer

    Send an offer to an applicant. Offers the job to someone who applied, who answers within 1 to 7 days. Charges nothing.

    Brand
  • decline_application

    Decline an applicant. Tells an applicant you’re not hiring them for this job.

    Brand
  • withdraw_offer

    Withdraw an offer. Takes back an offer the creator hasn’t answered yet.

    Brand
  • request_revision

    Ask for a revision. Sends a video back once, naming the accepted points or the angle it missed.

    Brand
  • report_broken_link

    Report a broken link. Tells the creator the link doesn’t open. The review clock pauses until they fix it.

    Brand
  • propose_angle_change

    Propose a new angle for a video. Suggests a new angle for a video not sent yet. Price and deadline stay; the creator accepts or declines.

    Brand
  • propose_monthly

    Propose a monthly retainer. Offers a creator you hired the same videos and price every month, until either side stops.

    BrandMonthly
  • propose_monthly_change

    Change a monthly retainer. Proposes new videos a month or a new price. The creator accepts or declines.

    BrandMonthly
  • skip_next_retainer_month

    Skip next month. Skips the next month of a monthly retainer: nothing charged, no videos made.

    BrandMonthly
  • set_next_month_angles

    Set next month’s angles. Gives each video of next month its own angle.

    BrandMonthly
  • apply_to_job

    Apply to a job. Applies with a short pitch in your own words.

    Creator
  • withdraw_application

    Withdraw an application. Takes back an application the brand hasn’t answered.

    Creator
  • decline_offer

    Decline an offer. Turns down a brand’s offer.

    Creator
  • submit_video

    Deliver a video. Sends your post link or Google Drive link for a hired job, with a short note.

    Creator
  • answer_monthly_proposal

    Answer a monthly retainer proposal. Accepts or declines a brand’s monthly retainer. Nothing is charged now.

    CreatorMonthly
  • answer_monthly_change

    Answer a monthly retainer change. Accepts or declines a change to the videos a month or the price.

    CreatorMonthly
  • stop_retainer

    Stop a monthly retainer. Ends it for whoever is signed in. A month already paid is still made and paid.

    BrandCreator

Tools marked Monthly appear when monthly retainers are available on Octoclip. Stopping a monthly retainer is always there.

Safety

Nothing changes until you say yes.

Octoclip enforces these rules on its own server, so they hold in every assistant.

Example

“Send Mia an offer for 2 videos”

Here’s the offer. Nothing is sent until you say yes.

OCTOCLIPSend an offerPreview
Creator
Mia C.
Job
5 minutes before bed
Videos
2 at €120 each
Creator pay
€240
Answer by
23 Oct

Nothing is charged now. The card is charged only if Mia accepts, on Octoclip.

“Yes, send it”

Offer sent. Nothing charged.

Octoclip’s preview, inside the chat. Change one field and a new preview comes back.
  1. 01

    Every write shows a preview first

    Drafts, edits, publishing, offers, revisions, applications and deliveries all come back as a preview. Octoclip acts only when your assistant sends your yes with that exact preview.

  2. 02

    Money and approvals finish on octoclip.io

    Posting a job and sending an offer charge nothing. Accepting an offer, which charges the brand’s saved card, approving a video, which pays the creator, and rejecting one happen on Octoclip, at a link your assistant gives you.

  3. 03

    What it can’t do

    It can’t pay, charge a card, pay out or move money, and it can’t change your card, bank details, team, billing or account settings. Ad codes stay out of the chat too: creators give those on Octoclip.

  4. 04

    It asks which brand

    If you work in several brands, a change that doesn’t name one changes nothing, and your assistant asks which brand it’s for. Choosing a brand in the chat never moves the brand in use on your dashboard.

  5. 05

    Pitches and briefs are data

    Octoclip tells your assistant to read applicant pitches and job briefs as information about people, never as instructions to follow.

  6. 06

    Your sign-in

    You sign in with your Octoclip account through OAuth, so the assistant never sees your password. It asks for openid email profile, then reads your jobs, applications, offers and videos and acts as you within the rules above. Disconnect it any time at octoclip.io/connect.

Your connections

See every assistant you’ve connected.

Signed in, octoclip.io/connect lists each assistant connected to your account, the day you connected it, and a Disconnect button.

Agencies see their brands here too. Sign in to see which assistants are connected to your account.

Example · signed in
octoclip.io/connect

Connected assistants

  • ClaudeConnected on 2 OctDisconnected. Add Octoclip in Claude again to reconnect.
  • ChatGPTConnected on 9 OctDisconnected. Add Octoclip in ChatGPT again to reconnect.
Your brands

You’re on 3 brands. When a request could go to more than one, the assistant asks which brand first.

  • Headspace
  • Strava
  • Revolut

Privacy · Termssupport@octoclip.io

Try it here. Disconnect works on this example; nothing real is changed.
Troubleshooting

When it doesn’t connect.

Six problems people run into, and what fixes each one.

  • The sign-in keeps sending me back

    Sign in at octoclip.io in the same browser first, then start the connection again from your assistant. Each sign-in request works once: if the page says it has expired or was already answered, go back to your assistant and connect again for a fresh one.

    On the Allow page, check the email shown. If it’s the wrong account, select Not you? Sign out. and sign in with the right one.

  • Octoclip’s tools don’t show up

    Check the link is exactly https://octoclip.io/api/mcp, then check the tools are switched on:

    • Claude+ › Connectors in the chat
    • ChatGPTType @ in a new chat
    • GeminiType @ in the chat
    • Claude CodeRun /mcp
    • Gemini CLIRun /mcp
    • CursorCustomize in the sidebar
    • VS CodeConfigure Tools in chat
    • CodexType /mcp in the composer

    Monthly retainer tools appear only when monthly retainers are available on Octoclip.

  • It says this isn’t a brand account

    Brand tools need a brand account and creator tools need a creator account. Ask “Which Octoclip account am I signed in with?” If it’s the wrong one, disconnect, sign out of octoclip.io and connect again with the right account.

  • It picked the wrong brand

    Ask “Which brands am I in?”, then name the brand in your request. A question with no brand answers for the brand in use on your Octoclip dashboard, and says which one. A change with no brand does nothing until you say which brand it’s for.

  • “Too many requests”

    Octoclip allows 60 tool calls a minute per person. Wait a minute, then ask again.

  • How to reconnect

    Disconnect the assistant at octoclip.io/connect, then sign in again from the assistant:

    • ClaudeCustomize › Connectors, then Connect next to Octoclip
    • Claude Code/mcp, then Re-authenticate
    • Codexcodex mcp login octoclip
    • Gemini CLI/mcp auth octoclip
    • Everything elseRemove Octoclip and add the link again

FAQ

Questions before you connect.

Short answers on cost, safety and what your assistant can see.

A person answers.

Something in the chat doesn’t look right? Write to support@octoclip.io and someone at Octoclip replies.

Write to us
Does connecting cost anything?

No. Connecting is free, and so are posting a job and sending offers. You pay when a creator accepts your offer, on Octoclip.

Do I need to install anything?

No. You paste one link in your assistant and sign in with your Octoclip account.

Which assistants work?

Any assistant that can add a remote MCP server with OAuth sign-in. This page has the exact steps for Claude, ChatGPT, Gemini, Grok, Claude Code, Codex, Gemini CLI, Cursor and VS Code.

Can my assistant spend money or approve a video for me?

No. Accepting an offer, approving or rejecting a video and resuming a monthly retainer all finish on octoclip.io, at a link your assistant gives you. In the chat, posting a job and sending an offer charge nothing.

Will it write my brief?

It writes it with you. Before drafting, it reads Octoclip’s brief guide and what Octoclip knows about your brand, then asks what the video should show, which messages must land and what tone. You direct, and it offers options instead of inventing them.

Can creators use it too?

Yes. Creators find jobs, apply in their own words, check deadlines and deliver their links. Accepting an offer happens on Octoclip, and payouts and bank details stay there.

I run several brands. How does it know which one?

The connection is you, so it covers every brand you’re in. When a request could go to more than one, your assistant asks which brand first.

What can the assistant see?

Your jobs, applications, offers and videos, and what Octoclip knows about your brand. It signs in with the openid, email and profile scopes, and never sees your password.

Is my first job reviewed?

Yes. A brand’s first job is reviewed by Octoclip before creators see it. Later jobs go live as soon as you publish them.

How do I disconnect?

Open octoclip.io/connect while signed in and select Disconnect next to the assistant. You can also remove Octoclip in the assistant’s own settings.

A person answers.

Something in the chat doesn’t look right? Write to support@octoclip.io and someone at Octoclip replies.

Write to us

Ready when you are

Post your first job from the chat.

Copy the link, add it to your assistant and ask for a draft. You set the price, check the preview and publish when you’re happy.

https://octoclip.io/api/mcp

Posting a job is free. You’re charged only when a creator accepts.