# Referralmeter

> Referralmeter is an MCP server for sales and crm. MCP server for running an affiliate program: affiliates, commissions and payouts. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API
- **Website:** https://referralmeter.com/docs/mcp
- **Repository:** https://github.com/ajussis/referralmeter-js
- **MCP Registry name:** com.referralmeter/mcp
- **Categories:** [sales and CRM](https://ai-powered.com/categories/sales-and-crm), [marketing and SEO](https://ai-powered.com/categories/marketing-and-seo)
- **Listing updated:** 2026-11-14

## About

Authentication is a secret key sent as a Bearer token, and the key's scope decides what the assistant may do: a read-only key can use every read tool, while tools that change something need the write scope. The docs state that no tool moves money, and payouts are created and marked paid by the owner in the dashboard.

Beyond reporting, the server helps a coding agent install tracking in the user's app. It returns numbered steps for a chosen framework and billing provider, then starts a verification run with a test link and reports each step's status. Test traffic is never paid out.

On the management side it can approve or reject affiliates, edit commission rules (applying only to future commissions), and create Stripe promo codes that credit sales to a given affiliate. The server is stateless and answers with plain JSON rather than an SSE stream.

## Features

- **Install guidance:** Returns exact steps for tracking script, signup call, checkout metadata and webhooks.
- **Install verification:** Starts a test-mode run and reports each step until it passes.
- **Affiliate management:** Lists, approves and rejects affiliates, with an optional ban.
- **Commission rules:** Updates rate, duration, hold period and minimum payout going forward.
- **Stripe promo codes:** Creates a discount code in Stripe and credits its sales to an affiliate.
- **Live reporting:** Gives stats and click-source reports by source, landing page or sub-ID.

## Good for

- Ask Claude Code to install affiliate tracking in a billing-connected app
- Review which affiliates are pending and approve them
- Check what each affiliate is owed before a payout run
- See where affiliate clicks and referred revenue come from

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://referralmeter.com/api/mcp
```

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

```sh
https://referralmeter.com/api/mcp
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://referralmeter.com/api/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://referralmeter.com/api/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://referralmeter.com/api/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://referralmeter.com/api/mcp
```

Enter a Name (for example "Referralmeter"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

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

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://referralmeter.com/api/mcp"
    }
  }
}
```

## Tools

- `get_program`: Program name, public key, portal URL, currency and commission rules.
- `get_install_instructions`: Numbered steps to install tracking for a framework and billing provider.
- `start_verification`: Starts or resumes an install verification and returns a test link.
- `get_verification`: Status of an install verification with diagnostics.
- `list_affiliates`: Affiliates with clicks, paying customers and earnings.
- `get_affiliate`: One affiliate by id.
- `create_stripe_promo_code`: Creates a Stripe discount code credited to an affiliate.
- `approve_affiliate`: Approves a pending affiliate.
- `reject_affiliate`: Rejects or bans an affiliate.
- `update_commission_rules`: Changes the program's commission rules.
- `list_commissions`: Commissions filtered by status, affiliate or date.
- `get_stats`: Live program numbers for the last N days.
- `get_report`: Click sources and referred revenue by month.
- `list_affiliate_coupons`: Coupon codes crediting an affiliate.
- `add_affiliate_coupon`: Credits an affiliate when a code is used at checkout.
- `list_payouts`: Payout batches and status.
- `get_payout`: A payout batch and its members.
- `list_payouts_due`: What the program owes each affiliate now.

## FAQ

### How does it authenticate?

With a secret key (sk_…) sent as an Authorization Bearer header; read-only keys cover read tools and write tools need the write scope.

### Can it send payouts?

No. The docs say no tool moves money; payouts are handled by the owner in the dashboard.

### Which clients are documented?

Claude Code and Cursor, plus any client that supports remote HTTP servers with custom headers.

### Does it use SSE?

No. It is stateless over Streamable HTTP and answers with application/json.

### How do I add Referralmeter to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://referralmeter.com/api/mcp

### What are the best alternatives to Referralmeter?

The closest alternatives to Referralmeter are Referly, Affonso, Affitor, OpenPromoter and Affiliate Router MCP.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Referly](https://ai-powered.com/mcp/referly): Referly is a freemium MCP server for sales and crm.
- [Affonso](https://ai-powered.com/mcp/affonso): Affonso is an MCP server for marketing and seo.
- [Affitor](https://ai-powered.com/mcp/affitor): Affitor is an MCP server for marketing and seo.
- [OpenPromoter](https://ai-powered.com/mcp/openpromoter): OpenPromoter is an open-source MCP server for marketing and seo.
- [Affiliate Router MCP](https://ai-powered.com/mcp/affiliate-router-mcp): Affiliate Router MCP is an open-source MCP server for finance and payments.
- [RefRef](https://ai-powered.com/mcp/refref): RefRef is a freemium MCP server for marketing and seo.
- [Signal Beam](https://ai-powered.com/mcp/signal-beam): Signal Beam is an MCP server for communication.
- [Kickrail](https://ai-powered.com/mcp/kickrail): Kickrail is a freemium MCP server for marketing and seo.

---
Source: https://ai-powered.com/mcp/referralmeter
