How to Use the Viral Loops MCP in Cursor

Q: How do I access Viral Loops campaign data using Cursor?

First, use listcampaigns to discover all available campaigns. Then, you'll call getcampaign with the specific ID to get full details for that campaign directly into your code context.

Q: What if I need participant stats for Viral Loops in Cursor?

You can grab overall performance numbers using getcampaignstats. If you're checking on rewards, use getmilestones to see the status of discounts or product giveaways.

Q: Can I manage Viral Loops campaigns in Cursor's Agent mode?

You can use tools like createparticipant to add new users directly into your code logic. You also have updateparticipant, letting you modify existing records without leaving the editor.

Q: How do I find all Viral Loops campaign settings in Cursor?

You can see general reward configurations using getrewards. If you need to know which campaigns exist, start by running listcampaigns and then check the details with getcampaign.

Inject live Viral Loops data into your code using Cursor's Agent mode.

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 Cursor

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Retrieve Participant Details with Cursor

Need to check if a user exists before writing the sign-up logic? Use `get_participant` to grab all details for a specific person by email. This lets your agent write code that uses live, accurate data from Viral Loops. If you need to change something—say, fixing an old address—you can use `update_participant` right within the generated block of code.

Handle Campaign Logic via Cursor

The tool `get_milestones` helps you build out logic around rewards. You can write code that checks if a user has reached 10 referrals, triggering a 'free product' flag in your app. To start, run `list_campaigns`. This function provides the necessary IDs so you can then query specific campaign details using `get_campaign`.

Get User Referral Links with Cursor

When integrating a new sign-up flow, you'll need unique links. Call `get_referral_url` to get the precise link for any participant. This lets your code generate the correct deep link. You can also manage user lists by calling `list_participants`, which is useful when building out leaderboards or admin dashboards.

Setup guide

Set up Viral Loops 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 Viral Loops 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 Viral Loops transactions." If the MCP tools are loaded correctly, Cursor will call the Viral Loops tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.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 Cursor

First, use `list_campaigns` to discover all available campaigns. Then, you'll call `get_campaign` with the specific ID to get full details for that campaign directly into your code context.

You can grab overall performance numbers using `get_campaign_stats`. If you're checking on rewards, use `get_milestones` to see the status of discounts or product giveaways.

Yes. The MCP Server touches participant information. When using `get_participant`, the system retrieves details based on an email address, ensuring you only work with verifiable user identifiers.

You can use tools like `create_participant` to add new users directly into your code logic. You also have `update_participant`, letting you modify existing records without leaving the editor.

You can see general reward configurations using `get_rewards`. If you need to know which campaigns exist, start by running `list_campaigns` and then check the details with `get_campaign`.

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