# OpenPromoter

> OpenPromoter is an open-source MCP server for marketing and seo. MCP server letting AI clients read and manage an affiliate program, with payouts left. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Starting price:** $29 a month
- **Platforms:** Web, CLI, API, vscode, self-hosted
- **Website:** https://openpromoter.com/docs/mcp/
- **Repository:** https://github.com/openpromoter/openpromoter/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.openpromoter/openpromoter-mcp
- **Categories:** [marketing and SEO](https://ai-powered.com/categories/marketing-and-seo)
- **Listing updated:** 2026-11-19

## About

The README says the server connects AI assistants such as Claude, ChatGPT, Cursor and VS Code to an OpenPromoter affiliate program, so questions like which partners brought in paying customers can be answered in chat. It can be added by URL with a sign-in, or run locally over stdio with the openpromoter-mcp npm package and an API key.

Access is read-only by default. Turning on write mode adds tools to invite partners, change partner status, draft campaigns and apply Autopilot suggestions, and the API key's scopes set the limits. Payouts are prepared but never sent by the server; a signed-in person approves them in the dashboard.

It suits affiliate program operators who already work with AI assistants and want quick answers about partners, commissions and revenue without opening the dashboard. Teams that want stricter control can issue keys with only the scopes they need.

## Features

- **Read-only by default:** The npm package registers only read tools unless the write flag is set, and URL connections let you choose read-only access at sign-in.
- **Program and partner queries:** Tools list programs, partners, commissions and payouts, and return partner details with their links.
- **Revenue statistics:** A program_stats tool reports revenue, commissions, clicks, conversions and amounts owed over a chosen window of 1 to 730 days.
- **Scoped write actions:** Optional write tools can invite partners, change partner status, draft campaigns and apply Autopilot suggestions, limited by key scopes.
- **Human-approved payouts:** The prepare_payouts tool creates payout batches that wait in the dashboard until a signed-in person approves them.
- **Multiple connection methods:** Connect by URL with a sign-in, or run the stdio npm package with an API key, including for self-hosted instances.

## Good for

- Asking which partners drove the most revenue over the last 30 days
- Reviewing commissions and payout status for a partner
- Drafting a bounty campaign from a single sentence for a person to launch
- Preparing a monthly payout batch for review before approval
- Checking Autopilot suggestions and recent actions for a program

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http openpromoter-mcp https://app.openpromoter.com/mcp
```

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

```sh
https://app.openpromoter.com/mcp
```

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

```json
{
  "mcpServers": {
    "openpromoter-mcp": {
      "url": "https://app.openpromoter.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "openpromoter-mcp": {
      "type": "http",
      "url": "https://app.openpromoter.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "openpromoter-mcp": {
      "serverUrl": "https://app.openpromoter.com/mcp"
    }
  }
}
```

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

```sh
https://app.openpromoter.com/mcp
```

Enter a Name (for example "OpenPromoter"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin. When we checked, this server asked for OAuth sign-in. If its docs give you an OAuth client ID and secret, enter them in the form's OAuth Client ID and Client Secret fields.

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

```json
{
  "mcpServers": {
    "openpromoter-mcp": {
      "type": "http",
      "url": "https://app.openpromoter.com/mcp"
    }
  }
}
```

## Tools

- `list_programs`: Programs in the workspace
- `program_stats`: Revenue, commissions, clicks, signups, customers, conversion, EPC, MRR and amounts owed for the last N days
- `list_partners`: Partners sorted newest first and filterable by status
- `get_partner`: One partner with their links
- `list_commissions`: The commission ledger, filterable by status and partner
- `list_payouts`: Payouts and their status
- `autopilot_suggestions`: Autopilot's current suggestions and recent actions
- `ask`: A plain-language question answered from the program's data
- `invite_partner`: Invite and approve a partner by email
- `set_partner_status`: Approve, pause, reject or ban a partner
- `draft_campaign`: Create a draft campaign from one sentence; a person launches it
- `apply_autopilot_action`: Apply one Autopilot suggestion; payout suggestions only prepare a batch
- `prepare_payouts`: Prepare payouts for partners over the minimum. Never sends money; a person approves them on the Payouts page

## FAQ

### Can the MCP server send payouts?

No. The README and docs state that no tool sends money. prepare_payouts creates payouts that wait in the dashboard until a signed-in person approves them.

### Are write tools enabled by default?

No. The npm package registers only read tools unless OPENPROMOTER_MCP_WRITE is set to true. When connecting by URL, you choose read-only or read and write during sign-in.

### Which AI clients does it work with?

The docs list Claude, ChatGPT, Cursor, VS Code with GitHub Copilot, Claude Code and Codex for URL connection, and the README also names Windsurf, Gemini CLI and Zed for the npm package.

### What license is the MCP server under?

The docs say the MCP server is MIT licensed, while the OpenPromoter app itself is AGPL-3.0.

### Is OpenPromoter free?

Yes. OpenPromoter is open source, so you can use and self-host it for free.

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

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

### What are the best alternatives to OpenPromoter?

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

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status: checked automatically by AIPoweredBot on 19 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Affitor](https://ai-powered.com/mcp/affitor): Affitor is an MCP server for marketing and seo.
- [Hollerpost](https://ai-powered.com/mcp/hollerpost): Hollerpost is a freemium MCP server for marketing and seo.
- [Referralmeter](https://ai-powered.com/mcp/referralmeter): Referralmeter is an MCP server for sales and crm.
- [Affonso](https://ai-powered.com/mcp/affonso): Affonso is an 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.
- [Amazon Ads MCP](https://ai-powered.com/mcp/amazon-ads-mcp-2): Amazon Ads MCP is an open-source MCP server for marketing and seo.
- [OpenGraph.io MCP Server](https://ai-powered.com/mcp/opengraph-io-mcp-server): OpenGraph.io MCP Server is a freemium MCP server for web search and scraping.
- [ClipperTask](https://ai-powered.com/mcp/clippertask): ClipperTask is a free MCP server for marketing and seo.

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