ReferralHero MCP. Manage points, track referrals, and update rewards instantly.

ReferralHero MCP Server: Managing Points and Rewards

Listen up. This server connects your AI client directly to the engine running your viral growth campaigns. You're gonna manage complex referral programs, track every point earned, and keep an eye on leaderboards—all without ever touching a spreadsheet or leaving your chat window. It’s built for people who need action, not fluff.

Forget jumping between your platform UI, your CRM, and some dusty CSV export. You talk to your agent, and the agent does the heavy lifting using specific tools like add_points or get_leaderboard. This gives you real-time control over subscriber balances, campaign performance, and conversion history.

Getting Started: Setting Up Campaigns and Users

You can start by getting a full picture of your operation. Use list_lists to pull names of every active referral campaign running right now. If you need the deep details on one specific program, just run get_list, which pulls all the metadata for that campaign ID. To figure out what kind of rewards are available, check get_rewards; it fetches the current rules and reward tiers set up for any given campaign.

Need to bring a new person into the fold? Use add_subscriber to create a brand-new user record and get 'em enrolled in an active campaign list. If you need to modify someone's profile—say, they hit a new status tier or you gotta change some metadata—you use update_subscriber. Remember that if a participant drops out, you can clean up their account using delete_subscriber.

Tracking Activity and Conversions

Attribution is everything. When someone refers another user, you don't want to guess who gets credit. You use track_conversion; it logs the new referral event and links it straight back to an existing subscriber ID, making sure your attribution tracking is flawless.

Need a headcount of current participants? Run list_subscribers on a campaign ID to pull a list of everyone enrolled in that specific program. For performance checks, you can check out get_subscriber, which pulls all the detailed data—points earned, referrals made—for one individual user.

Monitoring and Adjusting Rewards

The server gives you several ways to track what’s happening. To see who's winning right now, run get_leaderboard. This tool grabs a ranked list of all participants based on points, referrals, or whatever criteria the campaign demands.

If someone needs an immediate boost—maybe they completed a manual task or you just wanna give out a bonus—you execute add_points, which adds a specific number of points directly to that subscriber's account. This is your key tool for manual reward distribution.

Data Integrity and Auditing

When it comes to data cleanup, the server lets you check out list_transactions. It pulls a paginated log covering every recent system activity, including all points awarded and rewards processed across the entire platform. You can also monitor current operational status by running list_subscribers for an overall view of who's in the campaign.

Every single action is available to your AI client. You can pull a list of all active campaigns using list_lists, and you can always check out specific details on one user or one campaign setup through dedicated tools. It treats your entire referral lifecycle—from sign-up to payout—as an actionable command set for your agent.