# Friendbuy MCP for AI Agents AI Agent Connect > Friendbuy. Manage your referral programs, track rewards, and log conversions through your AI client. It's built for growth teams who need to see who's actually referring customers and ensure rewards get paid out without manual spreadsheet updates. ## Overview - **Category:** marketing-automation - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_T6ZqQ69sJEQhzwScIDPv09uoj0DX6zEnpzOAllnI/ai-agent-connect - **Tags:** referral-marketing, loyalty-programs, conversion-tracking, reward-management, growth-marketing ## Description Friendbuy lets you pull your referral marketing data into your AI client so you can stop hunting through dashboards for basic stats. If you're running a word-of-mouth campaign, you need to know which advocates are driving the most revenue and whether your reward logic is actually firing. This Connector bridges that gap, letting you ask your agent to check a specific referral code's status or pull a list of recent rewards in plain English. You can log new signups or purchases on the fly, making it way easier to handle offline conversions that usually fall through the cracks. It's a huge win for anyone managing loyalty programs who wants to move faster without constant context switching. You'll find this in the Vinkius catalog alongside other marketing tools, and it fits right into your existing workflow. Instead of opening a new tab every time a customer asks about a code, you just ask your agent. It's about getting the right data at the right time without the friction of a traditional UI. ## Tools ### list_referral_rewards See all rewards that have been handed out to your advocates. This helps you identify your top promoters quickly. ### get_referral_code_status Check if a specific referral code is active or expired. Use this to give instant answers to customer inquiries. ### create_referral_code Generate a new, unique referral code for a customer. This lets you issue codes on demand during a live chat. ### check_api_connection Verify that your connection to the Merchant and Developer APIs is working. This is your first step for troubleshooting. ### list_tracked_purchases Pull a list of all purchases attributed to your referral campaigns. Use this to audit your campaign's total revenue. ### list_webhooks View your current webhook configurations. Use this to ensure your internal systems are getting the right notifications. ### track_conversion_purchase Log a specific purchase as a conversion. This triggers the reward lifecycle for the referring advocate. ### track_conversion_signup Record a new user signup as a conversion. This ensures the referral chain stays intact from the start. ## Prompt Examples **Prompt:** ``` Who are our top 3 advocates based on the rewards they've earned? ``` **Response:** ``` I've pulled the recent rewards for you. Here are your top 3 advocates: * **@advocate_pro** (earned 15 rewards) * **@growth_guru** (earned 12 rewards) * **@early_adopter** (earned 9 rewards) Would you like to see the specific purchase values for any of these? ``` **Prompt:** ``` Create a new referral code for a customer named Sarah who wants to share her experience. ``` **Response:** ``` Done! I've generated a new unique code for Sarah: **SARAH-REF-552**. She can start sharing this with her friends right away to start earning rewards. ``` **Prompt:** ``` Did the purchase for order ORD-552 actually trigger a reward? ``` **Response:** ``` Let me check that for you. Yes, the $75 purchase for order **ORD-552** was successfully logged as a conversion. The reward logic for the referring advocate has been triggered automatically. ``` ## Capabilities ### List reward distributions See a full list of rewards handed out to your advocates. ### Log new customer signups Record a new user signup to trigger the referral reward lifecycle. ### Track purchase conversions Log a specific purchase to ensure your advocates get rewarded. ### Create unique referral codes Generate a shareable code for a customer on demand. ### Check code status Verify if a specific referral code is active or expired. ### Monitor webhook configs Check your webhook settings to ensure notifications are flowing. ### Verify API health Confirm your connection to the Merchant and Developer APIs is live. ### View all tracked purchases Pull a list of all purchases attributed to your referral campaigns. ## Use Cases ### Identifying top-performing influencers A growth marketer wants to know who is driving the most signups. They ask the agent to list all rewards and filter by advocate to see the top performers. ### Logging offline retail sales An e-commerce manager needs to log a batch of offline sales. They use the conversion tools to ensure every advocate gets their reward correctly. ### Real-time support for broken codes A support agent gets a DM about a broken code. They use the status check to see if it's expired and then generate a new one for the customer instantly. ### Verifying integration health A developer wants to make sure the connection is live. They use the connection check to verify access to both the Merchant and Developer APIs. ## Benefits - Stop manual tracking by using automated purchase and signup logging to ensure every conversion is captured. - Identify your best advocates by pulling reward distribution lists to see who is actually driving your growth. - Resolve support tickets faster by checking code statuses in real time without ever leaving your chat interface. - Issue codes on the fly to move customers through the funnel faster by generating unique share codes on demand. - Audit your campaign success by pulling all tracked purchases to see exactly how much revenue your referrals are generating. - Keep your systems in sync by monitoring your webhook configurations to ensure real-time notifications are flowing. ## How It Works The bottom line is you get a direct line to your referral data without leaving your chat interface. 1. Grab your Access Key and Secret Key from the Friendbuy Developer Settings. 2. Add these keys to your Connector client configuration. 3. Ask your agent to list rewards or check a code. ## Frequently Asked Questions **Can Friendbuy help me manage my referral program rewards?** Yes, it lets your AI agent list all distributed rewards so you can see exactly who is getting paid and how much. It takes the guesswork out of reward management. **How do I log a purchase that happened offline?** You can just tell your agent to log a purchase for a specific order. The Connector will then handle the conversion tracking so your advocates get their rewards correctly. **Can I check if a customer's referral code is still active?** Absolutely. You can ask your agent to check the status of any specific code. It'll tell you instantly if it's active, expired, or never existed. **How does this Connector help with customer support?** It lets support teams verify conversions and referral statuses in real time. Instead of looking up IDs in a database, you just ask the agent to check the status of a specific customer's code. **Can I use this to see my webhook configurations?** Yes, you can list your webhook configs to make sure your internal systems are receiving the right notifications for every new reward or conversion. **Is it easy to see which referral campaigns are making the most money?** You can ask your agent to list all tracked purchases. It'll pull the data from your campaigns so you can see which ones are actually driving revenue. **What happens if I need to create a code for a VIP customer?** You can tell your agent to generate a share code on the spot. It'll create a unique code for that customer immediately so you can send it over in your chat. **How do I get my API Keys for Friendbuy?** Log in to your Friendbuy account, go to Settings > Developer, and you will find your Access Key and Secret Key. **Can I manually log a purchase through the agent?** Yes! Use the 'track_conversion_purchase' tool. Provide the Order ID, amount, and customer email. If you include the 'referralCode', it will trigger the advocate's reward. **How do I verify if a referral code is still valid?** Use the 'get_referral_code_status' tool. The agent will check the Developer API and return the active status and associated reward value. **Is it possible to list webhooks?** Yes, the 'list_webhooks' tool retrieves all active webhook configurations so you can verify where real-time reward notifications are being sent.