io.usefulapi/referralhero

up checked 2026-11-11T09:39:07.023Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

ReferralHero MCP by usefulapi

Publisher-provided description

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

Summary by lookupd

Read and manage referral campaigns, subscribers, referrals and rewards, including adding points, coupons and destructive subscriber…

Install

Claude Code, remote (streamable-http)

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

Codex, remote (streamable-http)

codex mcp add referralhero --url https://referralhero.usefulapi.io/mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

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

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (28 tools)

Publisher-provided 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 pa
• 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_u
• 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 t
• 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
• 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_
• 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
• 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
• 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}/subscr
• 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
• referralhero_update_subscriber WRITE: change fields of a subscriber (overwrites the given fields): name, contact identifiers, extra fields, points (contest campaigns), tags, address, referral
• 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
• 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
• 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).
• 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) o
• 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}
• 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 r
• 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/{uui
• 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 re
• 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.

Details

• Version: 1.16.3
• Transports: streamable-http
• Uptime (7 days): 100%
• Median latency: 368 ms
• First indexed: 2026-11-01T10:05:55.761Z
• Last seen in registry: 2026-11-11T00:17:32.283Z
• Repository: https://github.com/m190/usefulapi-mcp
• Website: https://usefulapi.io/referralhero/

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.usefulapi/referralhero.svg)](https://lookupd.com/servers/io.usefulapi/referralhero)

• 62092 servers
• Last crawl: 2026-11-11T17:38:11.606Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp