Skip to content
MCP server

OpenPromoter

MCP server letting AI clients read and manage an affiliate program, with payouts left

Answers · sign-in required (OAuth)

The server answered 3 hours ago with a sign-in request for OAuth (HTTP 401), so we could not list its tools.

Install
Pricing
Open source
Platforms
Web, CLI, API
Runs
Locally or Remotely
Access
Needs sign-in (OAuth)
Version
0.1.3
Listing updated
today

Similar MCP servers

About OpenPromoter

OpenPromoter is an open-source MCP server for marketing and seo. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://app.openpromoter.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "openpromoter-mcp": {
      "url": "https://app.openpromoter.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

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

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

Add to Grok Bot desktop app → Connect apps → Add a custom connector

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.

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

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • OPENPROMOTER_API_KEYAPI key from Settings > API & webhooksRequired
  • OPENPROMOTER_URLYour OpenPromoter URL (defaults to https://app.openpromoter.com)
  • OPENPROMOTER_MCP_WRITESet to true to turn on write tools. No tool can send money.

Tools this server provides (13)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source, from $29 a month

MCP server is MIT licensed; the OpenPromoter app has a free tier and paid plans from $29/mo.

Prices change. Check openpromoter.com before you buy.

OpenPromoter 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.

How AIPoweredBot checks servers