Skip to content
MCP server

Affiliate Router MCP

Route x402 USDC payments and referral links for agent tools through one MCP server

Runs locallyStatus and history
Install
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-mcp

Add 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

  1. Hosted 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
  2. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  5. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  6. MCP

    MCP server

    MCP server for planning, scheduling and measuring social and ad campaigns with approvals

    • Remote
    • Freemium
    • Marketing and SEO