mcp-redtrack
MCP server for the RedTrack affiliate tracking API. Query campaigns, clicks, conversions, and reports from any MCP-compatible client (Claude Code, Claude Desktop, Cursor, etc.).
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