admitad-mcp

MCP server for the Admitad affiliate network. Lets Claude and other MCP-compatible AI assistants browse partner programs, discover product feeds, and search products — without leaving the chat.

Tools

| Tool | Description | |------|-------------| | authenticate | Get an OAuth2 token using your client credentials | | get_me | Return current account info (name, ID, balance) | | list_campaigns | List available affiliate programs (filter by status) | | get_campaign_feeds | Get product feed URLs for a specific campaign | | download_feed | Download and parse a YML/CSV product feed | | search_products | Search products in a feed by name, vendor, or any field | | list_categories | List product categories in a campaign | | get_coupons | Get available promo codes (all campaigns or filtered) |

Requirements

• Python 3.10+
• Admitad publisher account with API access
• client_id and client_secret from Admitad Developers

Setup

1. Clone the repo and install dependencies:

cd admitad-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e .

2. Copy .env.example to .env and fill in your credentials:

cp .env.example .env

ADMITAD_CLIENT_ID=your_client_id_here
ADMITAD_CLIENT_SECRET=your_client_secret_here

3. Register the server in your Claude Code config (~/.claude.json):

"admitad": {
  "type": "stdio",
  "command": "/path/to/admitad-mcp/.venv/bin/python",
  "args": ["/path/to/admitad-mcp/server.py"],
  "env": {
    "ADMITAD_CLIENT_ID": "your_client_id_here",
    "ADMITAD_CLIENT_SECRET": "your_client_secret_here"
  }
}

Usage examples

authenticate → then ask Claude:
  "Show me all active campaigns in the fashion category"
  "Find Nike sneakers across all feeds"
  "Get promo codes for campaign 12345"

Required OAuth scopes

The server requests the following scopes automatically:

advcampaigns advcampaigns_for_website websites public_data private_data

Make sure all five are enabled for your application in the Admitad developer portal.

License

MIT