How to Use the Genius Referrals MCP in Mastra AI

Build automated referral workflows with Mastra AI and Genius Referrals to handle payouts and fraud checks on autopilot.

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 Mastra AI

Create your Vinkius account to connect Genius Referrals to Mastra AI 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 Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Reward Approvals

The `list_payout_requests` tool retrieves all pending redemption events that require your attention. Your Mastra AI agent uses this tool to monitor the queue of advocates waiting for their cash or points. This allows your workflow to trigger review processes based on real-time data. You can build a workflow that automatically flags high-value requests. By combining this tool with Mastra's branching logic, you can route suspicious transactions to a human admin while auto-approving small, trusted payouts.

Set Up Self-Healing Referral Logs in Mastra AI

The `log_referral_conversion` tool registers successful conversions like purchases or signups inside your referral engine. Your agent calls this tool within a Mastra workflow to ensure every referral is accounted for. If the API call fails due to network issues, Mastra's built-in retry engine automatically backs off and tries again. This setup guarantees you never miss tracking a conversion due to temporary server hiccups. The workflow engine keeps retrying the action until it succeeds, maintaining accurate records without manual dev intervention.

Identify Top Performers Automatically

The `list_top_performers` tool ranks your advocates based on their successful referral conversions. Your agent queries this tool to find your most active promoters. You can use this data to trigger automated email campaigns or loyalty bonuses. By integrating this MCP Server tool into your Mastra agent, you can build autonomous retention loops. When an advocate hits the top tier, the agent automatically assigns them to a VIP campaign using `register_advocate`.

Setup guide

Set up Genius Referrals MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Genius Referrals tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "genius-referrals-mcp-client",
  servers: {
    "genius-referrals-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Genius Referrals Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Genius Referrals tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Genius Referrals transactions"
);
console.log(result.text);

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 Mastra AI

You initialize the MCP Server client with the Vinkius URL and spread the tools into your Mastra agent configuration. This gives your agent access to tools like `get_campaign_details` right out of the box. You do not need to write custom integration code for each API endpoint.

Yes, Mastra AI has native retry mechanisms that handle rate limits or network drops. If your agent calls `list_program_advocates` and hits a limit, the workflow engine retries with exponential backoff. This ensures your background syncs never fail silently.

You create a Mastra workflow that runs on a schedule to check `list_payout_requests`. The agent reviews each request against your fraud rules and logs approved transactions. This automates the tedious parts of campaign management without losing control.

No, the Mastra client auto-detects the MCP transport protocol when connecting to Vinkius. It handles the connection details behind the scenes so your agent can focus on executing tools like `verify_api_connection`.

Your campaign metadata and advocate payout transactions are processed inside isolated Vinkius V8 sandboxes. The connection is ephemeral, meaning no advocate details or financial histories are stored on the Vinkius platform.

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