Viral Loops MCP for AI. Track referrals, monitor milestones, and manage rewards.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Connect to your AI in seconds.
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.
What your AI can do
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.
List every referral campaign set up in your account to see what's running.
Look up a participant's details or find their unique referral URL by email address.
Check what milestones were hit and if rewards are configured for the current campaign.
Get detailed statistics, including total referrals and conversions, for any given campaign.
Register a brand-new participant into an existing referral program.
Ask an AI about this
Waiting for input…
Viral Loops: 10 Tools for Growth Tracking
These tools let your AI agent perform every necessary action in a full growth marketing cycle, from creating users to calculating final reward payouts.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Viral Loops on VinkiusCreate 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...
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.
Security and governance baked right in.
Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.
Claude AI
Open Claude Settings
Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
Add Custom Connector
Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:
https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp
Replace [YOUR_TOKEN_HERE] with your token
from cloud.vinkius.com. For OAuth-protected servers, expand
Advanced settings to add credentials.
Start a conversation
Open a new chat. The Viral Loops integration is available immediately — no restart needed.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Viral Loops, then connect any of our 5,000+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 5,000+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
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.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This connection provides 10 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.
Manually monitoring referral health is a constant chore.
Right now, if you want to know how many people hit the five-referral mark or what reward was earned last week, you're clicking through dashboard tabs. You check the participant list, then jump to the milestone tab, copy down a metric, and paste it into a spreadsheet. This process is slow, prone to data gaps, and takes too much time.
With this MCP, your agent handles all that cross-checking for you. Instead of clicking through tabs, you simply ask: 'Show me participants who hit the 5-referral milestone.' The agent pulls the required data from `get_milestones` and returns a clean list. You get actionable answers instantly.
Getting participant details with `get_participant`
Today, if you need to verify an account or check their current status, you might have to cross-reference three different internal tables: the user directory, the campaign list, and the reward table. This is a manual lookup headache.
Now, your agent handles the entire retrieval process in one step. You ask for details using `get_participant`, and it returns a complete record of that individual's status, history, and current standing—no switching between tabs required.
What your AI can actually do with this
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.
019d761c-d8de-72d2-bf08-e5bedf671c69 
Here's how it actually works
The bottom line is you can manage and analyze complex growth campaigns using plain language commands through any MCP-compatible client.
Subscribe to this MCP and provide your Viral Loops API Key.
Connect the MCP to your preferred AI client (Claude, Cursor, etc.).
Ask your agent to perform a task, like 'Show me all active campaigns' or 'Get the stats for campaign 123'.
Who is this actually for?
Growth Managers, Marketing Operations Specialists, and Product Owners. These people wake up needing to know exactly how a word-of-mouth campaign is performing without manually clicking through seven different dashboards.
Checks if the current participant pool has hit key milestones or calculates total conversions for quarterly reports.
Registers new participants and pulls campaign statistics to ensure all tracking codes are correct before a launch date.
Looks up participant referral URLs or views the reward configurations to confirm incentives match product value.
What Changes When You Connect
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.
See it in action
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.
The honest tradeoffs
Trying to check everything at once
Telling the agent: 'Give me stats for all campaigns, list all participants, and get links.' This is too much scope for one call.
Break it down. First, run list_campaigns to identify the campaign ID you need. Then, use that specific ID when calling get_campaign_stats. Keep your requests focused on one outcome at a time.
Assuming data is always fresh
Relying on old numbers for participant counts because the dashboard hasn't refreshed.
Always use targeted reads. If you need to know who's active, call list_participants. If you only care about rewards, use get_milestones rather than general stats.
Using the wrong tool for user lookup
Trying to find a participant by name when they signed up months ago.
Always attempt to locate them first using their email address. Use get_participant with the email; it's the most reliable way to pull current details.
When It Fits, When It Doesn't
Use this MCP if your primary goal is managing, tracking, or reporting on structured referral campaigns and participant activity. You need to know who referred whom, what milestones they hit, or how many conversions were generated over a period of time.
Don't use it if you just need general customer relationship management (CRM) features, like sending random bulk messages or updating non-referral specific data. For pure messaging, look at dedicated communication MCPs. If you only need to list users without tracking campaign metrics, other user directory tools might be simpler. But when the core problem is 'How do we measure and manage growth through word-of-mouth?', this is your tool.
Questions you might have
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.
We've already built the connector for Viral Loops. Just plug in your AI agents and start using Vinkius.
No hosting. No infrastructure. No complex setup.
All 10 tools are live and waiting.
You're up and running in seconds.
Gemini Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.
Built, hosted, and secured by Vinkius. You just connect and go.