How to Use the Genius Referrals MCP in Cursor

Q: How do I use Cursor to check my Genius Referrals account status?

Just ask the agent to getmyaccount. It makes a call to Genius Referrals and shows you which account you're currently authenticated with, right in the editor. It's a quick way to make sure you're working in the right environment.

Q: Can I list all my referral campaigns?

Of course. Use the agent and tell it to listreferralcampaigns. It will return a list of all active campaigns from your account, which you can then use to generate reports or other code.

Inject live Genius Referrals data directly into your code with Cursor's AI agent.

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 Cursor

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Generate Code with Real Data

Stop writing code against stale, mock JSON. Tell Cursor's agent to fetch data for a specific advocate using `get_advocate_details`. It calls the real Genius Referrals API and gets a live response. Then, the agent generates code that correctly handles that exact data structure. You build faster because you're not guessing at field names or data types. It’s like having live API docs that write the code for you.

Build Dashboards and Reports in Cursor

Need to build an internal tool to monitor your program? Ask the agent to scaffold a component that displays your top advocates. It will use `list_top_performers` to get the data and write the React or Vue code to display it. This isn't just about code generation; it's about building with live context. You can pull campaign stats with `get_campaign_details` or referral lists with `list_tracked_referrals` and have the agent structure the code for your UI instantly.

Test Your Integration Live

When you're working on your referral conversion flow, you need to test it. Tell the agent to `log_referral_conversion` with some test data. The MCP server makes the call to your Genius Referrals sandbox. Seconds later, you can verify the result. Just ask the agent to `list_tracked_referrals` or check `list_awarded_bonuses` to confirm the entire flow worked as expected. You can debug your integration without ever leaving the editor.

Setup guide

Set up Genius Referrals MCP in Cursor

Prerequisites

Cursor installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the Genius Referrals MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent Genius Referrals transactions." If the MCP tools are loaded correctly, Cursor will call the Genius Referrals tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.json

{
  "mcpServers": {
    "genius-referrals-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

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 Cursor

You enable Agent Mode and start asking for data. For example, tell the agent 'get my top 10 advocates' and it will use the `list_top_performers` tool to fetch live data from Genius Referrals and inject it into your code or chat.

Yes, that's exactly what this is for. You just tell the agent to `register_advocate` and provide the necessary details. It's perfect for scripting or testing your onboarding process.

Just ask the agent to `get_my_account`. It makes a call to Genius Referrals and shows you which account you're currently authenticated with, right in the editor. It's a quick way to make sure you're working in the right environment.

Of course. Use the agent and tell it to `list_referral_campaigns`. It will return a list of all active campaigns from your account, which you can then use to generate reports or other code.

Yes. Your credentials are not stored in your code. The MCP server handles authentication via a single Vinkius endpoint token, and all API calls to Genius Referrals containing advocate or payout data are made from a zero-trust, isolated environment.

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