How to Use the ReferralHero MCP in Windsurf

Manage viral campaigns directly from Windsurf. Let Cascade handle your referral logic without manual API calls.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect ReferralHero MCP to Windsurf

Create your Vinkius account to connect ReferralHero to Windsurf — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup ReferralHero with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Automate subscriber management in Windsurf

Cascade can now pull your campaign data to add or remove members instantly. When you need to sync user states, `add_subscriber` and `delete_subscriber` handle the heavy lifting while you focus on the UI. Updating records happens in real-time. Use `update_subscriber` to push changes to your list, keeping your data consistent without leaving your editor.

Track campaign performance with this MCP Server

Stop digging through dashboards to find your top performers. Cascade uses `get_leaderboard` to fetch rankings and display them right in your chat panel. Digging into specific results is just as fast. Call `list_transactions` to verify conversion events as they hit your backend.

Build reward logic inside Windsurf

Your agent can now query your incentive structures directly. Trigger `get_rewards` to see what your users get for referring friends, then build the display logic to match. Everything is handled via the MCP standard. Your code remains clean because the tools handle the API calls behind the scenes.

Setup guide

Set up ReferralHero MCP in Windsurf

Prerequisites

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

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the ReferralHero MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my ReferralHero payment history." If connected, Cascade will call the ReferralHero tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "referralhero-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 ReferralHero. 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 ReferralHero 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 ReferralHero MCP in Windsurf

Open your MCP settings in the Cascade interface. Paste the Vinkius endpoint URL into the server configuration and hit refresh to see the tools populate.

Yes. You just ask Cascade to change a subscriber status, and it calls the `update_subscriber` tool for you.

Your connection is encrypted and scoped to your specific API key. We only pass subscriber email addresses and point totals through the local tunnel.

You only need your Vinkius token. Once that is set, the server handles the handshake automatically.

Run a prompt asking for the latest list details. Cascade will trigger `get_list` and summarize the results for you.

Use it with your favorite AI tools

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