OpenPromoter
MCP server letting AI clients read and manage an affiliate program, with payouts left
The server answered 3 hours ago with a sign-in request for OAuth (HTTP 401), so we could not list its tools.
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://app.openpromoter.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"openpromoter-mcp": {
"url": "https://app.openpromoter.com/mcp"
}
}
}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/mcpEnter 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 & webhooksRequiredOPENPROMOTER_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.