Friendbuy Connector for AI agents.
8 live capabilities
Manage referral marketing programs and reward distributions with your AI client.
Waiting for input…
Why people use Friendbuy
Friendbuy Referral Marketing Automation for Growth Teams
With this Connector, you just talk to your agent. You can check a code's status, pull a list of recent rewards, or log a new purchase in one place. It turns a five-minute multi-tab dance into a five-second conversation, letting you focus on strategy instead of data entry.
What Vinkius changes
You get a direct line to your referral data without leaving your chat interface.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Identifying top-performing influencers
A growth marketer wants to know who is driving the most signups.
- Real-world use case 02
Logging offline retail sales
An e-commerce manager needs to log a batch of offline sales.
- Real-world use case 03
Real-time support for broken codes
A support agent gets a DM about a broken code.
Complete set · 8capabilities
The complete Friendbuy capability set.
These are the exact actions your AI can choose when you ask it to work with Friendbuy.
01—04
4 capabilities in this set.
Part of 8 available through Friendbuy.
- 01 Capability
List referral rewards
See all rewards that have been handed out to your advocates. This helps you identify your top promoters quickly.
- 02 Capability
Get referral code status
Check if a specific referral code is active or expired. Use this to give instant answers to customer inquiries.
- 03 Capability
Create referral code
Generate a new, unique referral code for a customer. This lets you issue codes on demand during a live chat.
- 04 Capability
Check api connection
Verify that your connection to the Merchant and Developer APIs is working. This is your first step for troubleshooting.
05—08
4 capabilities in this set.
Part of 8 available through Friendbuy.
- 05 Capability
List tracked purchases
Pull a list of all purchases attributed to your referral campaigns. Use this to audit your campaign's total revenue.
- 06 Capability
List webhooks
View your current webhook configurations. Use this to ensure your internal systems are getting the right notifications.
- 07 Capability
Track conversion purchase
Log a specific purchase as a conversion. This triggers the reward lifecycle for the referring advocate.
- 08 Capability
Track conversion signup
Record a new user signup as a conversion. This ensures the referral chain stays intact from the start.
Set up in minutes
One URL. Then ask Friendbuy to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Friendbuy from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_T6ZqQ69sJEQhzwScIDPv09uoj0DX6zEnpzOAllnI/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Friendbuy, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Friendbuy for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_T6ZqQ69sJEQhzwScIDPv09uoj0DX6zEnpzOAllnI/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Friendbuy URL.
- Step 03
Save and start
Save the connection and enable Friendbuy in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"friendbuy": {
"url": "https://edge.vinkius.com/vk_preview_T6ZqQ69sJEQhzwScIDPv09uoj0DX6zEnpzOAllnI/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Friendbuy
Open Agent mode in chat and ask: "Using Friendbuy, help me...". 8 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"friendbuy": {
"url": "https://edge.vinkius.com/vk_preview_T6ZqQ69sJEQhzwScIDPv09uoj0DX6zEnpzOAllnI/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Friendbuy
Ask Copilot: "Using Friendbuy, help me...". 8 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"friendbuy": {
"url": "https://edge.vinkius.com/vk_preview_T6ZqQ69sJEQhzwScIDPv09uoj0DX6zEnpzOAllnI/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Friendbuy
Open Cascade and ask: "Using Friendbuy, help me...". 8 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"friendbuy": {
"url": "https://edge.vinkius.com/vk_preview_T6ZqQ69sJEQhzwScIDPv09uoj0DX6zEnpzOAllnI/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Friendbuy
Ask Cline: "Using Friendbuy, help me...". 8 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add friendbuy --transport http "https://edge.vinkius.com/vk_preview_T6ZqQ69sJEQhzwScIDPv09uoj0DX6zEnpzOAllnI/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Friendbuy
Ask Claude: "Using Friendbuy, show me...". 8 tools are ready
Where the request belongs
Work Friendbuy can move forward.
Growth marketers and e-commerce ops who are tired of manually verifying referral rewards and want to automate conversion tracking.
Growth Marketer
Checks code statuses and reward lists to see which influencers are performing best on a Tuesday afternoon.
E-commerce Ops
Logs offline purchases to make sure advocates get paid correctly without manual data entry.
Customer Support
Verifies if a customer's referral actually converted to a sale during a live chat.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsReferralCandy
Connect your AI agents to ReferralCandy to manage referral programs, track advocates, register purchases, and analyze campaign performance.
Glow Loyalty
Manage loyalty members, track point balances, and oversee rewards via AI agents with Glow Loyalty.
Rewardful
Manage affiliate and referral programs via Rewardful. list campaigns, register affiliates, and track commissions directly from any AI agent.
Referrizer
Automate referral marketing and loyalty via Referrizer. manage contacts, referrals, and rewards directly from any AI agent.
Referly
Automate affiliate programs via Referly. manage partners, track conversions, and monitor workflows directly.
Goaffpro
Manage affiliates, track referral orders, and oversee commissions via AI agents with Goaffpro.
Bring your own AI
Change the model, client or framework. Keep Friendbuy connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Friendbuy.
The practical details behind the request, access and result.
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' capability. 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' capability. 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' capability retrieves all active webhook configurations so you can verify where real-time reward notifications are being sent.
One connection away
Give your agent a direct line to Friendbuy.
Connect Friendbuy once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available