# admitad-mcp

MCP server for the [Admitad](https://www.admitad.com/) 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](https://developers.admitad.com/)

## Setup

1. Clone the repo and install dependencies:

```bash
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:

```bash
cp .env.example .env
```

```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`):

```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