MCP server
Referrals.com MCP by usefulapi
Read brands, campaigns and stats; create or update brands and campaigns in Referrals.com.
- Runs
- Remotely
- Version
- 1.4.0
- Listing updated
- 4 days ago
About Referrals.com MCP by usefulapi
Referrals.com MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Install
Run in a terminal
claude mcp add --transport http referrals-com https://referrals-com.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://referrals-com.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"referrals-com": {
"url": "https://referrals-com.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"referrals-com": {
"type": "http",
"url": "https://referrals-com.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"referrals-com": {
"serverUrl": "https://referrals-com.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"referrals-com": {
"type": "http",
"url": "https://referrals-com.usefulapi.io/mcp"
}
}
}Tools this server provides (15)
Read directly from the server.
- 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.
Referrals.com MCP by usefulapi 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