io.usefulapi/referrals-com

up checked 2026-11-11T15:37:37.624Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

Referrals.com MCP by usefulapi

Publisher-provided description

Read brands, campaigns and stats; create or update brands and campaigns in Referrals.com.

Summary by lookupd

Lets an agent read and edit brands and referral campaigns in Referrals.com, and pull participant data and analytics.

Install

Claude Code, remote (streamable-http)

claude mcp add --transport http referrals-com https://referrals-com.usefulapi.io/mcp

Codex, remote (streamable-http)

codex mcp add referrals-com --url https://referrals-com.usefulapi.io/mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

{
  "mcpServers": {
    "referrals-com": {
      "url": "https://referrals-com.usefulapi.io/mcp"
    }
  }
}

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (15 tools)

Publisher-provided text

• referrals_com_get_profile Get the Referrals.com account that the API key belongs to: name, email and plan. Good first call to confirm the key works. API: GET /v1/members/profile.
• referrals_com_list_brands List the brands (websites) in the account. A brand owns campaigns. API: GET /v1/brands.
• referrals_com_get_brand Get one brand by id: its URL, domain, description and logo. API: GET /v1/brands/{brandId}.
• referrals_com_get_brand_stats Get analytics for one brand: campaigns, participants, shares, clicks and impressions. API: GET /v1/brands/{brandId}/stats.
• referrals_com_create_brand Create a brand (a website that runs referral campaigns). Creates a new record; it is not undone by a retry. API: POST /v1/brands.
• referrals_com_update_brand Change a brand's description or logo URL. Fields you omit stay as they are. API: PUT /v1/brands/{brandId}.
• referrals_com_list_campaigns List campaigns, optionally for one brand. API: GET /v1/campaigns.
• referrals_com_get_campaign Get one campaign with its widget, reward and contest settings. API: GET /v1/campaigns/{campaignId}.
• referrals_com_get_campaign_stats Get campaign stats: participants, shares, clicks, impressions and daily signups. API: GET /v1/campaigns/{campaignId}/stats.
• referrals_com_create_campaign Create a campaign under a brand. Creates a new record. The reward_type and type_id codes are not listed in the public docs: check them in the dashboard first. A
• referrals_com_update_campaign Change a campaign's name or publish setting. Fields you omit stay as they are. API: PUT /v1/campaigns/{campaignId}.
• referrals_com_list_participants List participants (people who joined a referral campaign), optionally for one campaign. API: GET /v1/participants.
• referrals_com_get_participant Get one participant with their shares, rewards and invited emails. API: GET /v1/participants/{participantId}.
• referrals_com_list_webhooks List the webhook URLs registered in the account. API: GET /v1/webhooks.
• referrals_com_get_lander Get the lander page settings of one campaign: template, header and footer text, background, brand and social links. API: GET /v1/lander.

Details

• Version: 1.1.3
• Transports: streamable-http
• Uptime (7 days): 100%
• Median latency: 562 ms
• First indexed: 2026-11-07T14:17:27.313Z
• Last seen in registry: 2026-11-11T00:17:32.302Z
• Repository: https://github.com/m190/usefulapi-mcp
• Website: https://usefulapi.io/referrals-com/

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.usefulapi/referrals-com.svg)](https://lookupd.com/servers/io.usefulapi/referrals-com)

• 62071 servers
• Last crawl: 2026-11-11T16:39:06.253Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp