ReferralCandy MCP. Process referrals, track rewards, and manage advocates in chat.

ReferralCandy gives your AI agent full control over managing your entire affiliate and referral program. You'll use this server to let your agent handle everything from tracking a new sign-up to processing payments, all without you having to log into the platform yourself.

Analyzing Program Performance

You can get a complete picture of how your referrals are doing across several tools. Your agent pulls overall performance statistics using get_stats. To see who's driving sales, it identifies and lists the top-performing advocates via get_top_referrers, or you can pull the full directory list of every advocate signed up with list_referrers.

When you need deep data on a single user, your agent pulls all specific details about an individual referred customer using get_referral and fetches the profile information for a specific referring advocate through get_referrer.

To track sales activity, your agent reads every referral recorded in the program's history with list_referrals, or it filters results to focus on a narrow time window by calling list_referrals_by_period. For purchase data, you can list all purchases made by referred users—including order IDs and attribution details—using list_purchases. You'll also find that your agent checks the activity of your system connection using check_referralcandy_status to make sure everything's running smoothly.

Managing Transactions and Rewards

When a sale happens, you don't want to wait for manual processing. Your agent handles it instantly: calling register_purchase manually logs the purchase event. This action triggers the automatic calculation of rewards and queues up any necessary payouts for the advocate involved in that sale.

For payout management, your agent checks what needs paying out by running list_pending_rewards. You can also review your reward catalog and status list using list_rewards to ensure you're always set up with current incentives. If you need targeted marketing, your agent sends a new referral invitation directly to a specified user or group through send_invite, keeping your program active.

Controlling Campaigns and System Data

Your agent manages the underlying structure of your programs too. It provides full details for a specific referral marketing campaign using get_campaign, and it also fetches all existing campaigns when you call list_campaigns. If you need to know what invitations have been sent out, past or current, calling list_invites shows that history.

To keep track of cash flow, your agent can list every reward type available in the system using list_rewards, and it also gives a full inventory of all rewards that are due but haven't cleared yet by listing pending payouts via list_pending_rewards. You don't need to log in; your AI client does the heavy lifting for you.