Supercharge your AI with Friendbuy. Manage Rewards and Track Conversions via AI Chat
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Connect to your AI in seconds.
Friendbuy MCP helps you automate your entire referral program. Use it to manage customer loyalty, track every conversion, and distribute rewards without logging into the dashboard.
You can check a code's status instantly, log purchases after the fact, or list all recent reward payouts—all through natural conversation with any compatible AI client.
What your AI can do
Get referral code status
Checks if a given referral code is currently active and what its status is.
Create referral code
Generates a new, unique sharing code for a specific user to use in their referral campaign.
Check api connection
Tests the live connection status between your system and Friendbuy's APIs.
Verifies that the connection between your system and Friendbuy is active and authorized.
Creates new, unique referral codes for specific customers to share with their network.
Checks whether a given referral code is active and if it has already been used.
Retrieves a list of all recent reward distributions, allowing you to filter results by the advocate who earned them.
Records purchase events and revenue totals into the referral system, triggering reward logic for advocates.
Registers new user signups as a conversion event to ensure rewards are triggered correctly.
Ask an AI about this
Compatible AI Apps
OAuth 2.0 Compatible Gemini Waiting for input…
Friendbuy: 8 Available Tools
Use these tools to orchestrate the entire referral process—from generating unique codes to tracking final purchases and listing all rewards.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Friendbuy on VinkiusGet Referral Code Status
Checks if a given referral code is currently active and what its status is.
Create Referral Code
Generates a new, unique sharing code for a specific user to use in their referral...
Check Api Connection
Tests the live connection status between your system and Friendbuy's APIs.
List Tracked Purchases
Pulls a record of every purchase that has been officially attributed and tracked...
List Referral Rewards
Retrieves a list of all reward payouts, which you can filter to see who your top...
List Webhooks
Displays all webhooks you have set up to ensure your internal systems receive real-time notifications.
Track Conversion Purchase
Records a purchase event and its value, which triggers the reward logic for the associated advocate.
Track Conversion Signup
Logs a new user sign-up as a conversion to ensure rewards are correctly distributed.
Connect to your AI in seconds. Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Claude AI
Open Claude Settings
Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
Add Custom Connector
Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:
https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp
Replace [YOUR_TOKEN_HERE] with your token from
cloud.vinkius.com. For OAuth-protected servers, expand Advanced
settings to add credentials.
Start a conversation
Open a new chat. The Friendbuy integration is available immediately — no restart needed.
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 5,000+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,000+ 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
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 connection provides 8 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Tracking referrals usually means clicking through four different tabs.
Today, managing a referral campaign is tedious. You check one dashboard for code status, then open another to list purchases, and finally jump to a third tool just to see if the reward was actually paid out. It's a lot of context switching, and it’s easy to miss a conversion.
With this MCP, you tell your agent what happened—like logging an offline sale or checking a code status—and it handles all the backend logic in one go. You get immediate confirmation that the reward cycle was triggered.
Logging purchases with `track_conversion_purchase` makes everything accurate.
Before, if a customer bought something outside of your standard checkout flow, you had to manually update the system and hope no one missed it. That gap meant potential lost rewards or inaccurate reporting on who your top promoters were.
Now, running `track_conversion_purchase` logs that sale instantly. Your agent ensures that every dollar spent gets recorded in the reward logic, giving you a clear picture of performance.
What your AI can actually do with this
This connector lets your agent run word-of-mouth campaigns and handle customer loyalty programs for e-commerce brands. You don’t have to manually check dashboards or update spreadsheets every time someone makes a purchase or signs up. Your agent handles the entire lifecycle: it can instantly create unique referral codes for customers, log conversions—even if they happen offline—and ensure that rewards are distributed correctly and on time.
If you're building out your marketing automation tools, connecting Friendbuy through Vinkius gives your AI client access to this core logic right where you need it, allowing you to manage complex reward payouts just by asking a question.
019d75a1-202a-7247-b8aa-37562291c426 
Here's how it actually works
The bottom line is that you manage complex referral logic using plain language commands, without writing any backend code.
Subscribe to this MCP on Vinkius and provide your Friendbuy Access Key and Secret Key.
Connect your preferred AI client, like Cursor or Claude, to the catalog.
Ask your agent a direct question—like 'List all rewards for Jane'—and the MCP handles the rest.
Who is this actually for?
This is for the growth marketer who gets annoyed clicking through five different dashboards just to check one customer's reward status. It’s also for the e-commerce ops manager whose job involves logging purchases that didn't happen online.
Logs offline or subscription purchases into the system to make sure advocates get credited and rewarded.
Quickly checks if a specific referral code is active, listing recent payouts without navigating the platform's dashboard.
Verifies in real time whether a customer’s sign-up or purchase was successful and attributed to a referral campaign.
What Changes When You Connect
You stop clicking through dashboards. Need to know if a code works? Just ask your agent, and it runs the get_referral_code_status tool instantly.
Logging purchases is fast. Instead of manual data entry, you use track_conversion_purchase to log sales immediately, ensuring advocates get paid without delay.
Audit rewards with confidence. You can run list_referral_rewards through your agent and filter the results by advocate name to see who's doing the heavy lifting.
Automation for signups is key. If a user signs up via an unconventional channel, running track_conversion_signup logs it instantly so rewards aren't forgotten.
Visibility into system health. You can run list_webhooks to confirm your internal systems are set up to receive real-time notifications when conversions happen.
See it in action
Tracking a large, recent campaign payout
A marketing lead asks: 'What rewards did we pay out last week?' Your agent runs list_referral_rewards and immediately returns the top 5 advocates and how much they earned. No spreadsheet needed.
Logging a major offline sale
The ops team member knows about a big, in-store order but can't access the backend. They tell their agent to run track_conversion_purchase for $200 on 'Order XYZ', and the system logs it immediately.
Investigating a suspicious code
Support needs to know if a customer's referral link is valid. They ask the agent to run get_referral_code_status with the provided code, and the system confirms its current status.
Onboarding new partners
You need to give a new user their unique sharing link. You simply ask your agent to run create_referral_code for that user, and it returns the ready-to-share code.
The honest tradeoffs
Treating it like a simple contact form
Trying to manually type out every detail—purchase amount, date, order ID—in a single prompt without using the proper tracking tool.
Don't just describe the purchase. Use track_conversion_purchase by passing the required parameters (amount and order details) directly through your agent.
Ignoring signup conversions
Only logging purchases, assuming every user who signs up automatically buys something later.
Remember to run track_conversion_signup. This logs the conversion event even if there's no purchase yet, keeping your reward counter accurate.
Forgetting system checks
Assuming everything works because the front end looks fine.
Always start by running check_api_connection to verify that both the Merchant API and Developer API v2 are connected correctly.
When It Fits, When It Doesn't
Use this MCP if your main headache is tracking complex, multi-stage conversions or distributing rewards based on actions (purchases, signups). You need a single source of truth for every referral event. Don't use it if you just need to manage simple user data; that’s better handled by a dedicated CRM connector. If you only care about listing webhooks, those tools exist separately, but this MCP groups the full e-commerce lifecycle—from code generation (create_referral_code) to final payout tracking (list_referral_rewards). Use it if the entire conversion flow matters; skip it if you just need basic data retrieval.
Questions you might have
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.
How do I use the `list_referral_rewards` tool to identify my top promoters? +
You list all distributed rewards, then filter the results by advocate email. This lets you pinpoint which specific users are generating the most referrals and earning the most rewards.
What is the best use case for `create_referral_code`? +
Use this tool when you need to generate a unique, personalized share code. It lets you give a specific customer their own referral link so they can start promoting immediately.
How is the `track_conversion_signup` tool different from logging purchases? +
This tool records successful signups when an immediate purchase hasn't happened. It ensures that non-monetary leads or free trial registrations are still credited to the correct advocate.
What data can I pull using `list_tracked_purchases`? +
It retrieves a complete list of all purchases associated with referral efforts. You can check purchase details, including order IDs and the specific code used for attribution.
We've already built the connector for Friendbuy. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 8 tools are live and waiting.
You're up and running in seconds.
Gemini Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.