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.

Friendbuy MCP Server for LangChain 8 tools — connect in under 2 minutes

Name: Friendbuy
Availability: InStock
Author: Vinkius

python.langchain.com/docs/integrations/tools/mcp

Built by Vinkius GDPR 8 Tools Framework

LangChain is the leading Python framework for composable LLM applications. Connect Friendbuy through Vinkius and LangChain agents can call every tool natively. combine them with retrievers, memory, and output parsers for sophisticated AI pipelines.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

python

import asyncio
from langchain_mcp_adapters.client import MultiServerMCPClient
from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent

async def main():
    # Your Vinkius token. get it at cloud.vinkius.com
    async with MultiServerMCPClient({
        "friendbuy": {
            "transport": "streamable_http",
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp",
        }
    }) as client:
        tools = client.get_tools()
        agent = create_react_agent(
            ChatOpenAI(model="gpt-4o"),
            tools,
        )
        response = await agent.ainvoke({
            "messages": [{
                "role": "user",
                "content": "Using Friendbuy, show me what tools are available.",
            }]
        })
        print(response["messages"][-1].content)

asyncio.run(main())

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About Friendbuy MCP Server

Connect your Friendbuy account to any AI agent to automate your referral programs and customer loyalty workflows through the Model Context Protocol (MCP). Friendbuy is a high-growth referral marketing platform that powers word-of-mouth campaigns for leading brands. This MCP server enables you to track referral events, log conversions, and retrieve reward distributions directly through natural conversation.

LangChain's ecosystem of 500+ components combines seamlessly with Friendbuy through native MCP adapters. Connect 8 tools via Vinkius and use ReAct agents, Plan-and-Execute strategies, or custom agent architectures. with LangSmith tracing giving full visibility into every tool call, latency, and token cost.

Key Features

Referral Rewards Tracking — List all distributed referral rewards and filter them by advocate to understand who your top promoters are.
Conversion Logging — Post purchase and signup events programmatically to trigger the referral reward lifecycle.
Code Generation & Verification — Create personal referral codes for customers and check their active statuses instantly.
Purchase History — Retrieve a list of all tracked purchases that have been attributed to referral campaigns.
Webhook Monitoring — List configured webhooks to ensure your internal systems are receiving real-time reward notifications.
API Health Checks — Verify your connection to both the Merchant API and Developer API v2 environments seamlessly.

The Friendbuy MCP Server exposes 8 tools through the Vinkius. Connect it to LangChain in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect Friendbuy to LangChain via MCP

Follow these steps to integrate the Friendbuy MCP Server with LangChain.

Install dependencies

Run pip install langchain langchain-mcp-adapters langgraph langchain-openai

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token

Run the agent

Save the code and run python agent.py

Explore tools

The agent discovers 8 tools from Friendbuy via MCP

Why Use LangChain with the Friendbuy MCP Server

LangChain provides unique advantages when paired with Friendbuy through the Model Context Protocol.

The largest ecosystem of integrations, chains, and agents. combine Friendbuy MCP tools with 500+ LangChain components

Agent architecture supports ReAct, Plan-and-Execute, and custom strategies with full MCP tool access at every step

LangSmith tracing gives you complete visibility into tool calls, latencies, and token usage for production debugging

Memory and conversation persistence let agents maintain context across Friendbuy queries for multi-turn workflows

Friendbuy + LangChain Use Cases

Practical scenarios where LangChain combined with the Friendbuy MCP Server delivers measurable value.

RAG with live data: combine Friendbuy tool results with vector store retrievals for answers grounded in both real-time and historical data

Autonomous research agents: LangChain agents query Friendbuy, synthesize findings, and generate comprehensive research reports

Multi-tool orchestration: chain Friendbuy tools with web scrapers, databases, and calculators in a single agent run

Production monitoring: use LangSmith to trace every Friendbuy tool call, measure latency, and optimize your agent's performance

Friendbuy MCP Tools for LangChain (8)

These 8 tools become available when you connect Friendbuy to LangChain via MCP:

check_api_connection

Verify API access

create_referral_code

Generate share code

get_referral_code_status

Check code status

list_referral_rewards

List awarded referrals

list_tracked_purchases

List tracked purchases

list_webhooks

List webhook configs

track_conversion_purchase

Log a purchase

track_conversion_signup

Log a signup

Example Prompts for Friendbuy in LangChain

Ready-to-use prompts you can give your LangChain agent to start working with Friendbuy immediately.

"List all recent referral rewards distributed."

"Generate a new referral code for customer 'user_123' (jane@email.com)."

"Track a $50 purchase for order 'ORD-987' from 'friend@email.com' using code 'JANE-REF-99'."

Troubleshooting Friendbuy MCP Server with LangChain

Common issues when connecting Friendbuy to LangChain through the Vinkius, and how to resolve them.

MultiServerMCPClient not found

Install: pip install langchain-mcp-adapters

Friendbuy + LangChain FAQ

Common questions about integrating Friendbuy MCP Server with LangChain.

How does LangChain connect to MCP servers?

Use langchain-mcp-adapters to create an MCP client. LangChain discovers all tools and wraps them as native LangChain tools compatible with any agent type.

Which LangChain agent types work with MCP?

All agent types including ReAct, OpenAI Functions, and custom agents work with MCP tools. The tools appear as standard LangChain tools after the adapter wraps them.