Quick start

npx mcp-redtrack setup YOUR_API_KEY

This prints the config snippet for your MCP client.

Claude Code

claude mcp add redtrack -e REDTRACK_API_KEY=YOUR_API_KEY -- npx mcp-redtrack

Claude Desktop / Cursor

Add to your MCP settings JSON:

{
  "mcpServers": {
    "redtrack": {
      "command": "npx",
      "args": ["mcp-redtrack"],
      "env": {
        "REDTRACK_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Tools (14)

Campaigns

| Tool | Description | |------|-------------| | get_campaigns | List campaigns with filtering by title, status, source, tags, date range | | get_campaign | Get single campaign by ID with full config | | get_campaigns_v2 | List campaigns via v2 endpoint |

Logs

| Tool | Description | |------|-------------| | get_clicks | Click-level log with IP, country, device, campaign details (max 10k/page) | | get_conversions | Conversion log with payout, cost, revenue, attribution (max 10k/page) |

Reports

| Tool | Description | |------|-------------| | get_report | Aggregated stats grouped by dimension (campaign, offer, country, date, sub1-20, etc.) |

Entities

| Tool | Description | |------|-------------| | get_offers | List offers with filtering | | get_offer | Single offer by ID | | get_sources | List traffic sources | | get_source | Single source by ID | | get_networks | List affiliate networks | | get_landings | List landing pages | | get_settings | Account settings (timezone, currency, conversion types) |

Environment variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | REDTRACK_API_KEY | Yes | — | Your RedTrack API key | | REDTRACK_ENV_FILE | No | .env | Path to .env file |

Development

bun install          # install deps
bun run dev          # run MCP server
bun test             # run tests
bun run lint         # check formatting & lint
bun run inspect      # open MCP inspector
bun run build        # compile standalone binary
bun run build:npm    # bundle for Node.js / npm

License

MIT