How to Use the Viral Loops MCP in Windsurf

Q: How do I find all campaigns using Viral Loops with Windsurf?

Just call listcampaigns. This tool outputs a list of IDs and names for every active referral campaign in your account. You don't need to know the ID beforehand; the MCP Server gives you everything it needs.

Q: Can Windsurf build a report showing rewards using Viral Loops data?

Yes. You can use getrewards to pull the configuration, then chain that with getmilestones. This shows you exactly what the reward is and the criteria needed for participants to earn it.

Q: Which tools are best for analyzing participant lists in Viral Loops with Windsurf?

You should start by using listparticipants for a general overview. If you need details on one person, use getparticipant. The MCP Server handles all the different views of user data.

Run multi-step referral audits and report generation automatically with Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Viral Loops MCP to Windsurf

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Chain Campaign Audits in Windsurf

Use `list_campaigns` to discover all available campaigns first. Then, Cascade can grab detailed performance data using `get_campaign_stats`. It handles the entire flow—listing and then analyzing stats for every campaign ID you pass it. This lets you automate multi-step reporting without writing custom logic. Set your goal: 'Find me the top 3 campaigns by referrals.' Windsurf figures out the steps, executing everything from listing to stat retrieval.

Manage Participants via MCP Server

Need a list of current participants? Call `list_participants` to pull everyone in a campaign. You can then check specific user details using `get_participant` by email, or generate their unique link with `get_referral_url`. The agent handles checking the participant status against the overall campaign context. Cascade makes sure you get accurate data for every participant record. This is perfect for auditing large groups of users and prepping them for a leaderboard analysis.

Automate Milestone Tracking with Windsurf

Check reward status easily by calling `get_milestones` against a campaign ID. You'll see exactly what the rewards are (like '5 referrals = discount') and if participants have hit that threshold yet. This is crucial for knowing when to trigger an action. Windsurf can take this data—the milestone list, the participant count, and the current stats—and chain them together. It processes the whole flow: Campaign ID -> Milestones -> Current Status.

Setup guide

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

mcp_config.json

{
  "mcpServers": {
    "viral-loops-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 Viral Loops. 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 Viral Loops 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 Viral Loops MCP in Windsurf

Just call `list_campaigns`. This tool outputs a list of IDs and names for every active referral campaign in your account. You don't need to know the ID beforehand; the MCP Server gives you everything it needs.

The server touches participant details, specifically email addresses and referral URLs. This includes identifying information about who is in a campaign and what their unique link is.

Yes. You can use `get_rewards` to pull the configuration, then chain that with `get_milestones`. This shows you exactly what the reward is and the criteria needed for participants to earn it.

You should start by using `list_participants` for a general overview. If you need details on one person, use `get_participant`. The MCP Server handles all the different views of user data.

While it won't create the campaigns for you, it gives you all the necessary tools. You can use `get_campaign` to pull full details on a specific campaign once it exists.

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