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