# ReferralCandy MCP for AI Agents AI Agent Connect > ReferralCandy connects your AI agents to your referral marketing platform. Use it to track advocates, register purchases, and manage campaigns automatically. It gives your agent the ability to handle the heavy lifting of referral management without you having to jump between tabs. ## Overview - **Category:** marketing-automation - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_eG1Py5hwoX7p4PUIirdJz4Buql319kJkEA85tWI4/ai-agent-connect - **Tags:** referral-marketing, affiliates, loyalty, ecommerce ## Description ReferralCandy lets your AI agent take over the repetitive parts of managing your affiliate and referral programs. Instead of manually checking who your top advocates are or digging through spreadsheets to see which purchases were actually referred, your agent can do it in seconds. You can ask your agent to find everyone who referred a customer last month, pull a list of pending rewards that need to be paid out, or even send out new referral invites to your best customers. It handles the data heavy lifting so you can focus on growth. By connecting this Connector through Vinkius, you turn your natural language workspace into a command center for your entire referral ecosystem. You can quickly register new orders to trigger rewards, monitor campaign performance, and keep your advocates happy without ever opening the dashboard yourself. This means you don't have to worry about missing a payout or forgetting to send an invite to a high-performing user. It's a simple way to keep your marketing moving without the usual administrative headaches. It makes the whole process of managing a large network of promoters feel much smaller and more manageable. ## Tools ### send_invite Send a referral invitation to a customer. Use this to kick off new referral activity immediately. ### get_referral Get the details of a specific referral. This helps you look into the history of a single customer's referral activity. ### get_referrer Pull the profile of a specific advocate. Use this to see who your best referrers are and what they've done. ### get_stats Pull the overall statistics for your referral program. It gives you a high-level view of how everything is performing. ### get_top_referrers Identify your highest-performing advocates. This is perfect for finding your VIPs for special rewards. ### list_campaigns Get a full list of all active and past campaigns. Use this to see the breadth of your referral marketing. ### list_invites See a list of all the referral invites you've sent out. It helps you track your outreach volume. ### list_pending_rewards See which rewards are waiting to be processed. This makes it easy to manage your payout queue. ### list_purchases List all the purchases that came through referrals. This is how you verify your attribution data. ### list_referrals_by_period Pull a list of referrals from a specific timeframe. Use this to see how your program performed last week or month. ### list_referrers Pull a list of every advocate in your program. Use this to see your entire network of promoters. ### list_rewards Get a full list of all rewards. This helps you see the total volume of incentives distributed. ### register_purchase Log a new purchase to the system. This triggers the referral rewards and updates your advocate's stats. ### check_referralcandy_status Verify that your connection to the platform is active. It's the first thing to check if your agent isn't pulling data. ### get_campaign Pull specific details about a single campaign. Use this to see the current status of a targeted marketing push. ### list_referrals Get a complete list of every referral in your program. This is your master list of all referral activity. ## Prompt Examples **Prompt:** ``` Who are our top 5 referrers right now? ``` **Response:** ``` Here are your top 5 advocates based on the latest data: | Advocate | Referrals | Revenue | | :--- | :--- | :--- | | Sarah Jenkins | 42 | $1,200 | | Michael T. | 38 | $950 | | Elena R. | 31 | $700 | | David W. | 29 | $620 | | Chloe S. | 25 | $500 | Would you like me to send a special invite to any of them? ``` **Prompt:** ``` Register a purchase of $200 for order #5542 by customer@email.com. It was referred by advocate 'Sarah Jenkins'. ``` **Response:** ``` I've registered that purchase for you. **Order #5542** - **Amount**: $200.00 - **Status**: Logged successfully - **Attribution**: Sarah Jenkins - **Reward**: A pending reward of $20 has been queued for Sarah. ``` **Prompt:** ``` How many referrals did we get in the last 30 days? ``` **Response:** ``` I've pulled the referral data for the last 30 days. - **Total Referrals**: 142 - **New Advocates**: 12 - **Total Revenue**: $4,560.00 Would you like a full list of those referrals or a breakdown by campaign? ``` ## Capabilities ### Track top-performing advocates Identify your highest-performing promoters instantly to see who is driving the most revenue. ### Register new customer purchases Log sales to the system so rewards are automatically attributed to the correct advocates. ### Send out referral invitations Get new invitations out to your customers immediately through a simple chat command. ### Monitor pending reward payouts See exactly which rewards are waiting to be processed so you can keep your payouts on schedule. ### Pull referral stats by date range Get a clear look at your referral growth over specific periods for your weekly or monthly reports. ## Use Cases ### Identifying VIP advocates for a gift A growth marketer needs to find the top 10 advocates to send a thank-you gift. They ask the agent to use get_top_referrers and then send_invite to those specific people. ### Attributing offline sales An e-commerce store has an offline sale they need to attribute. The manager asks the agent to use register_purchase to log the sale and link it to the correct advocate. ### Pulling weekly growth reports A team needs to report on last month's referral growth. They ask the agent to use list_referrals_by_period to get the data for a specific date range. ### Checking campaign status A manager wants to see if the Summer Sale campaign is working. They ask the agent to use get_campaign to see the current status and performance metrics. ## Benefits - Stop manual data entry by using register_purchase to automatically attribute sales to your advocates. This saves you from having to log into the dashboard every time a customer makes a purchase. - Identify your best promoters instantly with get_top_referrers instead of filtering through a dashboard. You can quickly see who your VIPs are and decide who deserves a special thank you. - Keep your payout queue clean by using list_pending_rewards to see exactly what needs to be paid out. It ensures no advocate gets left behind when it's time to distribute your rewards. - Speed up outreach by using send_invite to get invitations out to customers in seconds. You can run your referral loops much faster without the friction of manual email sending. - Get clear performance updates by using list_referrals_by_period to see growth over specific dates. This makes it easy to pull data for your weekly reports without any extra work. ## How It Works The bottom line is you get a conversational interface for your entire referral marketing backend. 1. Subscribe to the ReferralCandy MCP on Vinkius. 2. Enter your API keys from the ReferralCandy developer settings. 3. Start asking your agent to manage campaigns or check advocate stats. ## Frequently Asked Questions **Can the ReferralCandy MCP help me manage my affiliate program?** Yes. It lets your AI agent interact with your ReferralCandy account to pull stats, manage campaigns, and handle advocate data through a simple chat interface. **How do I use ReferralCandy with my AI agent to track sales?** You can use the Connector to register purchases. Your agent will take the order details and attribute them to the correct advocate automatically. **Can I send referral invites using the ReferralCandy MCP?** Yes, your agent can send invites directly. This makes it much faster to reach out to customers and start new referral loops. **Is ReferralCandy MCP good for checking pending rewards?** It's perfect for that. You can ask your agent to list all pending rewards so you know exactly what needs to be paid out without checking the dashboard. **Can I get specific reports from ReferralCandy using this Connector?** You can. Your agent can pull referrals by specific periods, which is great for creating weekly or monthly growth reports quickly. **Does the ReferralCandy MCP work with my current marketing tools?** It works with any MCP-compatible client like Claude or Cursor, allowing you to bring your referral data into your existing AI workspace. **Can my AI automatically register a new purchase to trigger a referral reward?** Yes! Use the `register_purchase` tool providing the buyer's email, order amount, and order ID. Your agent will send this data to ReferralCandy, triggering the referral attribution and payout flow instantly. **How do I easily find out who my best performing advocates are?** Simply ask the agent to run the `get_top_referrers` action. It will compile your highest-performing ambassadors ranked by total successful referrals and the total revenue they generated for your store. **Can I check if a specific customer has any pending referral rewards?** Absolutely. By using the `list_pending_rewards` tool and filtering by the customer's email, your agent can instantly fetch their reward status and payout timeline without you needing to open the dashboard.