Friendbuy MCP. Automate referral tracking and reward payouts instantly.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Friendbuy MCP Server manages your entire referral marketing lifecycle. Connect your AI agent to track purchases, list rewards, and log conversions instantly.
Use tools like `list_referral_rewards` to see who your top promoters are, or `track_conversion_purchase` to log offline sales and trigger payouts automatically.
It centralizes all word-of-mouth tracking and loyalty management in one conversation.
What your AI agents can do
Check api connection
Verifies the current connection status between your AI agent and the Friendbuy API.
Create referral code
Generates a unique, personal share code for a specific customer.
Get referral code status
Checks if a generated referral code is currently active and usable.
Creates unique personal referral codes for customers and checks if those codes are currently active.
Records a completed purchase amount and order ID, triggering the necessary reward payout logic for the advocate.
Records a new user registration event, which can initiate the reward tracking process for the referring advocate.
Lists all rewards that have been distributed, allowing you to filter and identify top-performing advocates.
Retrieves a list of all purchases that the system has linked back to a specific referral campaign.
Checks the API connection health and lists configured webhooks to ensure continuous, real-time data flow.
Ask AI about this MCP
Supported MCP Clients
Gemini Waiting for input…
Friendbuy MCP Server: 8 Tools for Referral Tracking
Use these 8 tools to programmatically generate codes, log sales, and retrieve reward payout history through your AI client.
019d75a1check api connection
Verifies the current connection status between your AI agent and the Friendbuy API.
019d75a1create referral code
Generates a unique, personal share code for a specific customer.
019d75a1get referral code status
Checks if a generated referral code is currently active and usable.
019d75a1list referral rewards
Lists all rewards that have been distributed, allowing you to filter results by advocate.
019d75a1list tracked purchases
Retrieves a list of all purchases that have been logged and attributed to a referral campaign.
019d75a1list webhooks
Shows the configuration details for all webhooks connected to your Friendbuy account.
019d75a1track conversion purchase
Logs a new purchase event, automatically triggering the reward calculation for the referring advocate.
019d75a1track conversion signup
Logs a new user signup event, initiating the reward tracking process for the advocate.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Friendbuy, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Listen up. Connect your AI agent to the Friendbuy MCP Server to handle your whole referral game. This lets your agent track everything from purchases to rewards right in the chat. You'll be able to run your word-of-mouth marketing and loyalty program without lifting a finger.
Generate and Verify Customer Codes
- You can use
create_referral_codeto generate a unique share code for any customer. You'll also useget_referral_code_statusto check if that code is currently active and good to go.
Log Customer Purchases and Signups
- Need to log a sale? Use
track_conversion_purchaseto record a completed purchase amount and order ID. This automatically kicks off the reward calculation for the promoter. If you've got a new user, you can usetrack_conversion_signupto log that signup event, which starts the reward tracking for the advocate.
Retrieve Reward Payout History and Sales Records
- To see who's doing the heavy lifting, run
list_referral_rewards. This lists every reward distributed, and you can filter the results by advocate to spot your top promoters. You can also uselist_tracked_purchasesto pull a list of all purchases the system has linked back to a referral campaign.
Monitor System Connections
- You gotta make sure everything's talking to each other. Run
check_api_connectionto verify the agent's connection status to the Friendbuy API. You can also check the setup usinglist_webhooksto see all the webhooks configured on your Friendbuy account, making sure your data flows in real-time.
How Friendbuy MCP Works
- 1 Subscribe to the Friendbuy MCP Server on Vinkius and input your Friendbuy Access Key and Secret Key.
- 2 Tell your AI agent what you need (e.g., 'List all rewards for last month' or 'Track a $100 purchase').
- 3 The agent calls the appropriate tool, which executes the action and returns the data (e.g., a list of rewards or a confirmation of the logged purchase) directly to your conversation.
The bottom line is you manage complex referral programs by talking to your AI agent instead of clicking through multiple dashboards.
Who Is Friendbuy MCP For?
Growth Marketers need this when they can't afford to manually track every successful referral. E-commerce Ops runs this to automate logging for offline or subscription sales. Customer Support uses it to instantly verify if a customer's referral generated a payout, eliminating dashboard navigation.
Uses the agent to quickly check the status of a specific referral code or pull a list of recent rewards without opening the main dashboard.
Automates the logging of purchases or signups that happen outside the primary e-commerce platform to ensure the referring advocate still gets credited.
Verifies if a customer's referral resulted in a successful conversion by running a simple command and getting instant confirmation.
What Changes When You Connect
- Automated Logging: Use
track_conversion_purchaseortrack_conversion_signupto log purchases or signups outside your main platform. This ensures advocates get credited even if the sale happens offline. - Top Promoter Visibility: Run
list_referral_rewardsto pull a clean list of all distributed rewards. Filter by advocate to immediately identify your most valuable promoters. - Instant Code Management: Need a code? Use
create_referral_codeto generate a unique link for a customer. Then, useget_referral_code_statusto verify it's live before sharing it. - Audit Trail: Quickly pull a list of all attributed sales using
list_tracked_purchases. This gives you a clean, programmatic record of every referral sale. - System Health Check: Before running complex queries, run
check_api_connectionto verify the status of both the Merchant and Developer APIs. This prevents time wasted on failed calls. - Webhook Monitoring: Use
list_webhooksto verify that your internal systems are correctly receiving real-time reward notifications, keeping your operations loop closed.
Real-World Use Cases
Need to log a high-value, offline sale.
A client sold a $5,000 service contract to a friend. They don't want to wait for the friend to manually log it. They ask their agent: 'Track a $5000 purchase for order ORD-999 from user@email.com using code JANE-REF-99.' The agent runs track_conversion_purchase, logging the sale and instantly triggering the reward logic for the advocate Jane.
Identifying the campaign's star advocates.
The Marketing Director needs to know who is driving the most sales right now. They ask the agent to run list_referral_rewards and filter the results by advocate. The agent returns a clean list, pinpointing the top five promoters and their associated payouts.
Onboarding a new user and tracking their first action.
A user signs up through a referral link, but the system needs to log the initial action. The agent runs track_conversion_signup for the user. This logs the event, starts the tracking process, and sets the stage for future purchases.
Debugging a broken referral link.
A customer reports that their referral code isn't working. Instead of checking the dashboard, the agent runs get_referral_code_status for the code. The agent immediately reports if the code is expired, inactive, or valid, solving the issue instantly.
The Tradeoffs
Checking status manually
A user has to navigate to the 'Rewards' tab, filter by date range, then click through multiple pages to find one specific payout.
→
Instead, just ask your agent: 'List all recent referral rewards.' The agent runs list_referral_rewards and returns the filtered list directly in the chat, skipping all the clicking.
Forgetting to log offline sales
A major sale happens in person, but because the e-commerce system wasn't updated, the advocate gets nothing, and the system has no record of the revenue.
→
Always use track_conversion_purchase when a sale happens outside the platform. You provide the order details, and the agent logs the revenue and triggers the reward logic.
Assuming API connection is fine
Running a complex query like list_tracked_purchases only to find out half the data is missing because the connection to the Merchant API is down.
→
Always run check_api_connection first. This verifies both the Merchant and Developer API endpoints are up before you start running critical tracking or listing tools.
When It Fits, When It Doesn't
Use this MCP Server if your core business process involves tracking word-of-mouth growth, rewarding advocates, or managing loyalty programs. You need to automate the logging of conversions (using track_conversion_purchase or track_conversion_signup) and need a single source of truth for all rewards (list_referral_rewards).
Don't use this if your primary need is just general analytics or data warehousing. If you only need to export a static list of all users, a dedicated CRM export tool is better. If you need to manage webhooks for non-referral purposes, use a generic integration tool. This server is specifically for the referral lifecycle.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Friendbuy. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 8 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Tracking every referral conversion shouldn't involve jumping between tabs.
Right now, logging a referral sale means jumping from the sales team's CRM to the website's backend, then manually checking the rewards dashboard. You have to copy the order ID, paste it into the tracking form, and then cross-reference the payout status to ensure the advocate gets paid. It's slow, it's error-prone, and you lose context every time you switch tabs.
With this MCP server, you tell your agent the details—the order ID, the amount, and the code. The agent runs `track_conversion_purchase` and logs the conversion. You get immediate confirmation that the sale was logged and that the reward logic was triggered. The whole process happens in the chat.
Friendbuy MCP Server: See the full referral picture with `list_referral_rewards`.
Before, finding out who the top promoters were meant running complex database queries and building custom reports in a separate BI tool. You had to pull data, clean it, and then visualize it over days.
Now, you simply ask your agent to run `list_referral_rewards`. It pulls the data and displays the list of payouts directly. You get the answer you need, in seconds.
Common Questions About Friendbuy MCP
How do I use the Friendbuy MCP Server to log a purchase? +
To log a purchase, use the agent to run the track_conversion_purchase tool. You just need to provide the order ID, the amount, and the referring code in your prompt.
Can I check if a referral code is still active using the Friendbuy MCP Server? +
Yes. Use the get_referral_code_status tool. It checks the code status instantly and tells you if the code is valid or expired.
How do I list all the rewards paid out using Friendbuy MCP Server? +
Run the list_referral_rewards tool. You can filter the results by advocate to see exactly who received rewards and for what.
What is the difference between `list_tracked_purchases` and `list_referral_rewards`? +
list_tracked_purchases shows a list of sales logged to the system. list_referral_rewards shows the actual payouts that were distributed to the advocates.
Do I need to check the API connection first with Friendbuy MCP Server? +
Yes. It's best practice to run check_api_connection first. This verifies that the server can communicate with the Friendbuy APIs before you attempt any critical tracking or listing operations.
How do I use the `create_referral_code` tool to ensure a customer receives a unique code? +
The create_referral_code tool generates a unique, shareable code for any specified customer. This code is instantly available for the customer to use, ensuring they receive a unique identifier for tracking.
What is the purpose of the `list_webhooks` tool in the Friendbuy MCP Server? +
The list_webhooks tool shows all webhooks currently configured in your Friendbuy account. You can use this to verify which internal systems are set up to receive real-time reward notifications.
Does the Friendbuy MCP Server support logging multiple conversions at once? +
While the tools are designed for single actions, you can call track_conversion_purchase or track_conversion_signup sequentially within your agent's logic. This allows your agent to process multiple events in a single workflow.
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.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Offerslook
Manage performance marketing via Offerslook — track offers, advertisers, and affiliates directly from your AI agent.
Hotjar
Understand your users with heatmaps, session recordings, and feedback surveys that reveal exactly why visitors leave your site.
Quentn
Build email marketing funnels with visual automation workflows designed for German-speaking markets and GDPR compliance.
You might also like
Baidu Map Web Service API
Dominant mapping and LBS platform in China — retrieve coordinates, routing, and POI data via AI.
Oracle NetSuite
Manage financials, sales orders, inventory, and customer records on Oracle NetSuite — the leading cloud ERP.
Freightview
Automate LTL freight quoting, track shipments, and manage carriers via AI agents with Freightview.