ReferralHero MCP by usefulapi MCP Server

by usefulapi Your server? Claim it

answering

ReferralHero MCP by usefulapi is answering right now. Last checked 11 min ago. It exposes 28 tools. Last commit 2 Nov 2026.

Read ReferralHero campaigns, subscribers, referrals and rewards; add subscribers and points.

Uptime history 9 days of history · worst day 98%

9 days agonow

100.0%

Uptime 24h

91 of 91 checks

Tools

read from the server

152 ms

Response time

average over 24h

Stars

last commit 2 Nov 2026

What changed 15

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 25 October 2026. No other catalogue keeps this.

2 Nov a tool changed version

31 Oct a tool changed version4 times that day

30 Oct a tool changed version2 times that day

29 Oct a tool changed version2 times that day

28 Oct a tool changed version

27 Oct a tool changed version

25 Oct a tool changed version4 times that day

and 8 more, back to 25 October 2026

ReferralHero MCP by usefulapi missed 3 checks this week

Everything else answered, so this is steady rather than shaky. We check every 15 minutes, which is how a one-off gets told apart from the start of a pattern, and how you hear about the next one within the hour instead of from your users.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 11 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add referralhero --transport http https://referralhero.usefulapi.io/mcp

Settings → Connectors → Add custom connector, then paste this address

https://referralhero.usefulapi.io/mcp

~/.codex/config.toml

[mcp_servers.referralhero]
url = "https://referralhero.usefulapi.io/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "referralhero": {
      "url": "https://referralhero.usefulapi.io/mcp"
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "referralhero": {
      "type": "http",
      "url": "https://referralhero.usefulapi.io/mcp"
    }
  }
}

Available tools 28

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

referralhero

referralhero_add_coupons

WRITE: add coupon codes to an existing coupon group. It only adds codes. POST /lists/{uuid}/coupons.

referralhero_add_points

WRITE: add points to an existing subscriber (not idempotent: each call adds again). May unlock point-based rewards. The subscriber is identified by the campaign's unique identifier. POST /lists/{uuid}/subscribers/add_points.

referralhero_add_subscriber

WRITE: add a subscriber (or a referred person) to a campaign. Give the campaign's unique identifier (email, phone, wallet or custom id). By default ReferralHero sends the subscriber a confirmation (double opt-in) email and any welcome automation of the campaign: set double_optin=false to suppress the confirmation email. Set referrer (a referral code or the referrer's email) to credit a referral. POST /lists/{uuid}/subscribers.

referralhero_confirm_referral

WRITE: confirm a verified referral when its third conversion event happens (campaigns whose goal tracks three events; otherwise ReferralHero returns an error). Confirming can unlock the referrer's rewards and send reward emails. Identify the referral by subscriber_id, or by the campaign's unique identifier. POST /lists/{uuid}/subscribers/{id}/confirm or /subscribers/confirm.

referralhero_create_campaign

WRITE: create a new ReferralHero campaign (list) with a name and a default referral URL. It adds a campaign and changes nothing existing. POST /lists.

referralhero_create_coupon_group

WRITE: create a coupon group for a campaign, optionally with its first coupon codes. It only adds a group. POST /lists/{uuid}/coupon_groups.

referralhero_delete_subscriber

WRITE, DESTRUCTIVE: permanently delete a subscriber from a campaign, with their referral standing. This cannot be undone. DELETE /lists/{uuid}/subscribers/{id}.

referralhero_get_coupon_group

One coupon group with all its coupons (code, available, sent_at). GET /lists/{uuid}/coupon_groups/{id}.

referralhero_get_leaderboard

The leaderboard of a campaign: its top subscribers (10 to 100) with referral counts, points and position. GET /lists/{uuid}/leaderboard.

referralhero_get_subscriber

One subscriber by id: contact data, referral code and link, points, position, referrals by level, status, fraud risk level, tags. Only verified subscribers are found. GET /lists/{uuid}/subscribers/{id}.

referralhero_get_subscriber_by_email

Find one subscriber of a campaign by email. Only verified subscribers are found. GET /lists/{uuid}/subscribers/retrieve_by_email.

referralhero_get_subscriber_by_referral_code

Find the subscriber who owns a referral code (the mwr value in a referral link). Only verified subscribers are found. GET /lists/{uuid}/subscribers/retrieve_by_mwr.

referralhero_list_campaign_rewards

The rewards configured for a campaign (title, description, referrals needed to win each). This is the reward setup, not who earned what: see referralhero_list_unlocked_rewards for that. GET /lists/{uuid}/bonuses.

referralhero_list_campaigns

List the active ReferralHero campaigns (lists) in the account: uuid, name, subscriber count and creation time. The uuid is needed by every other tool. 10 per page. GET /lists.

referralhero_list_coupon_groups

Coupon groups of a campaign (id, name, active flag, coupons with availability), 50 per page. GET /lists/{uuid}/coupon_groups.

referralhero_list_referrals

The people a subscriber referred, 50 per page. scope: all (pending, unconfirmed and confirmed, default), level_1_confirmed, level_2_confirmed, level_3_confirmed (confirmed only, by referral level), level_2_all or level_3_all (every status at that level). GET /lists/{uuid}/subscribers/{id}/{referred|level_N_referrals|level_N_all_referrals}.

referralhero_list_subscriber_rewards

Rewards one subscriber has unlocked, with status, value and coupon code. The reward id is what referralhero_update_reward_status needs. GET /lists/{uuid}/subscribers/{id}/rewards.

