ReferralHero MCP by usefulapi

Install

Pick the AI app you use, then copy the settings.

Passed 4/4 checks · What you ask goes through the maker’s server (referralhero.usefulapi.io) · ✓ Commands checked Nov 13, 2026

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

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

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

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

All apps, with pros and cons →

What it can do

Tool names and descriptions exactly as the server reported them on Nov 14, 2026. The maker wrote them, not us; we show them as plain text.

• 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 at that level). GET /lists/{uuid}/subscri

• 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_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_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 automation of the campaign: set double_optin=

• 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/{uui

• 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 /lists/{uuid}/subscribers/add_transacti

• 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 c

• 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.

• 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_rewards. POST /lists/{uuid}/subscribers/

• 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.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 15, 2026

• ✓ Pass

  Maker matches the repo

  The registry name was verified against the domain usefulapi.io (the registry checks domain ownership)

• ✓ Pass

  Still maintained

  Code last changed yesterday

• – Not applicable

  Has a licence

  Not applicable: a cloud server run by the owner of usefulapi.io; you don't run code from the repo

• ✓ Pass

  Endpoint responds

  Responded in 13 ms (HTTP 200)

• – Not applicable

  Sign-in with OAuth

  No sign-in needed

• ✓ Pass

  No hidden instructions in tool descriptions

  Read 28 tool descriptions and found no hidden instructions to the AI

What we check → · JSON

User reviews

No reviews yet

Sign in with Google to write a review

Compared with others in Marketing & social mediai

• More stars than 0% of the other 3956 servers in this category
• Published to the registry more recently than 97% of the other 3956 servers in this category
• Basic checks equal to or better than 100% of the other 3956 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Relaticle

Open-source CRM your AI agents can write to: companies, people, opportunities, tasks and notes.

by relaticle·Growing·★ 1.8K·Updated 2 days ago

Runs in the cloud✓ service owner · relaticle.com

How to connect

ChatbotX

Omnichannel customer messaging, CRM contacts, flows, sequences, broadcasts, and AI automation.

by ChatbotXIO·Growing·★ 1.1K Stars for the whole repo·Updated 9 days ago

Runs in the cloud✓ service owner · chatbotx.io

How to connect

X (Twitter) MCP Server by Xquik

Xquik is the world's fastest and cheapest X (Twitter) data API with the most complete X data.

by Xquik-dev·Growing·★ 229·Updated 3 days ago

Runs in the cloud✓ xquik.com

How to connect

Betterlytics

Query your Betterlytics web analytics from AI agents: traffic, funnels, journeys, errors, uptime.

by betterlytics·Growing·★ 180·Updated 3 months ago

Runs in the cloud✓ service owner · betterlytics.io

How to connect

BibiGPT YouTube Video Summarizer

AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.

by JimmyLv·Growing·★ 141·Updated 18 days ago

Runs in the cloud✓ service owner · bibigpt.co

How to connect

• Relaticle — Runs in the cloud, nothing to install · No key needed
• ChatbotX — Runs in the cloud, nothing to install · No key needed
• X (Twitter) MCP Server by Xquik — Runs in the cloud, nothing to install · No key needed
• Betterlytics — Runs in the cloud, nothing to install · Needs a key
• BibiGPT YouTube Video Summarizer — Runs in the cloud, nothing to install · No key needed

README from the maker

{