Use RecruitAffiliates.ai from your AI assistant
Connect Claude, ChatGPT, Cursor or another MCP client, then set up, search, shortlist, find emails and offer terms by asking.
Ask your assistant to find affiliates for you, and it runs RecruitAffiliates.ai's tools while you watch. MCP is the standard way an assistant like Claude or ChatGPT connects to an app, so it can use that app for you.
Server URL: https://mcp.recruitaffiliates.ai/mcp
This address is RecruitAffiliates.ai's own. It shows your assistant the RecruitAffiliates.ai tools and nothing else, and you don't need an AffiliateRail program to use it.
Connect
- Add the server URL above to your assistant as a remote MCP server.
- Press Connect. A sign-in page opens in your browser.
- Sign in to RecruitAffiliates.ai, then press Allow. The page lists what your assistant can and can't do before you choose.
You never paste a key. Every RecruitAffiliates.ai plan can connect, the free trial included, and the connection keeps working after the trial ends. Allow gives your assistant a key that reaches RecruitAffiliates.ai only, never an AffiliateRail program.
To disconnect, remove RecruitAffiliates.ai from your assistant's connectors. It can't reach your account after that.
Prefer a key? In Settings, API keys, make one with finder:read or finder:write and send it as a bearer token to the same address. It opens the RecruitAffiliates.ai tools and nothing else. For step-by-step setup for each assistant, see the full MCP guide. Use the address above.
What you can ask
| Ask | Tool behind it |
|---|---|
| "Set up RecruitAffiliates.ai for acme.com" | recruit_setup_brand, then recruit_setup_guide |
| "What needs me today?" | recruit_what_needs_me |
| "Find YouTubers who review email tools" | recruit_search |
| "Who are my best new matches?" | recruit_affiliates, recruit_affiliate |
| "Find more creators like these three" | recruit_clone_profile, then recruit_clone_search |
| "Save the top three and hide that one" | recruit_save, recruit_hide |
| "Put the good ones on a list called First ten" | recruit_create_list, recruit_list_members |
| "Get me their emails" | recruit_find_email, recruit_find_emails |
| "Offer the top match 30%" | recruit_deal, recruit_propose_terms |
| "Where is everyone in my pipeline?" | recruit_pipeline, recruit_set_stage |
| "How many email lookups are left?" | recruit_credits |
What costs email lookups
A email lookup is one paid lookup. A search starts one search, and an email lookup finds one address. Email lookups has what each plan includes. Everything else is free.
- recruit_search and recruit_clone_search use one search each. If the search can't start, or finds nothing new, the email lookup comes back.
- recruit_find_email and recruit_find_emails use one email lookup for each address found, and only then.
- Your assistant treats these four as tools that can't be undone, so it asks before it runs them. Each shows a card with the cost and your balance first.
Working on another brand
Each tool takes an optional brand. Give a domain, a brand name or a brand id. Leave it out and it's your oldest brand. On Grow, name another brand to work on it. Each card and answer names its brand. If a row isn't from the brand you named, the tool won't touch it.
Before anything costs an email lookup or changes your data, the assistant shows you a card with the cost and what you have left. Nothing happens until you say yes.
The full set, for keys
A connection made with an API key (Claude Code, Cursor, your own scripts) can get more than the tools in the reference below. The extra tools cover the whole loop. They set up your brand, run searches, find emails in bulk and edit campaign drafts. They work the Mailroom and the pipeline, mark a "said yes" as agreed, and export your results. Each area has its own page:
- Set up your brand
- Searches and results
- Email addresses
- Campaign drafts
- Replies and the pipeline
- Results, exports, tools and rules
The Connect and Allow buttons in Claude and ChatGPT never get the full set. They get the tools listed below.
Keys that can send
An assistant can only send email with a key that has Can send email ticked (see Can send email). A key without it gets the full set minus every tool that sends. Connect and Allow never sends, whatever the key behind it.
When something goes wrong
Every error your assistant gets says what to do in one sentence, and names the tool that fixes it when there is one. For example, if a person isn't saved yet, it says to save them first and points at recruit_save. When only you can fix it, like picking a plan, the sentence has a link to the screen.
How fast an assistant can go
Your assistant shares the same minute limit the API has: 30 requests a minute on Launch and the trial, 120 on Grow, 300 on Enterprise. The limit covers your whole account. The MCP and the API count separately. An assistant that goes over waits the seconds it's told, then carries on.
Old tool names
Tools used to start with finder_. They start with recruit_ now, and the old names have stopped working. If an assistant asks for an old name, reconnect it so it reads the new list.
The request log
With a key, recruit_api_requests reads that key's last 100 API requests: the method, path, status, error code and time. It's the same log the Developers tab shows. It never shows another key's requests.
What stays with you
- An assistant sends email only with a key that has Can send email ticked. It shows you a card of what will go out, and sends only once you agree. Every send waits a few minutes so you can undo it. Connect and Allow never sends.
- No tool approves or launches a campaign, or turns someone into a partner. With a key, an assistant can mark terms agreed or activate someone, behind a card. You do the rest in RecruitAffiliates.ai.
- No tool changes your plan, starts a checkout or touches your team, your keys or your billing.
- Names, bios and other text about the people we find come from outside your team. Every tool marks that text as untrusted, so your assistant shows it and never follows it.
Coming next: get a campaign and your week ready
We are adding twelve tools so your assistant can do the preparing and you only do the approving. They are switched off for now, and the tool reference below doesn't list them yet. When they are on, you can ask:
| Ask | Tool behind it |
|---|---|
| "Who already works with us?" | recruit_exclusions |
| "Here are our current affiliates" (pasted) | recruit_add_exclusions |
| "Start a campaign with these three" | recruit_create_campaign, then recruit_campaign_audience |
| "Show me the emails you'd send" | recruit_campaign_previews |
| "Where are my campaigns?" | recruit_campaigns, recruit_campaign |
| "Pause that campaign" | recruit_control_campaign |
| "What's in this week's batch?" | recruit_weekly_batch |
| "Which replies need an answer?" | recruit_mailroom |
| "Draft a reply to Lena" | recruit_draft_reply |
| "UK bloggers on baby sleep who already work with my rivals" | recruit_ask |
Every answer that needs you ends with a link, called approve_url. It goes to the page where you approve, and you can clear a week's batch there on your phone. Nothing sends from a chat. A campaign made this way is a draft until you approve it in RecruitAffiliates.ai, and no tool can approve, start or resume one.
- Previews write the emails with our email writer, so a call is capped at five people.
- Reply drafts come back as text for you to read and send yourself. They count against your plan's monthly allowance of drafted replies. Message bodies are never shown to your assistant, only the subject, who wrote and what kind of reply it was.
- Pause and stop are the only changes to a running campaign. Stop can't be undone.
Two ready-made prompts go with them: "Find more like my best affiliates" and "Get my week ready".
Connected assistants
With these tools on, Settings, Account lists every assistant you have allowed in: its name, when you connected it and when it last called. Disconnect asks first, then cuts the assistant off at once. Its next request is refused, and anything it prepared stays in your account.
More tools, for webhooks and the rest of the Mailroom, come later. The tool reference below lists what the server offers today.
Prompts
A prompt is a saved job you pick from your assistant's menu instead of typing it out. Each one calls the tools in order and stops at every card for your yes.
| Prompt | What it does | What you can give it |
|---|---|---|
Recruit my first 10 affiliates (recruit_my_first_10_affiliates) | Find, save and look up emails for ten affiliates, asking before every credit. | brand (optional): The brand's domain or name. Leave out for the first brand; topic (optional): A topic to search for as well, like "email marketing". Costs 1 search credit |
Offer my top match (offer_my_top_match) | Save the best match and propose it a commission, asking before each change. | percent (optional): The commission as a percent of each sale, like 30. Defaults to 30 |
Where are my affiliates (where_are_my_affiliates) | The pipeline board and the deals in progress, with one next step for anyone stuck. | Nothing |
What needs me today (what_needs_me_today) | The short list of what needs the founder today, and the tool for each. | Nothing |
Set up RecruitAffiliates.ai from nothing (set_up_recruit_affiliates_from_nothing) | From a domain to a brand with its first scan done, asking before each change. | domain: The product's domain, like acme.com |
Resources
A resource is something your assistant can read without calling a tool, like your brand's profile. Put a brand's id in place of {brand_id} to read that brand.
| Address | What it holds |
|---|---|
finder://brand | The brand's profile: name, domain, summary, competitors, keywords, hashtags, targeting, revenue inputs, setup progress and research. |
finder://brand/{brand_id} | The brand's profile: name, domain, summary, competitors, keywords, hashtags, targeting, revenue inputs, setup progress and research. For the brand named in the address. |
finder://offer | The brand's default offer, in words and as terms. Every new deal starts from it. |
finder://offer/{brand_id} | The brand's default offer, in words and as terms. Every new deal starts from it. For the brand named in the address. |
finder://style | How the brand writes and sends: the voice notes, the signature, the daily limit on new contacts, the sending window and the timezone. |
finder://style/{brand_id} | How the brand writes and sends: the voice notes, the signature, the daily limit on new contacts, the sending window and the timezone. For the brand named in the address. |
finder://account | The plan and trial end, credits, seats, brands, inboxes and what this connection may do. |
docs://recruit-affiliates/{query} | The RecruitAffiliates.ai sections of the docs that match the words in the address, like docs://recruit-affiliates/credits. |
Tool reference
29 tools. finder:read means any connection can use it. finder:write means it needs a connection that can make changes.
Start here
| Tool | What it's for | Access | What it does |
|---|---|---|---|
recruit_setup_brand | Set up a brand | finder:write, card first, reaches outside the account | Take a blank account to a brand with its first scan running, in one call: the product's domain and country, what it does, its competitors or keywords, and the default offer. Give whatever is known and call again for the rest. Free: the first scan uses no credits. For example, domain acme.com, country GB, keywords ["affiliate software"], offer 20% for 12 months. |
recruit_setup_guide | Setup guide | finder:read | Start here when setting up RecruitAffiliates.ai or checking how far along it is. Returns the steps from a blank account to a first campaign, which are done, the next one, and the tool for each. For example, call it after each step until complete is true. |
recruit_today | What's new today | finder:read | The Today screen in one read. next_step and queue are the ordered decisions Today prints, most urgent first, each with its words, count and link: answer replies, approve emails, send agreed people their link, find emails, emails being written, connect a mailbox, look at new people, check in with quiet affiliates. People are counted the way the Outreach screen counts them. Also email credits left, finished searches and the setup checklist. Example: since_days 1 for what came in since yesterday. |
recruit_what_needs_me | What needs me | finder:read | The short list of what needs the founder today, most urgent first, each with the tool that acts on it. The decisions are Today's own queue (replies to answer, emails to approve, agreed deals, first-campaign emails, a mailbox, new people to look at, quiet affiliates), counted the way the Outreach screen counts people, followed by the next setup step and low credits. For example, call it at the start of a working session. |
Account
| Tool | What it's for | Access | What it does |
|---|---|---|---|
recruit_account | Account | finder:read | The account at a glance: the plan and when the trial ends, credits left, seats used, the timezone, every brand and inbox, and what this connection may do. For example, call it first to see whether the trial still has email credits. |
Credits
| Tool | What it's for | Access | What it does |
|---|---|---|---|
recruit_credits | Credits left | finder:read | How many search and email credits this account has left this period, how many it has used, and when they reset. A search costs one search credit; an email found costs one email credit. For example, check it before a big recruit_find_emails. |
Brands and your offer
| Tool | What it's for | Access | What it does |
|---|---|---|---|
recruit_brand | Read a brand | finder:read | One brand in full: its summary, competitors, keywords, hashtags, targeting, voice, offer, setup progress, research run, latest scan and how many existing affiliates it leaves out. For example, read it before setting a brand's offer with recruit_set_offer. |
recruit_brands | List brands | finder:read | Every brand on this account, oldest first, with its domain, whether setup is finished and its default offer in words. For example, use it to find the brand id (fbr_...) other tools take. |
recruit_set_offer | Set the default offer | finder:write, card first | Set the commission a brand offers new affiliates by default. Every saved row's deal starts from it. Free. For example 30% for life: { rate: { rateType: "percent", rateBps: 3000 }, duration: { kind: "lifetime" } }. |
Discover
| Tool | What it's for | Access | What it does |
|---|---|---|---|
recruit_affiliate | Read one affiliate | finder:read | Everything about one affiliate: why it fits (its score, the four parts of it, the reasons and the pages that prove them), audience numbers, email and how sure we are of it, its deal, its email sequences, lists, tags and note. For example, pass an id from recruit_affiliates before deciding to save or contact them. |
recruit_affiliates | List affiliates | finder:read | Your RecruitAffiliates.ai lists: Discover (new matches), Saved (the ones you kept) or Hidden (the ones you ruled out), best first, each with why it's there, its evidence and its reply count. |
recruit_search_status | Scan progress | finder:read | Whether a brand's scan is waiting, running or done, how many people it found, and when the next weekly scan is due. Pass scan_id to follow one scan, with its progress per channel. Pass wait_seconds to hold the call until something changes: one call that waits, instead of many that ask. A first search takes 10 to 25 minutes. For example, call it right after recruit_start_first_search with wait_seconds 25. |
Searches
| Tool | What it's for | Access | What it does |
|---|---|---|---|
recruit_clone_profile | Read creators into a profile | finder:write, reaches outside the account | Clone the user's best affiliates, step one. Reads one to ten creators they already rate and says what they have in common: topics, audience, formats, brands they promote, size and hashtags. Free, nothing is charged. Show the profile to the user, let them edit it, then pass it to recruit_clone_search. |
recruit_clone_search | Find creators like these | finder:write, card first, can't be undone, reaches outside the account | Clone the user's best affiliates: find creators like the ones given, on the profile from recruit_clone_profile (edited or not). Call recruit_clone_profile first, it's free. Costs one search credit, refunded if the search can't start; the card shows the profile and the balance first. |
recruit_search | Start a search | finder:write, card first, can't be undone, reaches outside the account | Find new affiliates from one seed: a topic, a competitor's site or YouTube handle, or a YouTube channel to find lookalikes of. Costs one search credit, refunded if it can't start or finds nothing new; the card says the balance first. |
recruit_searches | Recent searches | finder:read | A brand's recent searches, newest first: what each looked for, whether it's still running, how many it found and whether a failed one's credit came back. Pass id for one search. For example, call it a few minutes after recruit_search to see if it finished. |
Saved affiliates and lists
| Tool | What it's for | Access | What it does |
|---|---|---|---|
recruit_create_list | Make a list | finder:write, card first | Make a named list to sort a brand's saved affiliates under, like "Podcasters" or "Top 10 to email". A name that exists already returns that list. Free. |
recruit_hide | Not a fit | finder:write, card first | Rule rows out: they leave Discover and Saved and wait under Hidden, where recruit_restore brings them back. The reason teaches the brand, for example too_small makes it favour bigger audiences. Free. For example ids ["fdi_..."] with reason wrong_audience. |
recruit_list_members | Add to or take off a list | finder:write, card first | Put saved affiliates on a list, or take them off with on false. Only saved rows of the list's brand can be on it. Free. For example id "fls_..." with ids ["fdi_..."]. |
recruit_lists | List your lists | finder:read | A brand's lists of saved affiliates, oldest first, each with how many saved rows are on it. For example, find a list's id to pass to recruit_list_members or recruit_affiliates. |
recruit_restore | Bring rows back | finder:write, card first | Bring hidden rows back to Discover (or Saved, if they were saved). Free. The reason's effect on the brand stays. For example ids ["fdi_..."] from recruit_affiliates with view hidden. |
recruit_save | Save affiliates | finder:write, card first | Save up to 25 rows from Discover to Saved, where each gets a deal from your default offer. Free: saving never spends a credit. |
recruit_set_stage | Move along the pipeline | finder:write, card first | Change a saved affiliate's status: saved, contacting, replied, negotiating, onboarding, no_reply, declined or on_hold. Declined and on hold need a reason. Activated is set only by the founder, in RecruitAffiliates.ai. Free. For example stage replied after they answer your email. |
Email addresses
| Tool | What it's for | Access | What it does |
|---|---|---|---|
recruit_find_email | Reveal an email | finder:write, card first, can't be undone, reaches outside the account | Look up the email address of one saved row (recruit_save first). Costs one email credit, only when a usable address comes back: nothing found is refunded. A row already revealed costs nothing. |
recruit_find_emails | Find emails for many | finder:write, card first, can't be undone, reaches outside the account | Look up email addresses for up to 100 affiliates. Each costs one email credit only when a usable address comes back; nothing found is refunded and a row that already has an address costs nothing. With save_first true, unsaved rows are saved first (free), so one call saves and finds. Rows are queued for a background job when one runs, otherwise looked up in the call. For example ids [fdi_aaa, fdi_bbb] from recruit_affiliates. |
Deals
| Tool | What it's for | Access | What it does |
|---|---|---|---|
recruit_deal | Read a deal | finder:read | Read a saved affiliate's deal: the current terms in words, every version, the verdict and what they asked for. Read only. To change the terms use recruit_propose_terms. |
recruit_deals | List your deals | finder:read | A brand's deals, best fit first: every saved affiliate that has a deal, with its status, terms, your verdict and what they asked for. The Deals view of Saved. For example, find the deals still at status saved to follow up, then open one with recruit_deal. |
recruit_propose_terms | Propose deal terms | finder:write, card first | Propose new terms to a saved affiliate as the next version of its deal. A proposal only: it never marks terms agreed and never makes them a partner, because the user does both in RecruitAffiliates.ai. Free. Read the deal first with recruit_deal. |
Pipeline
| Tool | What it's for | Access | What it does |
|---|---|---|---|
recruit_pipeline | Read the pipeline | finder:read | Read the pipeline board: every saved affiliate by stage (saved, contacting, replied, negotiating, onboarding, activated, no reply, declined, on hold), with the four totals. Read only. Example: stage replied to see who wrote back. |
Was this page helpful?