# Genius Referrals MCP for AI Agents AI Agent Connect > Genius Referrals MCP lets you manage your entire referral program and advocate network through your AI client. You can register new promoters, track conversion statuses, and monitor reward payouts without jumping back and forth between tabs. It bridges the gap between your marketing dashboard and your daily workspace, making it easy to audit performance and handle redemption requests in plain English. ## Overview - **Category:** marketing-automation - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_OgLsxtVlreJNeDwOOcKbC6vgbNbeeBCWHF3wkIT5/ai-agent-connect - **Tags:** referral-marketing, advocate-management, word-of-mouth, campaign-tracking, rewards-program ## Description Connect your Genius Referrals account to your AI agent to automate how you handle your referral marketing and advocate engagement. If you're running a word-of-mouth program, you know the pain of jumping between tabs to see who's actually converting or checking if a reward was sent out. This Connector fixes that by bringing your advocate database and campaign data directly into your daily workspace. You can pull a list of your top-performing partners, check the status of a specific signup, or see which bonuses have been distributed with simple prompts. It handles the data retrieval so you can focus on strategy. When you host this on the Vinkius Marketplace, your agent gets a direct line to your program's rules and advocate metadata. You can register new promoters on the fly or audit reward distributions without manual navigation. It turns a clunky reporting process into a conversational one, keeping your marketing data accessible exactly where you're already working. ## Tools ### list_payout_requests See which advocates are asking for their rewards. Use this to manage your payout queue. ### list_tracked_referrals See the history of all referral events like signups and purchases. This helps you track actual conversions. ### get_campaign_details Get metadata for a specific referral campaign. This helps you see the rules and reward structures in one place. ### list_program_advocates See a full list of everyone in your advocate program. It's the fastest way to see your total promoter count. ### list_awarded_bonuses View all rewards and bonuses that have been handed out. Use this to audit your program's spending. ### verify_api_connection Check if your AI client is correctly connected to the platform. Use this to troubleshoot your setup. ### register_advocate Add a new person to your advocate database with one command. This saves you from manual data entry. ### log_referral_conversion Record a specific signup or purchase as a successful referral. Use this to track manual conversions. ### get_my_account Pull your account identity and basic profile information. This helps the agent know who it's working for. ### get_advocate_details Get specific metadata for an individual advocate. Use this to see a promoter's specific stats. ### list_referral_campaigns See all the referral campaigns you have active. This gives you a high-level view of your marketing efforts. ### list_top_performers Identify which advocates are bringing in the most business. Use this to find your best partners. ## Prompt Examples **Prompt:** ``` Who are my top 5 advocates and how many referrals did they make? ``` **Response:** ``` Here are your top 5 performing advocates: | Advocate | Total Referrals | | :--- | :--- | | **Sarah Jenkins** | 42 | | **Michael Chen** | 38 | | **Elena Rodriguez** | 31 | | **David Park** | 29 | | **Jessica Wu** | 27 | Would you like to see the specific conversion details for any of these partners? ``` **Prompt:** ``` Did Jane Smith's referral for the Fall Friends campaign get verified? ``` **Response:** ``` I've checked the status for Jane Smith's referral: * **Status:** ✅ Verified * **Campaign:** Fall Friends * **Reward Amount:** $50.00 * **Date:** October 12, 2025 The bonus has been successfully applied to her account. ``` **Prompt:** ``` List all the pending payout requests from the last 24 hours. ``` **Response:** ``` There are currently 3 pending payout requests: 1. **Mark Thompson** - $75.00 (Pending Review) 2. **Linda Garcia** - $100.00 (Awaiting Approval) 3. **Kevin Lee** - $50.00 (Pending Review) Would you like me to pull the advocate details for any of these requests? ``` ## Capabilities ### Register new advocates Add new promoters to your program instantly through your agent. ### Track conversion statuses Check if a referral signup or purchase is verified or still pending. ### Audit reward payouts See which bonuses have been distributed to your advocates. ### Fetch campaign rules Pull the specific reward structures and rules for any active campaign. ### Identify top performers Get a list of your highest-converting advocates to prioritize your efforts. ### Monitor redemption requests See which advocates are trying to claim their earned rewards. ## Use Cases ### The Manual Registration Headache A marketer is onboarding 50 new advocates. Instead of typing them into a dashboard, they ask the agent to register_advocate for each one from a list. ### The Did It Go Through Query A customer asks if their friend's referral worked. The agent uses list_tracked_referrals to check the status and gives an instant answer. ### The Reward Audit An ops manager needs to see if the Fall Friends campaign is paying out correctly. They use list_awarded_bonuses and get_campaign_details to compare. ### The VIP Outreach A growth lead wants to send a thank-you note to the top 10 advocates. They use list_top_performers to get the names and contact info instantly. ## Benefits - Stop manual data entry by using register_advocate to add new promoters directly from a chat. - Get instant clarity on conversion status by using list_tracked_referrals to see what's pending. - Audit your program's health faster by using list_awarded_bonuses to see reward distribution. - Identify your best partners quickly using list_top_performers to focus on high-value advocates. - Access campaign rules on demand with get_campaign_details without digging through settings. - Keep your team in the loop by using list_payout_requests to monitor redemption status. ## How It Works The bottom line is it turns your referral dashboard into a conversational interface for your AI agent. 1. Subscribe to this Connector on the Vinkius Marketplace. 2. Grab your API Token from the Genius Referrals Settings menu. 3. Connect the Connector to your AI client and start asking questions about your advocates. ## Frequently Asked Questions **How does Genius Referrals MCP help with my marketing?** It connects your referral program data directly to your AI agent. This lets you check conversion stats, manage advocates, and track rewards using natural language instead of clicking through a dashboard. **Can I use it to add new advocates to my program?** Yes, you can use your agent to register new advocates instantly. This saves you from having to manually enter their information into the Genius Referrals platform. **Can I check if my referral rewards were actually sent?** Absolutely. You can ask your agent to check the status of any reward or payout request to see if it's been verified, approved, or sent. **How do I see which advocates are performing the best?** The Connector allows your agent to identify and list your top performers. You can quickly see who is driving the most conversions to help prioritize your outreach. **Does this Connector help me track campaign signups?** Yes, it tracks referral events like signups and purchases. You can ask your agent for the history of these conversions to see how your campaigns are performing. **Can I see the specific rules for my referral campaigns?** Yes, you can pull the specific reward structures and rules for any active campaign. This helps you answer advocate questions quickly without looking up the rules manually. **How do I get an API Token for Genius Referrals?** Log in to your Genius Referrals dashboard, click your name in the top-left corner, and select 'API Access' to find your API token. **Can I manually track a referral conversion via the agent?** Yes! Use the 'log_referral_conversion' tool. You must provide the advocate's email and the email of the person they referred to trigger the tracking logic. **How do I register a new advocate through the chat?** Use the 'register_advocate' tool and provide the person's email and full name. The agent will add them to your program and generate their referral link. **Is it possible to see who my best advocates are?** Yes, the 'list_top_performers' tool retrieves a list of advocates sorted by their referral count, helping you identify your most active promoters.