Skip to main content
Glama
admitad-mcp

admitad-mcp

by gruzd1sok

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)

Related MCP server: MCP Affiliate Server

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 .
  1. 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
  1. 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

Available Tools

8 tools
authenticateA

Authenticate with Admitad API using OAuth2 client credentials.

If client_id / client_secret are empty, falls back to ADMITAD_CLIENT_ID / ADMITAD_CLIENT_SECRET environment variables.

Returns username, webmaster_id, token_expires_in seconds.

Inputs: client_id, client_secret.

download_feedA

Download and parse a product feed (YML XML or CSV) from the given URL.

Args: feed_url: Direct URL to the feed file (from get_campaign_feeds). limit: Maximum number of products to return (default 100, max 5000).

Returns list of products with all available fields (name, price, url, picture, etc.).

Inputs: feed_url (required), limit.

get_campaign_feedsA

Get product feed URLs for a specific campaign.

Args: campaign_id: Admitad campaign ID (from list_campaigns).

Returns list of feed objects with id, name, url, format, and item count.

Inputs: campaign_id (required).

get_couponsA

Get available coupons/promo codes from Admitad.

Args: campaign_id: Filter by campaign ID (optional, leave empty for all). limit: Max results.

Returns list of coupons with code, discount, validity dates.

Inputs: campaign_id, limit.

get_meA

Return current authenticated Admitad user info (account details, balance, etc.).

Inputs: no named parameters.

list_campaignsA

List affiliate campaigns (partner programs) available to this publisher.

Args: limit: Max results per page (1–500). offset: Pagination offset. status: Filter by connection status: active | pending | declined | all.

Returns list of campaigns with id, name, site_url, rating, and feed_url if available.

Inputs: limit, offset, status.

list_categoriesB

List product categories for a campaign (from campaign detail).

Args: campaign_id: Admitad campaign ID.

Returns categories embedded in the campaign object.

Inputs: campaign_id (required).

search_productsA

Download a product feed and search for products matching a query string.

Args: feed_url: Direct URL to the feed file. query: Search string (case-insensitive substring match). field: Field to search in: name | vendor | categoryid | description | any. limit: Max products to return (default 20).

Returns matching products.

Inputs: feed_url (required), query (required), field, limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a clear and distinct purpose: authentication, campaign listing, feed retrieval, coupon listing, user info, categories, feed downloading, and product search. There is no overlap or ambiguity.

    Naming Consistency4/5

    All names use lowercase with underscores, but there is a mix of verb prefixes (get_, list_, download_, search_, authenticate_). While consistent in style, the variety in verbs is acceptable but not perfectly uniform.

    Tool Count5/5

    Eight tools cover the core operations of an affiliate marketing API: authentication, campaign discovery, feed access, coupon retrieval, and user info. The count feels well-scoped without being too few or too many.

    Completeness4/5

    The tool set covers essential read operations (list, get, search, download) and authentication. Missing write operations (e.g., create/update campaigns or coupons) may be intentional for a publisher-facing API, but a tool to get a single campaign by ID would improve completeness.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI agents to access affiliate marketing capabilities through AgentFuse's API, allowing them to browse affiliate programs, generate tracked links, and record conversions without writing HTTP code.
      7
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to search products and generate affiliate links across European and global affiliate networks, automating product discovery and link creation for monetization.
      5
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to search products across affiliate networks, compare commissions, find arbitrage opportunities, and get auto-injected affiliate links via MCP.
      -