ReferralHero MCP by usefulapi

MCP server · hosted · v1.0.0 · io.usefulapi/referralhero

Online · tested 1h agoNEW · 2h agoSeen in the registry 1h ago

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

What it does

ReferralHero MCP by usefulapi is an MCP server, a connector that lets an AI assistant use it as a tool. It is hosted: an assistant connects to it over the internet, nothing to install.

No capability identified yet from its description.

Facts come from the Official MCP Registry, as declared by the publisher. Capabilities are matched automatically (low confidence). None of this is a test of the tool.

At a glance

Hosted (remote)YES

Local installNO

Live checkOnline · 28 tools

Version1.0.0

PriceNot in the registry

First seen24 Oct 2026

Last checked1h ago

How to connect

As declared in the Official MCP Registry · hosted endpoint tested by Electra Index 1h ago (live check)

Hosted endpoint

https://referralhero.usefulapi.io/mcp streamable-http

In Claude Code: claude mcp add --transport http referralhero-mcp-by-usefulapi https://referralhero.usefulapi.io/mcp

MCP settings (Claude Desktop, Cursor and other MCP clients)

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

Live check

Electra Index connected to the hosted endpoint 1h ago

ONLINE ReferralHero MCP by usefulapi answered an MCP connection on 24 Oct 2026 and introduced itself as referralhero-mcp 1.0.0 (MCP protocol 2025-06-18).

28 tools offered to AI assistants

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_get_leaderboard · The leaderboard of a campaign: its top subscribers (10 to 100) with referral counts, points and position. GET /lists/{uuid}/leaderboard.
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_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_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_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_search_subscribers_by_name · Search subscribers by name across all campaigns of the account, 50 per page. GET /subscribers/search_by_name.
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 a
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
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.

Show 16 more

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_get_coupon_group · One coupon group with all its coupons (code, available, sent_at). GET /lists/{uuid}/coupon_groups/{id}.
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 autom
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 subs
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_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_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
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 th
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 r
referralhero_qualify_referral · WRITE: mark a referral as qualified, so it counts toward the referrer's rewards. POST /lists/{uuid}/subscribers/{id}/qualify.
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_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_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_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_
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_add_coupons · WRITE: add coupon codes to an existing coupon group. It only adds codes. POST /lists/{uuid}/coupons.

What "online" means: the server answered an MCP connection at the time of the check. It is not a guarantee of security, quality or continuous uptime. How we test: we open an MCP session and ask for the tool list, as an AI assistant would. We never run a tool and never send a key. Checked every few days. Method

Is this your server? Monitoring Pro: a check every 30 minutes and an email within the hour when it stops answering. Launch offer: $39.99 once, for life.

Facts & evidence

Each fact shows where it was seen and when.

Fact	Value	Evidence	Source	Last confirmed
Hosted endpoint	https://referralhero.usefulapi.io/mcp	DECLARED	SRC-001 Official MCP Registry	1h ago
Local install (package)	no	DECLARED	SRC-001 Official MCP Registry	1h ago
Remote access (hosted)	yes	DECLARED	SRC-001 Official MCP Registry	1h ago
Website	https://usefulapi.io/referralhero/	DECLARED	SRC-001 Official MCP Registry	1h ago
Repository	https://github.com/m190/usefulapi-mcp	DECLARED	SRC-001 Official MCP Registry	1h ago
Registry status	active	DECLARED	SRC-001 Official MCP Registry	1h ago
Version	1.0.0	DECLARED	SRC-001 Official MCP Registry	1h ago
MCP server	yes	DECLARED	SRC-001 Official MCP Registry	1h ago

Change history

NEW24 Oct 2026
first seen in the index

Is this page accurate?

Flag it and our robot re-checks the official source. Reports never change a score.

Is ReferralHero MCP by usefulapi still online?

Free alerts · no account

Questions about ReferralHero MCP by usefulapi

How do I connect ReferralHero MCP by usefulapi?

Use the hosted endpoint https://referralhero.usefulapi.io/mcp in your assistant's MCP settings. The exact settings are in "How to connect" above, as declared in the Official MCP Registry.

What tools does ReferralHero MCP by usefulapi offer?

When Electra Index connected on 24 Oct 2026, it listed 28 tools: referralhero_list_campaigns, referralhero_get_leaderboard, referralhero_list_campaign_rewards, referralhero_create_campaign, referralhero_list_subscribers, referralhero_get_subscriber, referralhero_get_subscriber_by_email, referralhero_get_subscriber_by_referral_code and more. The full list is in "Live check" above.

Is ReferralHero MCP by usefulapi online?

Yes. Its hosted endpoint answered an MCP connection from Electra Index 1h ago.