agentfuse-mcp

MCP server for AgentFuse -- the affiliate API middleware for AI agents.

Lets any MCP-compatible AI agent (Claude Code, Cowork, custom agents) browse affiliate programs, generate tracked links, and record conversions without writing HTTP code.

Tools

| Tool | Description | |---|---| | list_affiliate_programs | Browse all programs in the catalog (filterable by category) | | get_affiliate_program | Get full details for one program by slug | | generate_tracked_link | Create an attribution-tagged short link for a user | | get_stats | Dashboard summary: clicks, signups, commissions | | record_signup | Log a conversion event when a user signs up | | list_tracked_links | List all tracked links generated for your users | | record_commission | Log a commission event (purchase or renewal) |

Requirements

• Node.js >= 18
• An AgentFuse API key -- get one at agentfuse.io

Usage

Option 1 -- Claude Code (recommended)

Add to your project's .claude/mcp.json (or your global ~/.claude/mcp.json):

{
  "mcpServers": {
    "agentfuse": {
      "command": "npx",
      "args": ["-y", "agentfuse-mcp"],
      "env": {
        "AGENTFUSE_API_KEY": "af_live_your_key_here"
      }
    }
  }
}

Or, if you've cloned this repo locally:

{
  "mcpServers": {
    "agentfuse": {
      "command": "node",
      "args": ["/path/to/agentfuse-mcp/src/index.js"],
      "env": {
        "AGENTFUSE_API_KEY": "af_live_your_key_here"
      }
    }
  }
}

Option 2 -- Run directly

npm install
AGENTFUSE_API_KEY=af_live_... node src/index.js

Option 3 -- Test the tool list (no API key needed)

node src/index.js --test

Example agent interactions

Browse programs:

"List all affiliate programs in the AI tools category" -> calls list_affiliate_programs({ category: "ai-voice" })

Generate a link:

"Create a tracked Webflow affiliate link for user [email protected]" -> calls generate_tracked_link({ program_slug: "webflow", end_user_id: "[email protected]" })

Check stats:

"How many clicks and signups have we had this month?" -> calls get_stats()

Environment variables

| Variable | Required | Default | Description | |---|---|---|---| | AGENTFUSE_API_KEY | Yes | -- | Your AgentFuse API key (af_live_...) | | AGENTFUSE_API_URL | No | https://api.agentfuse.io | Override the API base URL |

License

MIT (c) AgentFuse / GSK AIOrch LLC