referralhero_list_subscribers

List the subscribers of a campaign, 50 per page, with referral code, referral link, points, position, people referred, status and referrer. Sort and filter by the extra fields. GET /lists/{uuid}/subscribers.

referralhero_list_unlocked_rewards

Rewards unlocked by subscribers across a whole campaign: reward name, status (sent, resent, canceled, pending, flagged), value, subscriber email and id, coupon code, transaction. Filter by status to find rewards still to pay out. GET /lists/{uuid}/rewards.

referralhero_promote_subscriber

WRITE: promote a subscriber to the campaign's winners list (contests and giveaways). Only verified subscribers can be promoted; an already promoted subscriber returns an error. POST /lists/{uuid}/subscribers/{id}/promote.

referralhero_qualify_referral

WRITE: mark a referral as qualified, so it counts toward the referrer's rewards. POST /lists/{uuid}/subscribers/{id}/qualify.

referralhero_search_subscribers_by_name

Search subscribers by name across all campaigns of the account, 50 per page. GET /subscribers/search_by_name.

referralhero_track_conversion_event

WRITE: report a conversion event for a referral (campaigns whose goal tracks two or three events). Updates the referral from pending to confirmed (two events) or unconfirmed (three). If the referral is unknown but a referrer is given, the referral is created. May unlock rewards. POST /lists/{uuid}/subscribers/track_referral_conversion_event.

referralhero_track_transaction

WRITE: record a purchase/transaction for a subscriber (amount required) so revenue-based rewards and reports count it (not idempotent unless a transaction_id is reused). The subscriber is identified by the campaign's unique identifier. POST /lists/{uuid}/subscribers/add_transactions.

referralhero_unlock_promoted_reward

WRITE: unlock a promoted-winner or one-off reward for a subscriber. This delivers the reward and may email the subscriber and use coupon codes. POST /lists/{uuid}/subscribers/{id}/unlock_promoted_reward.

referralhero_unqualify_referral

WRITE: mark a referral as unqualified (for example fraud or a refund), so it no longer counts toward the referrer's rewards. POST /lists/{uuid}/subscribers/{id}/unqualify.

referralhero_update_reward_status

WRITE: set the status of an unlocked reward to sent, resent or canceled. Marking sent/resent can trigger the reward delivery email to the subscriber. Get the reward_id from referralhero_list_subscriber_rewards or referralhero_list_unlocked_rewards. POST /lists/{uuid}/subscribers/update_reward_status.

referralhero_update_subscriber

WRITE: change fields of a subscriber (overwrites the given fields): name, contact identifiers, extra fields, points (contest campaigns), tags, address, referral status (qualified/unqualified). Only fields you pass change. Only verified subscribers can be updated. POST /lists/{uuid}/subscribers/{id}.

Endpoints

URL	Transport	State	Latency	Checked
https://referralhero.usefulapi.io/mcp	streamable-http	answering	71 ms	11 min ago

Alternatives to ReferralHero MCP by usefulapi

same job, measured the same way

Enginemailer MCP by usefulapi

by usefulapi

Read Enginemailer subscribers, lists and campaigns; add subscribers, create and send campaigns.

17 tools answering

Referral Rock MCP by usefulapi

by usefulapi

Read Referral Rock programs, members, referrals, rewards and payouts; add members and referrals.

15 tools answering

Viral Loops MCP by usefulapi

by usefulapi

Read campaign stats, participants, referrals, ranks and rewards in Viral Loops.

11 tools answering

Trumpia MCP by usefulapi

by usefulapi

Read Trumpia lists, subscribers, keywords and reports; add contacts and send SMS or email campaigns.

22 tools answering

Mailchimp MCP by usefulapi

by usefulapi

Read audiences, members, campaigns and reports; add, update, tag and archive subscribers.

18 tools answering

Laposta MCP by usefulapi

by usefulapi

Read Laposta lists, members, campaigns and reports; add members and build campaigns.

18 tools answering

AddEvent MCP by usefulapi

by usefulapi

Read AddEvent calendars, events, RSVPs and subscribers; create and update calendars and events.

18 tools answering

iContact MCP by usefulapi

by usefulapi

Read iContact contacts, lists, campaigns and message stats; add contacts and manage subscriptions.

20 tools answering

ReferralHero MCP by usefulapi — questions

Answers built from our own checks of this server.

What can ReferralHero MCP by usefulapi do?

It exposes 28 tools, read directly from the server on our last check. Among them: referralhero_add_coupons, referralhero_add_points, referralhero_add_subscriber, referralhero_confirm_referral, referralhero_create_campaign, referralhero_create_coupon_group and 22 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

Is ReferralHero MCP by usefulapi working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 152 ms. The bar chart above shows every period we have measured.

How do I connect ReferralHero MCP by usefulapi?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does ReferralHero MCP by usefulapi need an API key?

No. ReferralHero MCP by usefulapi completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 28 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is ReferralHero MCP by usefulapi?

It answers our handshake in 152 ms on average, which is faster than 83% of all working MCP servers we measure. That puts it in the quick quarter of the ecosystem. The comparison comes from our own checks across the whole registry, every 15 minutes.

Is ReferralHero MCP by usefulapi open source?

The code is open source: it is published under the MIT licence, written in JavaScript, 1 stars on GitHub and 1 open issue. The licence covers the code in the repository, not the hosted service at referralhero.usefulapi.io, which runs on its operator's own terms.