ViralSweep MCP by usefulapi

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

Read ViralSweep brands, promotions, entrant summaries and existing winners.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Hosted read-only MCP access to ViralSweep brands, promotions, entrant summaries and existing winners, with usage metering and subscription tools.

What you can do
  • List brands and their promotions, optionally active or archived
  • Read promotion entries with entrant emails and entry/referral counts, searchable by email address
  • Read a promotion's existing winners and prize titles, filterable by Unix timestamps
  • Check monthly tool-call usage, request a missing feature, and start or cancel a paid plan
When to use it
Useful when you want an assistant to look up ViralSweep giveaway data — which brands and promotions exist, who entered, and who already won — without opening the dashboard. It is read-only, so it suits reporting and quick lookups rather than running or editing campaigns.
Requirements
A remote MCP endpoint added by URL only; no API key or Authorization header. Sign-in happens through OAuth on a hosted page that asks for your own ViralSweep credentials. A free tier allows 50 tool calls per month; paid plans raise the limit.
Before you install
The hosted sign-in page collects your ViralSweep account credentials, so trust in the third-party host matters. Entrant data includes email addresses, which are sent to the assistant and the hosting service. Subscription tools can start a paid plan through a Stripe Checkout link or cancel it, with no refund for the current period; confirm before running them.

Installation

In SourceWeft

  1. Open ViralSweep 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%2Fviralsweep/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": {
    "viralsweep-by-usefulapi": {
      "type": "http",
      "url": "https://viralsweep.usefulapi.io/mcp"
    }
  }
}

README

ViralSweep MCP by usefulapi

https://viralsweep.usefulapi.io/mcp

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://viralsweep.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http viralsweep https://viralsweep.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": {    "viralsweep": {      "url": "https://viralsweep.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 ViralSweep credentials.

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

Connect your own ViralSweep credentials through the hosted sign-in page.

Tools

ToolTypeWhat it does
viralsweep_list_brandsreadList ViralSweep brands
viralsweep_list_promotionsreadList ViralSweep promotions
viralsweep_list_entriesreadRead ViralSweep promotion entries
viralsweep_list_winnersreadRead ViralSweep winners
viralsweep_usage_statusmetaUsage status (free-tier meter)
viralsweep_request_featuremetaRequest a missing feature
viralsweep_upgrademetaUpgrade to Pro or Pro+
viralsweep_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 viralsweep_upgrade (it returns a Stripe Checkout link). Cancel any time with viralsweep_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running viralsweep_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT

Source: servers/viralsweep/README.md at commit 4046075

Tools

4

viralsweep_list_brands

List ViralSweep brands

Read account brands. Offset/limit page a bounded vendor response locally; no vendor-native pagination is claimed.

Parameterslimitoffset

viralsweep_list_promotions

List ViralSweep promotions

Read promotions for a brand, optionally active or archived. Offset/limit page a bounded vendor response locally.

Parameterslimitoffsetbrand_idrequiredactive_onlyinclude_archived

viralsweep_list_entries

Read ViralSweep promotion entries

Read one vendor page of entrants, their emails and entry/referral counts. Optional query searches email addresses. Login links and arbitrary form fields are excluded.

Parameterspagecountquerypromotion_idrequired

viralsweep_list_winners

Read ViralSweep winners

Read a promotion's winners and prize titles, optionally filtered by Unix timestamps. Reads existing winners without selecting new ones. Offset/limit page a bounded response locally; private login and prize redemption codes are excluded.

Parameterslimitend_tsoffsetbegin_tspromotion_idrequired

Version history

11
  1. v1.7.4LatestNov 7, 2026
  2. v1.6.3Nov 5, 2026
  3. v1.6.2Nov 5, 2026
  4. v1.6.1Nov 4, 2026
  5. v1.6.0Nov 3, 2026
  6. v1.5.1Nov 3, 2026
  7. v1.4.0Nov 1, 2026
  8. v1.2.0Oct 31, 2026
  9. v1.1.0Oct 31, 2026
  10. v1.0.3Oct 30, 2026
  11. v1.0.1Oct 30, 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