Skip to content
MCP server

Referral Rock MCP by usefulapi

Read Referral Rock programs, members, referrals, rewards and payouts; add members and…

Install
Runs
Remotely
Version
1.20.0
Listing updated
4 days ago

About Referral Rock MCP by usefulapi

Referral Rock MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Read Referral Rock programs, members, referrals, rewards and payouts; add members and referrals.

Install

Run in a terminal

claude mcp add --transport http referral-rock https://referral-rock.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://referral-rock.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "referral-rock": {
      "url": "https://referral-rock.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": {
    "referral-rock": {
      "type": "http",
      "url": "https://referral-rock.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "referral-rock": {
      "serverUrl": "https://referral-rock.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "referral-rock": {
      "type": "http",
      "url": "https://referral-rock.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (15)

Read directly from the server.

referralrock_list_programs
List the referral programs in the account: id, name, type (Web or Form), active flag, title, the member and referral offers and the share/widget URLs. Use the ids (or names) to filter members, referrals and rewards. GET /api/programs.
referralrock_get_program
One referral program by its exact name: id, active flag, offers and URLs. GET /api/program/getsingle.
referralrock_list_reward_rules
The reward rules of one program: what triggers a reward (referral status, referral count or sales limits), how the amount is worked out (fixed or percent), the payout type and delivery delay. GET /api/rewardrules.
referralrock_list_members
List members (the people who refer others), newest first by default, with their referral code and share URL, referral counts, rewards earned and activity dates. Filter by program, by an email / id / external id / referral code, by created date, or active vs disabled. GET /api/members.
referralrock_get_member_stats
Sharing, referral and reward statistics of one member over a time period: views, shares, referrals (pending / qualified / approved), reward amounts pending and issued, last share and activity dates. GET /api/memberstats/getsingle.
referralrock_list_referrals
List referrals (the people members referred), newest first by default, with status (pending, qualified, approved, denied), amount, the referring member, notes and dates. Filter by program, status, referring member, free-text query or created date. GET /api/referrals.
referralrock_get_referral
One referral by id, email address or external id (at least one is required): status, amount, referring member, notes, custom fields and dates. GET /api/referral/single.
referralrock_list_rewards
List rewards, newest first by default: recipient, amount, status (Pending, Processing, Issued), payout type, eligibility and issue dates, the member and referral behind it. Filter by program, member, status, recipient query or created date. GET /api/rewards.
referralrock_list_pending_payouts
Payouts that are owed but not yet transferred: recipient, program, number of rewards and total amount. Optionally for one recipient, and optionally including rewards whose eligibility date is still in the future. GET /api/payouts/pending.
referralrock_list_payout_transactions
Payout transactions already transferred to program participants (type, amount, date, status, destination, vendor errors) and the balance left in the account to cover pending payouts. Optionally for one recipient or one transaction. GET /api/payouts/transactions.
referralrock_create_member
WRITE: creates a new member (advocate) in a referral program and returns the member with their referral code and share URL. Not idempotent: a repeat call may create a duplicate or fail. When send_confirmation_email is true Referral Rock emails the member the program's confirmation email, which is a message to a real person; the default is false. POST /api/members.
referralrock_update_member
WRITE: changes contact details of an existing member, or disables / re-enables the member (a disabled member can no longer take part in the programs). Only the fields you pass are changed. The member is found by id, referral code, or email / external id plus program_id or program_name; Referral Rock updates it only when it is uniquely identified. POST /api/members/update.
referralrock_create_referral
WRITE: adds a referral (a lead) to the program of the member who owns the given referral code, as if the lead had used that member's link. A status of qualified or approved can trigger the program's configured rewards for the member, which is a financial commitment, so leave status out (new referrals start as pending) unless you mean it. Not idempotent. POST /api/referrals.
referralrock_update_referral
WRITE: changes the status, amount or notes of an existing referral. Moving a referral to qualified or approved can trigger the program's configured rewards for the referring member (a financial commitment that may be paid out automatically), and denied stops them: confirm with the user first. Only the fields you pass are changed. The referral is found by id, or by external id / email plus program_
referralrock_record_customer
WRITE: reports a paying customer to Referral Rock. A customer whose email matches a pending referral turns that referral to approved, which triggers the program's configured rewards for the referring member (a financial commitment that may be paid out automatically). A customer with no matching referral is added as a pre-loaded member to every program that has Preload New Customers on. Returns the

Referral Rock MCP by usefulapi FAQ

How do I add Referral Rock MCP by usefulapi to Claude Code?

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