How to Use the Genius Referrals MCP in Vercel AI SDK

Q: How do I connect Genius Referrals to Vercel AI SDK?

You install the @ai-sdk/mcp package and initialize the MCP Server connection using the Vinkius HTTP endpoint. Pass the tools generated by the client directly into your streamText function. This lets your agent call tools to confirm the link is active.

Q: Can I show live referral progress using Genius Referrals and Vercel AI SDK?

Yes, you can stream real-time updates. Your agent calls listtrackedreferrals to get the latest events, and the SDK pushes this data directly to your frontend. The user sees their referral count update live without manual page reloads.

Q: How do I handle advocate lookups with Genius Referrals in Vercel AI SDK?

You pass the getadvocatedetails tool to your agent within the Vercel AI SDK framework. When a user asks about their balance, the agent pulls their metadata and displays it in the chat UI. This makes account lookups instant and conversational.

Build real-time referral dashboards where Genius Referrals data streams instantly into React components via the Vercel AI SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Genius Referrals MCP to Vercel AI SDK

Create your Vinkius account to connect Genius Referrals to Vercel AI SDK and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Genius Referrals with Vercel AI SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Stream Live Referral Conversions

The `log_referral_conversion` tool records signups and purchases directly from your web application. Your agent calls this tool when a user completes an action, pushing the conversion data straight into your referral campaign. Because you are using the Vercel AI SDK, this update streams to the user's screen in real-time without requiring a page refresh. You build interactive interfaces where advocates see their progress update instantly. If a referral converts, the UI reflects the change immediately, keeping your users engaged. This setup bypasses slow loading spinners by feeding the live stream of tool outputs directly into your Next.js frontend.

Real-Time Advocate Registration in Vercel AI SDK

The `register_advocate` tool signs up new members to your marketing campaign directly through your chat interface. Your agent collects the user's details during a conversation and immediately executes the registration. This creates an immediate link between the new advocate and their unique referral code. By wrapping this inside an MCP Server setup, you eliminate the need to write custom API wrappers for your registration forms. The Vercel AI SDK handles the execution, so your users get their referral links generated live while they chat with your agent.

Track Live Payout Statuses

The `list_payout_requests` tool fetches pending and completed reward redemptions from your Genius Referrals account. Your agent uses this tool to show advocates exactly where their money is. The SDK streams these financial updates directly into your custom dashboard components. This direct data pipeline keeps support tickets low because users have instant visibility into their rewards. You do not have to build complex polling mechanisms; the live data streams straight from the endpoint to the client UI.

Setup guide

Set up Genius Referrals MCP in Vercel AI SDK

Prerequisites

Node.js 18+ and a TypeScript project
ai + @modelcontextprotocol/sdk packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies

Run npm install ai @modelcontextprotocol/sdk plus your preferred model provider (e.g. @ai-sdk/openai).
2

Create the Streamable HTTP transport

Use StreamableHTTPClientTransport with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and use tools

Call mcpClient.tools() to auto-discover all Genius Referrals tools. Pass them directly to generateText() or streamText() — no manual schema definitions needed.
4

Works with any model provider

Swap openai("gpt-4o") for any AI SDK provider — Anthropic, Google, Mistral. The MCP tools work identically across all supported models.

index.ts

import { experimental_createMCPClient as createMCPClient } from "ai";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp";
import { generateText } from "ai";
import { openai } from "@ai-sdk/openai";

const transport = new StreamableHTTPClientTransport(
  new URL("https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")
);

const mcpClient = await createMCPClient({ transport });
const tools = await mcpClient.tools();

const { text } = await generateText({
  model: openai("gpt-4o"),
  tools,
  prompt: "List recent Genius Referrals transactions",
});

console.log(text);
await mcpClient.close();

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Genius Referrals. 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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Genius Referrals now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Genius Referrals MCP in Vercel AI SDK

You install the `@ai-sdk/mcp` package and initialize the MCP Server connection using the Vinkius HTTP endpoint. Pass the tools generated by the client directly into your streamText function. This lets your agent call tools to confirm the link is active.

Yes, you can stream real-time updates. Your agent calls `list_tracked_referrals` to get the latest events, and the SDK pushes this data directly to your frontend. The user sees their referral count update live without manual page reloads.

You pass the `get_advocate_details` tool to your agent within the Vercel AI SDK framework. When a user asks about their balance, the agent pulls their metadata and displays it in the chat UI. This makes account lookups instant and conversational.

No, Vinkius handles the underlying API authentication for you. You use a single secure token to connect your setup to the hosted endpoint. This keeps your API keys safe from exposure in client-side code.

Your advocate emails and referral logs are protected inside the Vinkius V8 sandbox environment. No customer data is stored on Vinkius servers, as all requests pass through ephemeral, zero-trust execution environments.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript