This page is for affiliates. If you run an affiliate program, use the MCP server for program admins instead. It connects with OAuth and covers the whole program.
Example prompts
- “How much have I earned this month, and how much is still pending?”
- “List my referrals from the last 30 days that became customers.”
- “When is my next payout and how much will it be?”
- “List my referral links and the campaign each one belongs to.”
- “Compare my clicks, referrals and earnings over the last three months, by month.”
What it can do
- Read-only. The tools only read data. They cannot create, change or delete anything, and they cannot move money.
- Your data only. Every answer is scoped to your own affiliate account in one program, the same data you see in your affiliate dashboard.
- One program per key. The server uses the API key from the program you created it in. If you promote several programs, add one server entry per program, each with that program’s key.
Connection details
Get the API key in your affiliate dashboard under Profile → API & AI tools; see Authentication. The key already identifies the program, so the MCP server does not need an Account ID.
The affiliate server authenticates with an API key header, so it works with MCP clients that let you set custom headers. Connectors that only support OAuth (such as custom connectors on Claude web or ChatGPT) cannot connect to it yet.
Connect
Claude Code (CLI)
/mcp inside a session to verify the connection and browse the available tools.
Cursor
Add the server to~/.cursor/mcp.json (or .cursor/mcp.json in a project):
Authorization header.
Claude Desktop
Claude Desktop’s configuration file starts local servers, so use themcp-remote bridge (requires Node.js). Open Settings → Developer → Edit Config and add:
Several programs
Add one entry per program, each with its own key, for examplefirstpromoter-acme and firstpromoter-globex. The assistant then sees each program as a separate set of tools.
Available tools
Every
list_* tool, including list_campaigns and list_referral_links, is paginated with page (default 1) and per_page (default 20, maximum 50) and returns page, per_page, total_count and total_pages in its meta. The tools return the same fields as the Affiliate API.
Errors
- 401 Unauthorized: the
Authorizationheader is missing, or the key is wrong, regenerated or disabled. - 403 Forbidden: the token is not an affiliate API key (for example a dashboard session or a program admin’s token), your affiliate account is archived, or your email is not confirmed yet.
- A tool can also return an error with the same message the dashboard shows, for example when you still need to add a payout method before you can see your data.
Security
- The MCP server is read-only, but the key behind it is not: anyone who has it can read your data in the program and change it through the Affiliate API. Do not share it or commit it to a repository.
- If a key is exposed, regenerate it in Profile → API & AI tools. The old key stops working for both the API and the MCP server, so update your MCP configuration with the new key.
- Disable API access to cut off every connected AI tool at once.