Genius Referrals MCP. Track every referral, bonus, and payout in chat.

You connect your Genius Referrals account through the Model Context Protocol. Your AI client handles all the heavy lifting for your word-of-mouth marketing data. You don't have to click around in dashboards anymore; you just talk to your referral metrics and get results instantly.

Advocate Management & Onboarding
You can use list_program_advocates to pull a list of every advocate currently signed up for your program. If you need more detail on one specific promoter, run get_advocate_details using their unique ID or code to grab all their associated metadata. Need a new person in the mix? You'll use register_advocate, which takes their info and spits out a fresh, unique referral code for them right away.

Tracking Conversions & Performance
The core of your operation is tracking sales and signups. Run list_tracked_referrals to pull a list of recent events—whether it's a signup or a purchase that happened through the program. If you need to log an event manually, use log_referral_conversion to record that specific conversion type and link it back into the system history.

You can also run list_top_performers to instantly identify who your best advocates are based on their total referrals.

Campaign & System Rules
To keep everything organized, you'll use list_referral_campaigns to see every single marketing campaign set up in the account. For a deep dive into how one of those campaigns works—like checking reward tiers or rule limitations—just hit up get_campaign_details. Before running anything else, though, make sure your setup is solid; run verify_api_connection to check that your API token is linked up right.

Money and Rewards Auditing
Handling the money side of things requires precision. You can use list_awarded_bonuses to pull a list of every bonus or reward that has been officially assigned to an advocate. If someone's waiting for cash out, run list_payout_requests to see exactly what redemption requests they've made and if they’re pending payout.

Account Identity
Finally, you can always check the basic identity info linked to your connection by calling get_my_account. This whole setup lets your agent manage everything—from onboarding a new promoter using register_advocate to monitoring the financial flow with list_payout_requests, and seeing who's making the dough with list_top_performers. It’s all done conversationally, no dashboard clicking required.