How to Use the ReferralCandy MCP in Windsurf

Q: How do I connect the ReferralCandy MCP Server to Windsurf?

Open your /.codeium/windsurf/mcpconfig.json file and add the server configuration under the mcpServers block. Once saved, click Refresh in the Windsurf MCP panel, and Cascade will immediately discover all 16 ReferralCandy tools.

Q: Can Windsurf Cascade autonomously send invites using ReferralCandy?

Yes, Cascade chains the sendinvite tool with your local database queries to automate outbound emails. You give Cascade a list of customer emails, and it handles the sequential execution through the ReferralCandy API.

Q: How does Windsurf display ReferralCandy campaign stats?

Windsurf queries the getstats and getcampaign tools to fetch active campaign performance metrics. Cascade then formats this raw JSON data directly inside your chat window or writes it into a markdown report.

Q: What happens if a tool call to register a purchase fails in Windsurf?

Cascade reads the error returned by registerpurchase and uses checkreferralcandystatus to verify if the API is reachable. It then prompts you with the specific payload mismatch or connection error so you can fix it.

Get Windsurf Cascade to run your ReferralCandy campaigns, track advocates, and register purchases on autopilot.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect ReferralCandy MCP to Windsurf

Create your Vinkius account to connect ReferralCandy 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 ReferralCandy with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Auto-Track Referrals and Rewards in Windsurf

The `list_referrals` tool lets Windsurf Cascade retrieve your advocate data and analyze sharing behaviors across your active campaigns. Cascade reads your local codebase, detects when a user completes a checkout, and automatically triggers `register_purchase` to credit the correct advocate. Cascade chains these tools to find unpaid advocates via `list_pending_rewards` and automatically flags them in your workspace. You don't have to manually check who is owed what; the agent inspects the ReferralCandy data and drafts the list for you.

Let Cascade Build Custom ReferralCandy Dashboards

The `get_stats` tool feeds raw referral performance data directly into Windsurf so Cascade can build or update your internal marketing UI. Instead of jumping to a browser, Cascade queries your ReferralCandy campaigns using `list_campaigns` and writes the React code to display the conversion rates. If a campaign underperforms, the agent uses `get_top_referrers` to identify your best advocates and generates a localized email template targeting them. This MCP server integration turns passive data into active frontend elements without manual API coding.

Programmatic Referral Invites via Windsurf MCP Server

The `send_invite` tool gives your Windsurf agent the ability to invite new customers to your ReferralCandy program during development testing or live trial runs. Cascade hooks this tool into your local sign-up flows, validating connection status with `check_referralcandy_status` before sending out the invites. You ask Cascade to run a script that identifies high-value customers using `get_referrer` and queues up personalized invites. This makes testing your ReferralCandy referral loop in the Windsurf editor completely hands-off.

Setup guide

Set up ReferralCandy 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 ReferralCandy 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 ReferralCandy payment history." If connected, Cascade will call the ReferralCandy tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

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

Open your `~/.codeium/windsurf/mcp_config.json` file and add the server configuration under the `mcpServers` block. Once saved, click Refresh in the Windsurf MCP panel, and Cascade will immediately discover all 16 ReferralCandy tools.

Yes, Cascade chains the `send_invite` tool with your local database queries to automate outbound emails. You give Cascade a list of customer emails, and it handles the sequential execution through the ReferralCandy API.

Windsurf queries the `get_stats` and `get_campaign` tools to fetch active campaign performance metrics. Cascade then formats this raw JSON data directly inside your chat window or writes it into a markdown report.

Cascade reads the error returned by `register_purchase` and uses `check_referralcandy_status` to verify if the API is reachable. It then prompts you with the specific payload mismatch or connection error so you can fix it.

All customer emails, advocate profiles, and purchase amounts are processed within Vinkius's zero-trust V8 Isolate sandbox. Your Windsurf client connects using a single ephemeral token, ensuring your customer data never leaks to external logs.

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