# Referrals.com MCP by usefulapi

> Referrals.com MCP by usefulapi is an MCP server. Read brands, campaigns and stats; create or update brands and campaigns in Referrals.com. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/referrals-com/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/referrals-com
- **MCP Registry name:** io.usefulapi/referrals-com
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

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

```sh
https://referrals-com.usefulapi.io/mcp
```

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

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

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

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

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

```json
{
  "mcpServers": {
    "referrals-com": {
      "serverUrl": "https://referrals-com.usefulapi.io/mcp"
    }
  }
}
```

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

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

## Tools

- `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. API: POST /v1/campaigns.
- `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.

## FAQ

### How do I add Referrals.com MCP by usefulapi to Claude Code?

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

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