# Viral Loops MCP by usefulapi

> Viral Loops MCP by usefulapi is a freemium MCP server for marketing and seo. Hosted MCP server to read Viral Loops referral campaign stats, participants and rewards. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web, vscode
- **Website:** https://usefulapi.io/viral-loops/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/viral-loops
- **MCP Registry name:** io.usefulapi/viral-loops
- **Categories:** marketing and SEO
- **Listing updated:** 2026-11-18

## About

The server connects an AI client such as Claude, ChatGPT or Cursor to a single Viral Loops campaign, so questions about leads, referrals, waiting-list ranks and rewards can be answered in plain language. It runs remotely over Streamable HTTP, so there is nothing to install locally. Sign-in is handled through OAuth, with the campaign's secret API token entered on the login page.

The README and product page stress that all 11 data tools are read-only, covering campaign stats and info, participant lookups, join order, referral trees and pending or given rewards. Four additional meta tools report usage against the monthly meter, send feature requests, and manage a Pro or Pro+ subscription. Each paid plan applies only to this server.

The server suits marketers and growth staff who run referral or giveaway campaigns in Viral Loops and want quick answers without opening the dashboard. It is an independent service from usefulapi and is not affiliated with Viral Loops.

## Features

- **Campaign statistics lookup:** Returns lead counts, total referrals and the campaign configuration, including type and expiration.
- **Participant profile reads:** Shows one participant's rank, join order, referral and points totals, referrer and rewards.
- **Referral chain tracing:** Lists who referred a participant and who that participant referred in turn.
- **Participant search and filters:** Searches campaign participants with filters and paging, returning results and a total count.
- **Reward status reporting:** Lists pending and already given rewards for one participant or across the campaign.
- **Read-only data access:** All 11 Viral Loops tools are marked read-only, so the AI cannot change campaign data.

## Good for

- Check how many leads and referrals a referral campaign has produced
- Find the top participants on a waiting list and their referral counts
- Review pending rewards before a payout run
- Find referred participants who have not yet converted
- Trace the referral chain behind a specific participant

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http viral-loops https://viral-loops.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://viral-loops.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "viral-loops": {
      "url": "https://viral-loops.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "viral-loops": {
      "type": "http",
      "url": "https://viral-loops.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "viral-loops": {
      "serverUrl": "https://viral-loops.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `viralloops_get_campaign_stats`: Get the number of leads and the total referral count of the campaign.
- `viralloops_get_campaign_info`: Get the campaign configuration: type, template, company name, landing page, widgets and expiration.
- `viralloops_get_participant`: Get one participant: name, referral code, extra data, rank, referral and points totals, referrer, and pending or redeemed rewards.
- `viralloops_get_participant_rank`: Get the rank of a participant on the waiting list or leaderboard.
- `viralloops_get_participant_order`: Get the order in which a participant joined and the total lead count.
- `viralloops_list_participant_referrals`: List the people a participant referred, with paging.
- `viralloops_get_participant_referrer`: Get the participant who referred the given participant.
- `viralloops_search_participants`: Search the campaign participants with filters and paging. Read-only.
- `viralloops_query_participants`: Get data for a list of participants by email or referral code, or their referrals. Read-only.
- `viralloops_list_pending_rewards`: List pending rewards of one participant, or a paged list of participants with pending rewards.
- `viralloops_list_given_rewards`: List rewards already given to one participant, or a paged list of participants with given rewards.

## FAQ

### What do I need to connect?

The login page asks for your campaign secret API token, which is found in the campaign editor under Settings → Installation. One token covers one campaign.

### Can the AI change my Viral Loops data?

No. The README and product page state that all 11 Viral Loops tools are read-only.

### Which AI clients are supported?

Any client that supports remote MCP servers over Streamable HTTP with OAuth, including Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code, Windsurf and others.

### Is this an official Viral Loops product?

No. The product page says usefulapi is an independent service and is not affiliated with or endorsed by Viral Loops.

### Is Viral Loops MCP by usefulapi free?

Viral Loops MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Viral Loops MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http viral-loops https://viral-loops.usefulapi.io/mcp

### What are the best alternatives to Viral Loops MCP by usefulapi?

The closest alternatives to Viral Loops MCP by usefulapi are Google Ads + Meta Ads + SEO/GEO MCP, Calven, Snapchat Ads MCP Server, MCP and Red Center Studio free tools.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [Snapchat Ads MCP Server](https://ai-powered.com/mcp/snapchat-ads-mcp-server): Snapchat Ads MCP Server is an open-source MCP server for marketing and seo.
- [MCP](https://ai-powered.com/mcp/mcp-mwhffe53): MCP is a freemium MCP server for marketing and seo.
- [Red Center Studio free tools](https://ai-powered.com/mcp/red-center-studio-free-tools): Red Center Studio free tools is a free MCP server for marketing and seo.
- [ASOScan](https://ai-powered.com/mcp/asoscan): ASOScan is an MCP server for marketing and seo.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.

---
Source: https://ai-powered.com/mcp/viral-loops-mcp-by-usefulapi
