# Referly

> Referly is a freemium MCP server for sales and crm. Hosted MCP server to run a Referly affiliate program from any AI assistant. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $29 a month
- **Platforms:** API, Web
- **Website:** https://www.referly.so/ai/mcp
- **MCP Registry name:** so.referly/referly
- **Categories:** sales and CRM
- **Listing updated:** 2026-11-18

## About

The Referly MCP server lets an AI client work on an affiliate program directly: finding affiliates, reviewing referrals and sales, managing commission plans, coupons and promo codes, and preparing payout batches. It runs as a remote server at a single URL and signs in with a Referly account through OAuth 2.1, so no API key is needed.

Access is controlled by scopes. Read access is on by default, while write access, payout preparation and team management are separate scopes the account owner approves. Write actions such as changing affiliate status or commissions show a preview before they run, and payouts stop at a prepared batch; the README and page say money is paid from the Referly dashboard, not by the assistant.

The server is aimed at program managers and developers at companies running affiliate, referral or partner programs on Referly. A separate Referly Atlas server, covering ad spend and attribution, is offered alongside it at its own URL.

## Features

- **Single remote URL:** Connects to any MCP client over Streamable HTTP without installing a local server.
- **OAuth sign-in:** Uses OAuth 2.1 with PKCE and short-lived, revocable tokens instead of an API key.
- **Scoped access:** Separate scopes cover reading data, changing settings, preparing payouts and managing the team.
- **Previewed writes:** Changes such as bulk status updates or sales edits show a preview before they are applied.
- **Payouts stop at a batch:** The server can prepare payout batches but does not send money; payment happens in the dashboard.
- **Broad tool coverage:** The page lists its tools across affiliates, sales, commissions, payouts, reports and program setup.

## Good for

- Asking an AI assistant which affiliates drove the most revenue this month
- Reviewing pending referrals and approving or holding them in bulk
- Preparing a payout batch for the next payout date for a developer or finance team to pay
- Creating coupons and promo codes for a new affiliate campaign
- Sending a daily affiliate activity check through an agent or chat app

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http referly https://mcp.referly.so/mcp
```

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

```sh
https://mcp.referly.so/mcp
```

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

```json
{
  "mcpServers": {
    "referly": {
      "url": "https://mcp.referly.so/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "referly": {
      "type": "http",
      "url": "https://mcp.referly.so/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "referly": {
      "serverUrl": "https://mcp.referly.so/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "referly": {
      "type": "http",
      "url": "https://mcp.referly.so/mcp"
    }
  }
}
```

## Tools

- `list_affiliates`: Affiliates filtered by status, source, plan, tier, group, country, revenue or clicks.
- `list_referrals`: Referrals with filters: status, affiliate, plan, date and customer.
- `list_transactions`: Sales and commissions with status, paid-out, type, group and amount filters.
- `create_coupon`: Creates a coupon and its codes in Stripe, Shopify or Polar too. Previews first.
- `create_payout_batches`: Prepares payout batches. Nothing is sent; you pay from the dashboard.
- `get_program_overview`: KPIs, top affiliates and breakdowns for a period. Defaults to the last 30 days.

## FAQ

### Which transport does the server speak?

Streamable HTTP over POST, stateless. Clients that only run local servers, or still expect SSE, can use the mcp-remote bridge.

### Can I use a token instead of signing in?

The page documents a personal token option for scripts, CI and agents with no browser, created in Settings and revocable there.

### Can an assistant send payouts?

No. The page states payouts stop at a prepared batch and are paid from the Referly dashboard.

### Does it cost extra?

The server is offered with Referly plans; the pricing page lists AI and MCP access as a feature included in the plan comparison, starting at $29 a month with a 14-day trial for $1.

### Is Referly free?

Referly has a free plan, with paid plans for more usage or features. Paid plans start at $29 a month.

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

Run this command in your terminal: claude mcp add --transport http referly https://mcp.referly.so/mcp

### What are the best alternatives to Referly?

The closest alternatives to Referly are Calven, CompanyData, MisarReach MCP Server, NeuralVerge and ZUUZ.

## Where this comes from

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

## Alternatives

- [Calven](https://ai-powered.com/mcp/calven): Calven is an MCP server for marketing and seo.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [MisarReach MCP Server](https://ai-powered.com/mcp/misarreach-mcp-server): MisarReach MCP Server is a freemium MCP server for sales and crm.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [ZUUZ](https://ai-powered.com/mcp/zuuz): ZUUZ is an MCP server for sales and crm.
- [Fuse](https://ai-powered.com/mcp/fuse-2): Fuse is a freemium MCP server for sales and crm.
- [Gender-API.com](https://ai-powered.com/mcp/gender-api-com): Gender-API.com is a freemium MCP server for analytics and data.
- [Dialvett: Bulk Phone Number Validator & Carrier Lookup](https://ai-powered.com/mcp/dialvett-bulk-phone-number-validator-and-carrier-lookup): Dialvett: Bulk Phone Number Validator & Carrier Lookup is a paid MCP server for analytics and data.

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