# Viral Loops MCP for AI Agents AI Agent Connect

> Viral Loops lets you manage your entire referral marketing engine through an AI agent. You can create and track campaigns, generate unique participant links, monitor rewards, and pull performance stats without jumping between tabs. It connects your growth data directly to your workflow.

## Overview
- **Category:** growth-engine
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_1c55dYYLEmmbEhclVBuVcvRIUfigoG9lJF3rAv4G/ai-agent-connect
- **Tags:** referral-marketing, campaign-management, growth-hacking, customer-acquisition, reward-tracking, marketing-analytics

## Description

Imagine you're running a growth sprint and need to know exactly how many people signed up via a specific referral link or if a user hit their 10-referral milestone for a free gift. Instead of digging through a complex dashboard, you just ask your agent. This Connector connects your Viral Loops account to your daily workspace, making it possible to query campaign health, fetch participant details, and update reward statuses in plain English. You can pull a list of everyone who joined a campaign or grab a specific URL to send to a customer who's asking for it. Because Vinkius hosts this connection, it's ready to plug into your existing setup. It turns referral marketing from a manual data-entry chore into a conversational task where you can manage your growth engine while staying focused on the bigger picture.

## Tools

### get_referral_url
Grab the unique link for a specific participant. You can use this to send personalized links to your customers.

### get_rewards
See the reward configurations for a campaign. Use this to check what prizes are currently being offered.

### get_campaign_stats
Get the high-level performance metrics for a campaign. You'll see total referrals, conversions, and growth rates.

### list_campaigns
See every campaign in your account at once. This is the best way to start by discovering which programs are active.

### update_participant
Change the information for an existing participant. Use this to keep user data accurate as they move through the loop.

### get_participant
Find the details of a specific person using their email. This helps you quickly identify a user's status in your growth loop.

### list_participants
Get a full list of everyone in a campaign. It's great for building leaderboards or auditing your growth.

### create_participant
Add a new user to a specific referral campaign. This is perfect for syncing sign-ups from your own forms or landing pages.

### get_campaign
Pull every detail about a specific campaign. Use this to see the full scope of a referral program's configuration.

### get_milestones
Check the rewards and milestones for a campaign. It lets you see exactly what users need to do to get their prizes.

## Prompt Examples

**Prompt:** 
```
How is my 'Summer Giveaway' doing?
```

**Response:** 
```
### Campaign Stats: Summer Giveaway

| Metric | Value |
| :--- | :--- |
| **Total Referrals** | 4,800 |
| **Participants** | 1,250 |
| **Conversions** | 320 |
| **Conversion Rate** | 25.6% |

The campaign is performing well above our target conversion rate of 20%.
```

**Prompt:** 
```
Give me the referral link for user@test.com.
```

**Response:** 
```
I found the unique referral URL for **user@test.com**: 

[https://app.viral-loops.com/ref/abc123?email=user@test.com](https://app.viral-loops.com/ref/abc123?email=user@test.com)
```

**Prompt:** 
```
Who has finished the most referrals?
```

**Response:** 
```
Here are the top participants for the current campaign:

* **User A**: 50 referrals (Completed)
* **User B**: 42 referrals (Completed)
* **User C**: 38 referrals (In Progress)

User A currently holds the top spot on the leaderboard.
```

## Capabilities

### Create new participants
Add a new user to a referral campaign the moment they sign up.

### Track referral links
Fetch unique referral URLs for specific participants instantly.

### Monitor milestones
Check if a user has earned their rewards yet.

### Pull campaign stats
Get conversion rates and total referral counts on demand.

### Manage rewards
View and adjust the reward configurations for any campaign.

### Audit participants
List every person in a campaign for leaderboard tracking.

## Use Cases

### Influencer Outreach
A growth manager asks the agent to find the referral URL for a specific partner so they can send it in a DM immediately.

### Support Troubleshooting
A customer says they didn't get their reward. Support asks the agent to check the user's milestones using get_milestones.

### Growth Reporting
A marketing lead asks for a summary of the 'Summer Giveaway' stats to see the conversion rate.

### Automated Onboarding
A developer uses create_participant to push new sign-ups from a custom web form into the Viral Loops system.

## Benefits

- Stop tab-switching by querying campaign stats using get_campaign_stats directly from your chat.
- Send personalized links faster by grabbing them with get_referral_url on demand.
- Automate participant onboarding by using create_participant when a user joins your flow.
- Keep track of rewards accurately with get_milestones to see who is eligible for prizes.
- Audit your growth loop easily by pulling full participant lists with list_participants.
- Stay on top of campaign health by using list_campaigns to see what's active.

## How It Works

The bottom line is it turns your referral data into a searchable, actionable conversation.

1. Subscribe to the Viral Loops MCP on Vinkius.
2. Enter your Viral Loops API Key into the configuration.
3. Ask your agent to list campaigns or check live stats.

## Frequently Asked Questions

**Can I use Viral Loops MCP to check my referral stats?**
Yes, you can ask your agent to pull live stats for any campaign. It will return your conversion rates, total referrals, and participant counts instantly.

**How do I get a referral link for a customer?**
Just ask your agent to find the unique URL for a specific user. It will pull the correct link from your account so you can share it without logging in.

**Can this help my support team?**
Absolutely. Support agents can use the Connector to look up participant statuses, check reward milestones, and verify user details to solve issues faster.

**What kind of campaigns can I see?**
The Connector allows your agent to see every referral campaign in your account. You can ask to list all of them or get details on a specific one.

**Does it handle rewards?**
Yes, it can check milestone completion statuses and view your current reward configurations to see what users are eligible to earn.

**Can I add new participants automatically?**
Yes, the Connector includes a tool to create participants. You can use this to sync new sign-ups from your own web forms or landing pages.

**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.