ReferralHero

ReferralHero MCP Connector for Claude

A+

Automate viral referral campaigns via ReferralHero — manage subscribers, rewards, and leaderboards with AI.

12 tools Official Updated Jun 28, 2026 Official Vinkius Partner

Connect your ReferralHero account to any AI agent and take full control of your viral growth orchestration and referral program management through natural conversation. ReferralHero provides a premier platform for building referral loops, and this integration allows you to retrieve subscriber metadata, monitor campaign leaderboards, and manage rewards directly from your chat interface.

What you can do

  • Campaign & List Orchestration — List all managed referral campaigns and retrieve detailed metadata, including creating and updating subscriber records programmatically.
  • Subscriber Lifecycle Management — Access and monitor individual subscriber profiles and retrieve detailed performance metadata including point balances directly from the AI interface.
  • Leaderboard & Reward Intelligence — Access real-time campaign leaderboards and monitor reward eligibility via natural language to drive program engagement.
  • Conversion & Referral Tracking — Track conversion events and attribute referrals to specific subscribers to ensure your growth loops are always synchronized.
  • Operational Monitoring — Track system activity and manage transaction metadata using simple AI commands.

How it works

  1. Subscribe to this server
  2. Enter your ReferralHero API Token from your account settings
  3. Start managing your referral campaigns from Claude, Cursor, or any MCP-compatible client

No more manual leaderboard exports or subscriber hunting. Your AI acts as a dedicated growth operations manager or referral coordinator.

Who is this for?

  • Growth Marketers & Founders — quickly retrieve campaign summaries and monitor subscriber growth without switching apps.
  • Marketing Operations Teams — automate the management of referral points and track reward distributions via natural conversation.
  • Customer Success Teams — streamline the retrieval of subscriber metadata and monitor referral history directly within the chat.
referralheroviral-growthreferral-apisubscriber-managementleaderboardsrewards-automationgrowth-marketingmcp

12 tools expose this connector's capabilities to your AI agent.

add_points

Add points to a subscriber

add_subscriber

Add a new subscriber to a campaign

delete_subscriber

Remove a subscriber from a campaign

get_leaderboard

Get campaign leaderboard

get_list

Get details for a specific campaign

get_rewards

Get campaign rewards

get_subscriber

Get details for a specific subscriber

list_lists

List all referral campaigns (lists)

list_subscribers

List subscribers for a campaign

list_transactions

List recent transactions

track_conversion

Track a referral conversion event

update_subscriber

Update an existing subscriber

See how to talk to your AI agent using ReferralHero.

List all active referral lists in my account.

I've retrieved your campaigns. You have 3 active lists including 'Early Access Launch' (UUID: list_123) and 'Refer-a-Friend'. Which one would you like to see the leaderboard for?

Show me the leaderboard of top referrers in my active campaign with their reward balances.

Top 10 referrers in "Growth Champions" campaign. #1: James Park with 47 verified referrals ($470 earned, $235 pending). #2: Lisa Wang with 34 referrals ($340 earned). #3: Alex Rivera with 28 referrals ($280 earned). #4-10: combined 89 referrals. Total campaign participants: 456. Active referrers (1+ referral): 234 (51%). Total rewards distributed: $4,560. Pending payouts: $1,230. Campaign viral coefficient: 1.4x. Average referrals per participant: 2.3.

Send a reminder email to all campaign participants who have not shared their referral link yet.

Reminder email sent to 222 inactive participants (those who joined but have 0 referrals). Subject: "Your referral link is waiting! Share & earn $10 per friend". Email includes their unique referral link, one-click social share buttons, and a progress bar showing how close they are to their first reward. Delivery: 218 delivered (98.2%). 4 bounced (invalid emails). Based on previous reminders, expect 15-20% to make their first share within 48 hours.

Yes! Use the `get_subscriber` tool with the List UUID and Subscriber ID. Your agent will respond with complete metadata, including referral counts and current point balances in seconds.

Related Connectors