Viral Loops MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.3.4Updated Nov 7, 2026

Read campaign stats, participants, referrals, ranks and rewards in Viral Loops.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Hosted read-only MCP access to Viral Loops campaigns: stats, participants, referrals, ranks and rewards.

What you can do
  • Read campaign stats and configuration: lead and referral counts, campaign type, template, landing page and expiration
  • Look up a single participant's profile, referral code, points, referrer, rank and join order
  • List the people a participant referred, or find who referred them
  • Search and query participants in bulk with filters and paging, returning totals
  • List pending and already-given rewards, for one participant or paged across the campaign
  • Check monthly tool-call usage and manage the subscription plan
When to use it
Useful when you run a Viral Loops referral or waiting-list campaign and want to ask questions about it in chat: how many leads and referrals came in, who is leading the leaderboard, who referred whom, or which rewards are still pending.
Requirements
Remote endpoint at viral-loops.usefulapi.io, added by URL only; sign-in is via OAuth, and on first connect you supply the campaign secret API token from the campaign editor (Settings, Installation). One token covers one campaign. No local install or API key in the client config.
Before you install
You hand the server your Viral Loops campaign secret API token, which it stores per user; one token covers only one campaign. The free tier allows 50 tool calls a month, and paid plans (Pro, Pro+) are billed through Stripe Checkout links returned by the upgrade tool; cancellation runs to the end of the paid period with no refund for the current period. The listed tools are read-only, but the server also offers meta tools that change your subscription and send feature requests.

Installation

In SourceWeft

  1. Open Viral Loops MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fviral-loops/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "viral-loops-by-usefulapi": {
      "type": "http",
      "url": "https://viral-loops.usefulapi.io/mcp"
    }
  }
}

README

Viral Loops MCP by usefulapi

Use your Viral Loops account from Claude, Cursor, or any MCP client. Read campaign stats, participants, referrals, ranks and rewards. Hosted, no local install: connect with your own credentials.

Live endpoint: https://viral-loops.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://viral-loops.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http viral-loops https://viral-loops.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "viral-loops": {      "url": "https://viral-loops.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Viral Loops credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/viral-loops/

On first connect you provide the campaign secret API token (campaign editor → Settings → Installation). One token covers one campaign. The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
viralloops_get_campaign_statsreadCampaign stats
viralloops_get_campaign_inforeadCampaign info
viralloops_get_participantreadGet participant
viralloops_get_participant_rankreadParticipant rank
viralloops_get_participant_orderreadParticipant join order
viralloops_list_participant_referralsreadList participant referrals
viralloops_get_participant_referrerreadGet participant referrer
viralloops_search_participantsreadSearch participants
viralloops_query_participantsreadQuery participants
viralloops_list_pending_rewardsreadList pending rewards
viralloops_list_given_rewardsreadList given rewards
viralloops_usage_statusmetaUsage status (free-tier meter)
viralloops_request_featuremetaRequest a missing feature
viralloops_upgrademetaUpgrade to Pro or Pro+
viralloops_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with viralloops_upgrade (it returns a Stripe Checkout link). Cancel any time with viralloops_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running viralloops_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/viral-loops/README.md at commit 4046075

Tools

11

viralloops_get_campaign_stats

Campaign stats

Get the number of leads and the total referral count of the campaign. Viral Loops API: GET /campaign/stats.

Takes no parameters.

viralloops_get_campaign_info

Campaign info

Get the campaign configuration: type, template, company name, landing page, widgets and expiration. Viral Loops API: GET /campaign/data.

Takes no parameters.

viralloops_get_participant

Get participant

Get one participant: name, referral code, extra data, rank, referral and points totals, referrer, and pending or redeemed rewards. Viral Loops API: GET /campaign/participant/data.

Parametersemailreferral_code

viralloops_get_participant_rank

Participant rank

Get the rank of a participant on the waiting list or leaderboard. Flagged participants are not ranked. Viral Loops API: GET /campaign/participant/rank.

Parametersemailreferral_code

viralloops_get_participant_order

Participant join order

Get the order in which a participant joined (1 = first) and the total lead count. Viral Loops API: GET /campaign/participant/order.

Parametersemailreferral_code

viralloops_list_participant_referrals

List participant referrals

List the people a participant referred, with paging. Viral Loops API: GET /campaign/participant/referrals.

Parametersemaillimitoffsetreferral_codeconversion_status

viralloops_get_participant_referrer

Get participant referrer

Get the participant who referred the given participant. Viral Loops API: GET /campaign/participant/referrer.

Parametersemailreferral_code

viralloops_search_participants

Search participants

Search the campaign participants with filters and paging. Returns results and the total count. Read-only. Viral Loops API: POST /campaign/participant/search.

Parameterslimitoffsetsourcesearch_termconversion_status

viralloops_query_participants

Query participants

Get data for a list of participants (by email or referral code), or for the referrals of a list of referrers. Read-only. Viral Loops API: POST /campaign/participant/query.

Parametersskiplimitreferrersparticipants

viralloops_list_pending_rewards

List pending rewards

List pending rewards of one participant. Without email and referral code, the API returns a paged list of participants and their pending rewards (use limit and skip). Viral Loops API: GET /campaign/participant/rewards/pending.

Parametersskipemaillimitreferral_code

viralloops_list_given_rewards

List given rewards

List rewards already given to one participant. Without email and referral code, the API returns a paged list of participants and their given rewards (use limit and skip). Viral Loops API: GET /campaign/participant/rewards/given.

Parametersskipemaillimitreferral_code

Version history

6
  1. v1.3.4LatestNov 7, 2026
  2. v1.2.3Nov 5, 2026
  3. v1.2.2Nov 5, 2026
  4. v1.2.1Nov 4, 2026
  5. v1.2.0Nov 3, 2026
  6. v1.1.1Nov 3, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations

Ably MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for Ably realtime messaging: inspect channel history, presence and occupancy, publish messages, and review app usage and configuration.

Streamable HTTPWeb executable
Cloud & Infrastructure15 toolsNov 7, 2026

Woffu MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant look up Woffu company users, employment contracts, departments and offices.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

White Label Loyalty MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for White Label Loyalty: browse rewards, read a customer's points wallet and tier progress, and buy rewards with points.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

Weekdone MCP by usefulapi

io.usefulapiOfficial publisher

Hosted Weekdone connector that lets an assistant read weekly reports, teams, objectives and KPIs, and add report items, comments and KPI values.

Streamable HTTPWeb executable
Data & Analytics15 toolsNov 7, 2026

WebinarKit MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant list WebinarKit webinars, their dates, series, meetings and white-label sub-accounts.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026