affiliate-networks-mcp

affiliate-mcp

Integrate your affiliate networks with Claude or Codex.

Network operators: most adapters are community-built and experimental. Adoption gives your team ownership and a verification path; promotion to partial or production still requires current evidence and maintainer review. Find your network's issue under the adopt-this-network label.

Affiliate networks have two sides — and neither has a first-class AI workspace integration.

Publishers earn commissions from the programmes they join. Brands (and the agencies who manage them) run those programmes and pay the commissions out. I wanted to chat to my own affiliate data in the AI workspace I already use; none of the networks had shipped an integration for either side, so I built a broad beta set that covers both publisher and advertiser-side work.

If you're a publisher, you can ask:

"What did I earn across all networks last month?"

"Which programmes have transactions still pending after 90 days?"

"Compare my earnings month on month."

If you're on the brand side — running a programme, or an agency managing several — you can ask:

"How is Acme's programme doing this quarter?"

"Show me revenue across all my clients this week."

"Any anomalies in the affiliate data?"

Your AI workspace figures out which networks to call, fetches the data live from their APIs, and gives you the answer. You can use Claude or Codex to turn it into a sheet, an artifact, an email to your boss, whatever you want.

Free and open source. MIT licensed. Bring your own keys. For the product philosophy, read the AI-native affiliate data manifesto.

Who this is for

This tool serves two audiences. Pick the one that fits — or both, if you wear both hats.

You're a publisher. You earn commissions from affiliate programmes, your dashboards can't keep up with how fast you can think, and you want one conversation that spans every network you're on.

You're on the brand side. You run an affiliate programme — or you're an agency managing several brands' programmes. You want one question that fans out across networks and brands, and surfaces what the dashboards bury: publishers trending down, reversal spikes, dead links, programmes drifting toward zero.

Either way, you do not need to know what an API is or write code. The non-technical Claude Desktop track needs:

• Your existing logins to the affiliate networks you already work with.
• Claude Desktop installed.

The technical track uses a terminal, Node.js 20 or newer, and Claude Desktop, Claude Code, Codex, or another compatible local stdio MCP client; check the support states below before relying on an untested client journey.

And if you work for an affiliate network, this is also for you. The bundled adapters are placeholders until each network adopts its own. See CONTRIBUTING.md under "Adopting your network".

Why bother?

One question, every network and every brand. "Show me earnings by programme" hits your configured publisher networks in parallel. On the brand side, "show me revenue across all my clients this week" fans out across every brand and network pair you've registered.

Plain English, not filters. No more clicking through date pickers and saved views. "Last quarter, status pending, sorted by amount" is the whole prompt.

Your data, your machine. It runs locally. Your keys live in ~/.affiliate-mcp/.env, locked to your user account. There is no hosted account. Optional anonymous usage telemetry is off by default and never contains affiliate data, credentials, prompts, arguments, results, or error text. The networks see the same API calls they'd see from their dashboard.

Catches what dashboards bury. Stale transactions, inactive programmes, dead deeplinks and week-on-week drops are surfaced by the packaged skills.

Optional local result cache. Persistent caching is off by default. Set AFFILIATE_MCP_CACHE=on in ~/.affiliate-mcp/.env to cache selected programme inventory and closed reporting windows locally with owner-only permissions. Open and current windows always go live. On a shared machine where you cannot rely on file permissions, leave caching off. Run affiliate-networks-mcp cache clear to remove cached results; see PRIVACY.md for the storage and retention contract.

Getting started