Skip to main content
The FirstPromoter Affiliate MCP server is experimental. Tool names and parameters may change without notice.
The Affiliate MCP server lets you, as an affiliate, ask an AI assistant about your own performance in a FirstPromoter program: referrals, commissions, payouts, links, promo codes and reports. It is available to every affiliate.
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)

Run /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):
Other MCP clients that support streamable HTTP with custom headers use the same URL and Authorization header.

Claude Desktop

Claude Desktop’s configuration file starts local servers, so use the mcp-remote bridge (requires Node.js). Open Settings → Developer → Edit Config and add:
Restart Claude Desktop after saving the file.

Several programs

Add one entry per program, each with its own key, for example firstpromoter-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 Authorization header 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.