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 alice@example.com" -> calls
generate_tracked_link({ program_slug: "webflow", user_id: "alice@example.com" })
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