MCP server

ReferralHero MCP by usefulapi

io.usefulapi/referralhero

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

28

Token cost

About 9,073 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

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

Gemini CLI

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

Cursor

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

VS Code

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

Antigravity

agy mcp add referralhero https://referralhero.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"referralhero","server_url":"https://referralhero.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"referralhero","server_url":"https://referralhero.usefulapi.io/mcp"}

Tools

• referralhero_add_coupons ~216 tokens
  WRITE: add coupon codes to an existing coupon group. It only adds codes. POST /lists/{uuid}/coupons.
• referralhero_add_points ~418 tokens
  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 ~1026 tokens
  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 th
• referralhero_confirm_referral ~510 tokens
  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 ide
• referralhero_create_campaign ~154 tokens
  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 ~236 tokens
  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 Deletes data · ~233 tokens
  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 ~173 tokens
  One coupon group with all its coupons (code, available, sent_at). GET /lists/{uuid}/coupon_groups/{id}.
• referralhero_get_leaderboard ~172 tokens
  The leaderboard of a campaign: its top subscribers (10 to 100) with referral counts, points and position. GET /lists/{uuid}/leaderboard.
• referralhero_get_subscriber ~204 tokens
  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 ~168 tokens
  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 ~198 tokens
  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 ~162 tokens
  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 ~139 tokens
  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 ~179 tokens
  Coupon groups of a campaign (id, name, active flag, coupons with availability), 50 per page. GET /lists/{uuid}/coupon_groups.
• referralhero_list_referrals ~410 tokens
  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|
• referralhero_list_subscriber_rewards ~279 tokens
  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 ~427 tokens
  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 ~284 tokens
  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 ~272 tokens
  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 ~244 tokens
  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 ~155 tokens
  Search subscribers by name across all campaigns of the account, 50 per page. GET /subscribers/search_by_name.
• referralhero_track_conversion_event ~633 tokens
  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}/s
• referralhero_track_transaction ~578 tokens
  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 ~294 tokens
  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 ~258 tokens
  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 ~302 tokens
  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 ~749 tokens
  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}.

Browse

• Email
• Email marketing

Related MCP servers

• Smile.io MCP by usefulapi
  Look up loyalty customers, points history, rewards and VIP tiers, and add points or activities.
• Rewardful MCP by usefulapi
  Browse affiliates, referrals, commissions and payouts, and set up campaigns and affiliates.
• Referral Rock MCP by usefulapi
  Read Referral Rock programs, members, referrals, rewards and payouts; add members and referrals.
• Enginemailer MCP by usefulapi
  Read Enginemailer subscribers, lists and campaigns; add subscribers, create and send campaigns.
• NewsMAN MCP by usefulapi
  Read NewsMAN lists, subscribers, segments, newsletter and automation stats; manage subscribers.
• MailerLite MCP by usefulapi
  Read subscribers, groups, campaigns, fields, segments, automations, webhooks; safe additive writes.
• Crinkl Commerce MCP
  Verified commerce data and proof-backed shopper activation tools for agents.
• iDos Games
  Configure cross-platform and web3 games on iDos Games: live config, tokens, NFTs, AI assets, builds.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/referralhero.svg)](https://aptlynx.net/servers/io.usefulapi/referralhero)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents