# Adtraction — how to use (mcp.ai)

Connect your Adtraction account and use 22 tools for marketing straight from your AI agent. Connect with your own API key. Adtraction is an affiliate marketing platform for managing partner programs, tracking links, transactions, commissions, statistics, and payments.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_adtraction?ms=1787295900000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `adtraction_create_tracking_link`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/adtraction`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/adtraction/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/adtraction/create/tracking/link` — Generate an externally usable Adtraction affiliate tracking URL for an approved channel and advertiser program. The returned link attributes traffic and conversions using the supplied EPI values; gene
  - body: { epi?: string, url?: string, epi2?: string, epi3?: string, epi4?: string, epi5?: string, channel_id: integer, program_id: integer, short_link?: boolean }
- `POST https://api.mcp.ai/api/adtraction/download/payment/pdf` — Download a partner payment specification as a PDF file.
  - body: { payment_id: integer }
- `POST https://api.mcp.ai/api/adtraction/get/balance` — Retrieve pending, confirmed, invoiced, payable, and total Adtraction partner balances in one currency.
  - body: { currency: string }
- `POST https://api.mcp.ai/api/adtraction/get/commission/summary` — Summarize Adtraction partner commission by commission type, payment status, or transaction status.
  - body: { market?: string, to_date: string, currency: string, breakdown: string, from_date: string, channel_id?: integer, program_id?: integer, transaction_status?: integer }
- `POST https://api.mcp.ai/api/adtraction/get/statistics` — Retrieve aggregate Adtraction partner performance overall or grouped by channel, day, selected EPI dimensions, or program.
  - body: { market: string, to_date: string, currency: string, group_by?: string, from_date: string, channel_id?: integer, program_id?: integer, epi_dimensions?: integer[], transaction_status: integer }
- `POST https://api.mcp.ai/api/adtraction/list/applications` — List the connected partner's program applications, optionally filtered by program or channel.
  - body: { channel_id?: integer, program_id?: integer }
- `POST https://api.mcp.ai/api/adtraction/list/channels` — List approved partner channels or retrieve a specific channel by ID.
  - body: { channel_id?: integer }
- `POST https://api.mcp.ai/api/adtraction/list/clicks` — List Adtraction click events in a date range with attribution, program, channel, market, and currency filters.
  - body: { epi?: string, epi2?: string, epi3?: string, epi4?: string, epi5?: string, gclid?: string, gbraid?: string, market?: string, wbraid?: string, to_date: string, currency: string, from_date: string, channel_id?: integer, program_id?: integer, commission_only?: boolean }
- `POST https://api.mcp.ai/api/adtraction/list/commission/types` — List commission types for an Adtraction program, optionally using a channel for segment-specific rates.
  - body: { channel_id?: integer, program_id: integer }
- `POST https://api.mcp.ai/api/adtraction/list/currencies` — List currencies available to the connected Adtraction partner account.
- `POST https://api.mcp.ai/api/adtraction/list/latest/transactions` — Return a requested number of the connected partner's latest Adtraction transactions.
  - body: { number?: integer }
- `POST https://api.mcp.ai/api/adtraction/list/markets` — List Adtraction markets and their numeric IDs and ISO country codes for use in program discovery, category, and reporting tools.
- `POST https://api.mcp.ai/api/adtraction/list/new/programs` — List recently added partner programs in an Adtraction market.
  - body: { market_id: integer }
- `POST https://api.mcp.ai/api/adtraction/list/offers` — List coupons, vouchers, and offers available to the connected Adtraction partner, optionally filtered by market, program, or channel.
  - body: { market?: string, channel_id?: integer, program_id?: integer }
- `POST https://api.mcp.ai/api/adtraction/list/payment/transactions` — List the transactions included in a specific partner payment.
  - body: { payment_id: integer }
- `POST https://api.mcp.ai/api/adtraction/list/payments` — List partner payments, optionally filtered by currency and payment ID.
  - body: { currency?: string, payment_id?: integer }
- `POST https://api.mcp.ai/api/adtraction/list/product/feeds` — List product feeds available for an advertiser program and approved partner channel.
  - body: { channel_id: integer, program_id: integer }
- `POST https://api.mcp.ai/api/adtraction/list/program/categories` — List program categories and program counts for an Adtraction market.
  - body: { market_id: integer }
- `POST https://api.mcp.ai/api/adtraction/list/tracking/errors` — List tracking errors recorded in the connected Adtraction partner account during the last seven days, optionally filtered by channel or program.
  - body: { channel_id?: integer, program_id?: integer }
- `POST https://api.mcp.ai/api/adtraction/list/transactions` — List Adtraction partner transactions in a date range with status, attribution, payment, market, currency, program, and channel filters.
  - body: { epi?: string, market?: string, to_date: string, currency?: string, from_date: string, unique_id?: string, channel_id?: integer, program_id?: integer, last_updated?: string, payment_status?: integer, transaction_status: integer }
- `POST https://api.mcp.ai/api/adtraction/search/products` — Search the Adtraction partner product database using text, program, market, currency, stock, price, and sort filters. Returns one page at a time.
  - body: { sort?: string, market?: string, keyword: string, currency?: string, in_stock?: boolean, max_price?: number, min_price?: number, page_size?: integer, next_cursor?: string, program_ids?: integer[] }
- `POST https://api.mcp.ai/api/adtraction/search/programs` — Find Adtraction partner programs in a market, optionally filtered by program, channel, approval status, and lifecycle status.
  - body: { market: string, status?: integer, channel_id?: integer, program_id?: integer, approval_status?: integer }

## Example prompts
- "What can I do in Adtraction?"
- "Show me a summary of my Adtraction account"

## More
- Page: https://mcp.ai/adtraction
- Agent spec (llms.txt): https://mcp.ai/adtraction/llms.txt
- Postman collection: https://mcp.ai/adtraction/postman.json