# Viral Loops MCP MCP

> Viral Loops lets you manage entire referral marketing campaigns directly from your AI client. You track participants, generate unique links, monitor milestones, and check reward status without ever logging into a dashboard. It handles everything needed to scale growth through word-of-mouth referrals.

## Overview
- **Category:** growth-engine
- **Price:** Free
- **Tags:** referral-marketing, campaign-management, growth-hacking, customer-acquisition, reward-tracking, marketing-analytics

## Description

This connector gives your agent the power to run full-scale referral programs right out of your natural conversation. Instead of manually checking dashboards for activity, you can ask it to list all active campaigns or find specific performance metrics like total conversions and referrals. You'll track participants, see who needs a unique link, and check if someone has hit a milestone that earns them a reward.

The power is in the flow. Need to calculate rewards based on current activity? Your agent can fetch campaign statistics and then use those numbers to determine which rewards are due. If you build complex automations, like chaining this MCP with a billing system or a messaging platform, Vinkius handles all the security details for you. It runs every call inside its own isolated sandbox, keeping your credentials safe in transit so you never worry about them sitting on a disk. This means you can build reliable marketing automation that spans multiple services through one single agent connection.

## Tools

### create_participant
Adds a new user who signs up through your referral form into a campaign.

### get_campaign
Pulls detailed information about one specific, existing campaign using its ID.

### get_milestones
Checks what referral milestones are set up for a campaign and if they're complete.

### get_participant
Gets all the details on a specific participant using their email address.

### get_referral_url
Generates and retrieves the unique referral link for any given participant.

### get_rewards
Retrieves the full setup of rewards configured for a specific campaign.

### get_campaign_stats
Retrieves the performance numbers for a campaign, including total referrals and conversions.

### list_campaigns
Lists all referral campaigns available in your account, allowing you to know which IDs to use later.

### list_participants
Shows a roster of every participant currently enrolled in a campaign for analysis.

### update_participant
Changes information for an existing user record within the system.

## Prompt Examples

**Prompt:** 
```
Show me all my referral campaigns.
```

**Response:** 
```
Found 3 campaigns: 1. Pre-Launch Waitlist (active). 2. Giveaway Campaign (active). 3. Milestone Rewards (draft).
```

**Prompt:** 
```
Get the referral URL for user@example.com in campaign 123.
```

**Response:** 
```
Referral URL: https://app.viral-loops.com/ref/abc123?email=user@example.com
```

**Prompt:** 
```
Show me the stats for campaign 123.
```

**Response:** 
```
Campaign Stats: 1,250 participants, 4,800 referrals, 320 conversions (25.6% conversion rate).
```

## Capabilities

### Track all active campaigns
List every referral campaign set up in your account to see what's running.

### Identify specific participants
Look up a participant's details or find their unique referral URL by email address.

### Monitor reward eligibility
Check what milestones were hit and if rewards are configured for the current campaign.

### Analyze overall performance
Get detailed statistics, including total referrals and conversions, for any given campaign.

### Add new users to campaigns
Register a brand-new participant into an existing referral program.

## Use Cases

### Quarterly Review: Calculating total leads
The Growth Manager needs to know if the last quarter's efforts paid off. They ask their agent to call `list_campaigns` first, then use `get_campaign_stats` for the top two campaigns. The agent returns a summary of total conversions across both, so they can build the final report.

### Support Ticket: User needs a referral link
A customer support rep gets an email from a user and must send them their unique link quickly. They ask the agent to call `get_referral_url` with the user's email, getting the specific URL needed for the reply.

### Onboarding: New campaign setup
The Marketing Ops Specialist is launching a new product and needs to track signups. They first call `list_campaigns` to check naming conventions, then use `create_participant` immediately when the first lead comes in.

### Audit: Checking user status
A team member suspects a participant's records are wrong. They ask the agent to call `get_participant` by email, checking all current details, and then use `update_participant` if they find an outdated phone number.

## Benefits

- You can get a list of all available campaigns using `list_campaigns` before you even know the campaign ID. This prevents guessing games when building automations.
- Instead of manually tracking growth in a dashboard, your agent pulls performance data with `get_campaign_stats`, giving you real-time metrics on referrals and conversions.
- Need to onboard someone? Use `create_participant` for immediate user entry, or use `update_participant` if their details change after sign up. It handles the entire lifecycle.
- When a participant needs sharing links, your agent calls `get_referral_url`. You just tell it an email, and you get the link back immediately.
- You can determine what incentives are in place by calling `get_rewards` or checking if milestones were hit using `get_milestones`. This confirms reward eligibility at a glance.
- The ability to chain this MCP with other services means your agent can automatically take stats from `get_campaign_stats` and send the results to a messaging platform.

## How It Works

The bottom line is you can manage and analyze complex growth campaigns using plain language commands through any MCP-compatible client.

1. Subscribe to this MCP and provide your Viral Loops API Key.
2. Connect the MCP to your preferred AI client (Claude, Cursor, etc.).
3. Ask your agent to perform a task, like 'Show me all active campaigns' or 'Get the stats for campaign 123'.

## Frequently Asked Questions

**How do I find out which campaigns are available? (list_campaigns)**
`list_campaigns` immediately shows you every campaign ID currently running. This is the best first step to know what data you can access before asking for specific stats.

**Does get_campaign_stats show all types of metrics? (get_campaign_stats)**
Yes, it pulls performance statistics like total referrals and conversions. This gives you a high-level view of the campaign's success rate.

**What is the difference between list_participants and get_participant? (list_participants/get_participant)**
`list_participants` shows a general roster for analysis. Use `get_participant` when you know the specific user's email address and need all their individual details.

**Can I update a participant's information? (update_participant)**
Yes, if a user changes their name or contact info, you can use `update_participant` to make sure the record stays current without needing manual access to the dashboard.

**When should I use `create_participant`?**
Use this tool when a new user signs up through an external form or signup page. It handles the initial registration, adding them to your referral campaign and setting their baseline status.

**If I need to share tracking links, how do I use `get_referral_url`?**
This function generates the unique URL for a specific participant. You send this link to them so they can start sharing it immediately and kick off their referral count.

**How does `get_milestones` determine if a user qualifies for a reward?**
The tool checks the criteria you configured, such as '10 referrals = free product.' It reports the participant's current referral total and whether they have crossed that specific threshold.

**Before I run `get_campaign`, what information must I know?**
You need the Campaign ID. Always start by calling `list_campaigns` first; this provides a list of all available campaign IDs, ensuring your subsequent calls target the right data set.

**How do I get my Viral Loops API Key?**
Log in to your Viral Loops account, navigate to Settings > API Keys, and generate a new key. Copy it and paste it below.

**Can I get referral URLs for participants?**
Yes! Use the get_referral_url tool with the campaign ID and participant email to retrieve their unique referral link.

**Can I add new participants to a campaign?**
Yes! Use the create_participant action with the campaign ID and participant data (email and custom fields) to register them.