Viral Loops
Viral Loops is a referral marketing platform for managing campaigns, participants, referrals, conversions, leaderboards, and rewards.
Verdict
Common use cases
- Register waitlist signups from inbound email
- Pull leaderboard standings for reward fulfillment
- Track conversions when users complete onboarding
- Search participants by acquisition source
- Answer campaign performance questions in standups
Integration
- Vendor
- Viral Loops
- Category
- other
- Auth
- API_KEY
- Tools
- 9
- Composio slug
viral_loops
Tools
- Get Campaign Info
Return the connected campaign's identity, template, expiration mode and date, points, GDPR, and integration configuration without bulky presentation styling.
- Get Campaign Stats
Return the connected campaign's lead count and total referral count.
- Get Participant
Return one participant's profile, referral totals, rank, referrer, and reward summaries by email or referral code.
- List Participant Referrals
Return one participant's referrals by email or referral code, with explicit offset pagination. The provider's response fields and pagination metadata are preserved as returned.
- Look Up Participants
Batch lookup exact participant and referrer identifiers, returning matching campaign records with explicit offset pagination.
- Register Participant
Register an email address in the connected campaign, optionally with a referrer and participant metadata. This creates persistent participant data; Viral Loops provides no API operation to delete it.
- Search Participants
Search campaign participants by text, conversion status, and acquisition source, with explicit offset pagination.
- Track Participant Conversion
IRREVERSIBLE: Record a conversion event for one registered participant. This operation cannot be undone and may affect conversion counts, campaign automation, and rewards. It is available only for Milestone Referral, Altruistic Referral, On
- Update Participant
Update one participant's name, referral or conversion counts, or custom data, identified by email or referral code. Campaign emails and connected integration triggers default to off; when enabled, those side effects cannot be undone.
Setup
Setup guide
- 11. In Switchy, open Settings → Integrations → MCP Servers and click Add Server. 2. Select Viral Loops from the catalog. 3. Log in to your Viral Loops dashboard, navigate to Settings → API, and copy your API key. 4. Paste the key into Switchy's configuration modal and click Connect. 5. Switchy will verify the key and list your active campaigns; choose the campaign you want this integration to query. 6. Open any Project, type '@Viral Loops get campaign stats' in the chat, and confirm you see lead and referral counts — that proves the connection works. 7. From now on, @mention Viral Loops inside any Project message to invoke tools like registering participants, searching by email, or tracking conversions. 8. Remember: participant registration and conversion tracking are irreversible, so double-check inputs before confirming prompts that write data.
What teammates see: by default, memories from Viral Loops are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Campaign Performance Snapshot
@Viral Loops get campaign stats and format the lead count, referral count, and any notable growth trends in a short summary I can paste into our weekly update.
Register New Participant
@Viral Loops register a new participant with email user@example.com, referrer code ABC123, and note in metadata that they signed up at the conference booth.
Find Top Referrers
@Viral Loops search participants sorted by referral count descending and return the top 10 with their email, rank, and total referrals.
Look Up Participant Details
@Viral Loops get participant details for user@example.com including their referral code, total referrals, current rank, and any rewards earned.
Track Conversion Event
@Viral Loops track a conversion for participant user@example.com because they just completed their first purchase and qualified for the milestone reward.
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@viral-loops show me the top 10 participants in our campaign by referral count, including their current reward status
Searching the connected campaign and sorting by referral count. The top 10 participants include: sarah@example.com (47 referrals, Milestone 3 unlocked), james@example.com (42 referrals, Milestone 3 unlocked), maria@example.com (38 referrals, Milestone 2 unlocked), and seven others ranging from 31 to 35 referrals. All ten have completed at least Milestone 2. The campaign currently has 1,847 total participants and 3,204 referrals tracked. This snapshot reflects live campaign state as of the query.
This example demonstrates read-only leaderboard queries using Search Participants and Get Campaign Stats. Useful for monitoring campaign momentum without side effects. Requires API key with read access to participant data; large campaigns may need pagination if you request more than the default page size.
@viral-loops register emma.chen@startup.io with referrer code LAUNCH2024 and tag her acquisition source as 'ProductHunt'
Participant registered successfully. Emma Chen (emma.chen@startup.io) is now enrolled in the campaign with referrer code LAUNCH2024. Acquisition source tagged as 'ProductHunt'. Her unique referral code is EC8K2M. The referrer associated with LAUNCH2024 now has one additional referral credited. Emma is eligible to earn rewards as she refers others. Note: Viral Loops does not provide an API method to delete participant records once created.
This example shows participant registration with referrer attribution, a core workflow for growth campaigns. CRITICAL: Registration is permanent—Viral Loops offers no delete endpoint. Always validate email addresses before registering. Requires API key with write access. Consider GDPR implications for EU participants.
@viral-loops check if any participants referred by code LAUNCH2024 have converted in the last 48 hours, then draft a thank-you message for the referrer
Looking up the participant with referral code LAUNCH2024, then retrieving their referrals and checking conversion status. Found 12 referrals; 3 converted in the last 48 hours: emma.chen@startup.io (14 hours ago), david.kim@agency.co (22 hours ago), and priya.shah@consulting.com (31 hours ago). Draft message: 'Hi [Referrer Name], great news—three people you referred (Emma, David, and Priya) have converted in the past two days! Your campaign impact is growing. Thanks for spreading the word.' This combines live referral data with AI-generated personalization.
This example pairs List Participant Referrals with AI synthesis to create actionable insights. Demonstrates how the MCP enables workflow automation (data retrieval + reasoning). Conversion timestamps depend on when Track Participant Conversion was called; this is illustrative. Requires read access to participant and referral data.
Use-case deep-dives
When Viral Loops wins for pre-launch referral campaigns
A 6-person startup building a SaaS product wants to collect 5,000 waitlist signups before launch and reward early advocates with tiered perks. Viral Loops is the right call here because the MCP exposes campaign stats, participant rank, and referral counts in real time—your team can pull leaderboard data into Slack or a dashboard without logging into the vendor UI. The Register Participant and Track Participant Conversion tools let you script signup flows and mark beta invites as conversions when people activate. The trade-off: conversion tracking is irreversible, so test your automation logic on a staging campaign first. If you need sub-hour leaderboard updates and can live with API-key auth, this MCP handles the entire referral loop from a shared workspace.
When this MCP scales for post-sale advocacy programs
A 12-person B2B company runs a customer referral program where existing users earn credits for bringing in new accounts. The CS team needs to look up referral status during support calls and verify reward eligibility before issuing payouts. Viral Loops works well here because Search Participants and Get Participant return referral totals and reward summaries by email—your CS reps can query participant data from the AI workspace without switching tabs. The List Participant Referrals tool shows the full chain, so you can audit multi-tier referrals when a customer disputes a credit. The boundary: if your program has complex eligibility rules (spending thresholds, contract types), Viral Loops won't enforce them—you'll need to layer that logic in your own system. For straightforward referral counting at mid-market scale, this MCP keeps the CS team moving.
When batch lookup matters for conference ticket campaigns
A 4-person events team is running a referral campaign for a 500-attendee conference—early registrants get discounted tickets if they refer three friends. The team needs to reconcile Typeform submissions against Viral Loops participants every morning to issue promo codes. The Look Up Participants tool is built for this: it accepts a batch of emails and returns matching campaign records with one call, so you can script the reconciliation instead of clicking through the vendor dashboard. Get Campaign Stats gives you a daily pulse check on lead count and referral velocity. The catch: if your event has multiple ticket tiers or conditional pricing, Viral Loops won't model that—it tracks referrals, not SKU logic. For single-tier campaigns under 2,000 registrants, this MCP automates the busywork and keeps your Typeform-to-promo-code pipeline in one workspace.
Frequently asked
What does the Viral Loops MCP do in Switchy?
It connects your Viral Loops referral campaign to Switchy's AI workspace so your team can query participant data, register new leads, track conversions, and pull campaign stats without switching to the Viral Loops dashboard. You can search participants by conversion status, look up referral chains, and automate reward workflows directly from chat.
Do I need admin access to connect Viral Loops?
You need a Viral Loops API key, which typically requires campaign owner or admin permissions in your Viral Loops account. The key grants full read-write access to participant data and conversion tracking for the connected campaign, so only authorised team members should configure this integration in Switchy.
Can the MCP delete participants or undo conversions?
No. Viral Loops provides no API operation to delete participant records, and conversion tracking is irreversible—once you mark a participant as converted, that event is permanent and may trigger rewards or automation. If you need to clean up test data, you must do that directly in the Viral Loops dashboard before connecting.
How does this compare to using Viral Loops directly?
The MCP exposes the same participant and campaign data as the Viral Loops dashboard, but you query it conversationally in Switchy instead of clicking through tabs. It's faster for bulk lookups, referral chain analysis, and integrating referral data into broader workflows—like syncing leads to your CRM or triggering conversions from support tickets.
Who on the team should connect this integration?
Whoever owns your referral program—usually growth, marketing, or product ops. Because the MCP can register participants and irreversibly track conversions, limit access to people who understand your campaign rules and won't accidentally trigger rewards. It doesn't count against Switchy seat limits, but Viral Loops may bill per participant or campaign.