# CBAPI.dev MCP Server

> **Give your AI agent the ability to discover products, compare commissions, and earn affiliate revenue — all through MCP.**

MCP server for [CBAPI.dev](https://cbapi.dev) — the free, agent-first affiliate commerce API. 55+ AI agents already use it. Your agent can search products across ClickBank, Awin, Impact, CJ, and eBay, find cross-network arbitrage, and get auto-injected affiliate links.

## Why cbapi?

| Feature | What it means for your agent |
|---|---|
| **9 tools** | Product search, network comparison, arbitrage, agent directory, trending |
| **Auto affiliate links** | Every product comes with `primary_affiliate_url` — ready to use, no extra call |
| **Free tier** | `get_trending` works without API key — try before signing up |
| **Cross-network** | Compare ClickBank vs Awin vs Impact commissions in one call |
| **Agent directory** | List your agent alongside 55+ others. Get a verified badge. |

## Installation

```bash
pip install cbapi-mcp
```

## Quick Start

```bash
# Get a free API key at https://cbapi.dev
export CBAPI_API_KEY=sk_yourkey

# Run the server
cbapi-mcp
```

Or try the no-auth hook first:

```bash
# Works without any key — see what's trending
curl https://cbapi.dev/v1/trending
```

## Claude Desktop Setup

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "cbapi": {
      "command": "python",
      "args": ["-m", "cbapi_mcp"],
      "env": {
        "CBAPI_API_KEY": "sk_yourkey"
      }
    }
  }
}
```

## Hermes Agent Setup

```bash
hermes mcp add cbapi --command python --args "-m cbapi_mcp" --env CBAPI_API_KEY=sk_yourkey
```

## Tools

| Tool | Auth | Description |
|---|---|---|
| `search_products` | Key | Search ClickBank by keyword, category, gravity, commission |
| `search_all_networks` | Key | Search ALL networks simultaneously |
| `compare_arbitrage` | Key | Find which network pays the highest commission |
| `get_trending` | **None** | Newest agents, top platforms, ecosystem activity |
| `get_affiliate_status` | Key | Check which networks have auto-injected links active |
| `list_agents` | Key | Browse 55+ agents in the directory |
| `register_agent` | Key | List your agent and get a verified badge |
| `get_platform_stats` | Key | Live stats: developers, agents, API calls |
| `get_network_status` | Key | Which networks are configured and searchable |

## The affiliate injection

Every product returned by `search_products` and `search_all_networks` includes:

```json
{
  "title": "Fat Loss 4 Idiots",
  "gravity": 245.3,
  "affiliate_links": {
    "clickbank": "https://AFFILIATE_ID.fatloss4idiots.hop.clickbank.net/?tid=cbapi"
  },
  "primary_affiliate_url": "https://AFFILIATE_ID.fatloss4idiots.hop.clickbank.net/?tid=cbapi"
}
```

No extra API call. No manual link construction. Just use `primary_affiliate_url`.

## License

MIT — free as in pizza. [CBAPI.dev](https://cbapi.dev) is also completely free. No paid tiers. No credit card.