Affiliate Router MCP
Route x402 USDC payments and referral links for agent tools through one MCP server
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.1.14
- Listing updated
- 2 days ago
About Affiliate Router MCP
Affiliate Router MCP is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
Experimental at v0.1.x, this server gives an agent a catalogue of vendors and products with ways to pay for or promote each. Discovery tools search by category or keyword, a routing tool recommends a path for an intent, and a link tool builds tracked referral URLs. Only one tool spends money, call_affiliate_product, which settles in USDC on Base through an x402 adapter. A separate commission estimator projects monthly earnings at a given call volume.
The spending guardrails are specific. It pays only allowlisted CoinOpAI origins, only on Base mainnet in USDC, with per-call caps of $0.15 and $0.10 and a $10 session budget; environment variables can lower those caps but not raise them. The README tells you to use a dedicated low-balance wallet.
Built-in vendors include CoinOpAI, Gumroad, PartnerStack, Ledger, DigitalOcean via Awin, an Amazon storefront and vehicle history reports. The author states it does not guarantee payouts. The free list_tools response may carry one labelled sponsored card.
Install
Run in a terminal
claude mcp add affiliate-router-mcp --env WALLET_PRIVATE_KEY='<WALLET_PRIVATE_KEY>' -- npx -y affiliate-router-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"affiliate-router-mcp": {
"command": "npx",
"args": [
"-y",
"affiliate-router-mcp"
],
"env": {
"WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"affiliate-router-mcp": {
"command": "npx",
"args": [
"-y",
"affiliate-router-mcp"
],
"env": {
"WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"affiliate-router-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"affiliate-router-mcp"
],
"env": {
"WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"affiliate-router-mcp": {
"command": "npx",
"args": [
"-y",
"affiliate-router-mcp"
],
"env": {
"WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"affiliate-router-mcp": {
"command": "npx",
"args": [
"-y",
"affiliate-router-mcp"
],
"env": {
"WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
}
}
}
}Configuration
WALLET_PRIVATE_KEYDedicated low-balance Base wallet private key for x402 USDC micropayments. Do not use your primary wallet.Required
Tools this server provides (9)
Taken from the project documentation; the running server may differ.
- list_tools
- Lists every x402 Router tool with its live price, fetched from the router menu.
- search_opportunities
- Find products by category or keyword.
- list_affiliate_programs
- List all vendors and their programs.
- get_opportunity_details
- Full details on a specific vendor or product.
- get_best_route
- Recommend the best route for an intent.
- generate_affiliate_link
- Build a tracked referral URL.
- call_affiliate_product
- Pay and call a product with attribution.
- estimate_commission
- Project monthly earnings at a call volume.
- get_affiliate_telemetry
- View the local attribution log.
What it does
- Vendor discovery
- Search products and programs by category or keyword.
- Best-route suggestion
- Recommends the payment or attribution path for an intent.
- Tracked link builder
- Injects affiliate parameters into referral URLs.
- Capped x402 payments
- Hard per-call and session spending limits.
- Commission estimates
- Projects earnings at a chosen call volume.
- Local telemetry log
- Appends each paid call to a JSONL file.
- Editable registry
- Referral vendors are added by editing registry.json.
Good for
- Let an agent find a paid API and pay per call
- Generate tracked referral links for recommended products
- Estimate affiliate revenue before adding a vendor
- Audit attributed calls from a local log
Pricing
Open source
Server is free; paid vendor calls cost $0.05 to $0.15 each
Affiliate Router MCP FAQ
Do the free tools need a wallet?
No. Only call_affiliate_product with x402 vendors needs WALLET_PRIVATE_KEY.
Can it spend more than the caps?
No. Environment variables can only lower the built-in caps.
Does it guarantee commissions?
No. Payouts are enforced by each vendor's system.
Is it production-ready?
The README labels it experimental.
Is Affiliate Router MCP free?
Yes. Affiliate Router MCP is open source, so you can use and self-host it for free.
How do I add Affiliate Router MCP to Claude Code?
Run this command in your terminal: claude mcp add affiliate-router-mcp --env WALLET_PRIVATE_KEY='<WALLET_PRIVATE_KEY>' -- npx -y affiliate-router-mcp
What are the best alternatives to Affiliate Router MCP?
The closest alternatives to Affiliate Router MCP are Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Calven and Budget Tracker.
Alternatives to Affiliate Router MCP

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat
- 8 tools
- Remote
- Freemium
- 8.1K GitHub stars
- Marketing and SEO

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments

Calven
MCP serverProduct marketing context from Calven delivered into Claude, ChatGPT and other AI tools
Not checked yet- Remote
- Free trial
- 3 GitHub stars
- Marketing and SEO
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

MCP
MCP serverMCP server for planning, scheduling and measuring social and ad campaigns with approvals
- Remote
- Freemium
- Marketing and SEO