Integration

ReferralHero integration

ReferralHero runs referral, waitlist and contest campaigns. List your lists (campaigns), list subscribers and fetch one by id or email with their referral code, links, points and referral counts, add a subscriber (optionally with a referrer), and complete a referral conversion event. Creating lists, updating, promoting or deleting subscribers, confirming referrals, points, transactions, rewards and coupons are not exposed. Authentication is the account API token (Account > API in the dashboard) sent as a Bearer token in the Authorization header; the vendor applies a soft limit of 5,000 calls per hour.

Connect ReferralHero How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in ReferralHero.Built from the 6 ReferralHero tools below, on the connection you add once.

What you can do with ReferralHero

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Subscriber, 4 operations

add_subscriberAdd subscriberPOSTAdds a subscriber to a list (uuid from list_lists) by the campaign identifier (email, phone_number, crypto_wallet_address or other_identifier_value). double_optin true sends a confirmation email, false sends none.
get_subscriberGet subscriberGETReturns one verified subscriber of a list by id; a non-verified subscriber answers subscriber_not_found.
get_subscriber_by_emailGet subscriber by emailGETReturns one verified subscriber of a list by email; a non-verified subscriber answers subscriber_not_found.
list_subscribersList subscribersGETLists the subscribers of a list, up to 50 per page, with optional sort and filters on extra fields or Stripe customer id.

List, 1 operation

list_listsList listsGETLists the active lists (campaigns) of the account, 10 per page, with their uuid, name, subscriber count and creation time. Use a uuid in the other tools.

Referral conversion, 1 operation

track_referral_conversion_eventTrack referral conversion eventPOSTCompletes a referral conversion event (campaigns tracking two or three events): the pending referral becomes confirmed or unconfirmed. An unknown referral is created only when referrer is given.

Use ReferralHero from Claude Code, Cursor or Codex

Connect ReferralHero in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its ReferralHero operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect ReferralHero

Create your workspace
Sign up free. Nothing to install.
Connect ReferralHero once
Add your ReferralHero connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.