# Trackdesk — how to use (mcp.ai)

Connect your Trackdesk account and use 9 tools for marketing straight from your AI agent. Connect with your own API key. Trackdesk is an affiliate tracking platform for managing partners, offers, conversions, commissions, billing, and performance reporting.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_trackdesk?ms=1787291280000`
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. `trackdesk_build_tracking_link`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/trackdesk`
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/trackdesk/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/trackdesk/build/tracking/link` — Generate a Trackdesk tracking URL for one affiliate traffic source and offer. This only constructs a URL; it does not record a click, create a conversion, or change offer configuration.
  - body: { target: object, offer_id: string, source_id: string, affiliate_params?: object }
- `POST https://api.mcp.ai/api/trackdesk/get/affiliate` — Return detailed information for one affiliate identified by its Trackdesk account ID.
  - body: { account_id: string }
- `POST https://api.mcp.ai/api/trackdesk/get/daily/performance/report` — Return Trackdesk performance rows, newest first, and aggregate totals for an inclusive date range. Use a bounded range because the response contains one row per day and is not paginated. filled_column
  - body: { columns?: string[], to_date: string, timezone: string, from_date: string, source_ids?: string[], conversion_statuses?: string[], conversion_type_ids?: string[], custom_column_codes?: string[], client_metric_column_codes?: string[] }
- `POST https://api.mcp.ai/api/trackdesk/list/advertisers` — Return one filtered page of advertisers. Trackdesk represents advertisers as revenue origins in this API. Increase offset by limit when has_more is true.
  - body: { limit?: integer, offset?: integer, filters?: object }
- `POST https://api.mcp.ai/api/trackdesk/list/affiliate/tiers` — Return all active affiliate tiers with their IDs, names, exact default payout rates, and default-tier flags.
- `POST https://api.mcp.ai/api/trackdesk/list/affiliates` — Return one filtered page of affiliates, including Trackdesk account and traffic-source identifiers, status, tier, fraud signals, tags, and available billing or payment details. Increase offset by the 
  - body: { limit?: integer, offset?: integer, filters?: object }
- `POST https://api.mcp.ai/api/trackdesk/list/coupons` — Return one filtered page of Trackdesk coupons and their advertiser, affiliate traffic-source, offer, code, and status associations. Increase offset by limit only when pagination.has_more is true.
  - body: { codes?: string[], limit?: integer, offset?: integer, statuses?: string[], offer_ids?: string[], source_ids?: string[], advertiser_ids?: string[] }
- `POST https://api.mcp.ai/api/trackdesk/list/offers` — Return one filtered page of Trackdesk offers with each offer's data, pricing configuration, and landing pages. Increase offset by limit only when pagination.has_more is true.
  - body: { name?: string, limit?: integer, offset?: integer, pinned?: boolean, tag_ids?: string[], statuses?: string[], offer_ids?: string[], category_ids?: string[], visibilities?: string[], country_codes?: string[], conversion_type_ids?: string[] }
- `POST https://api.mcp.ai/api/trackdesk/list/tags` — Return all Trackdesk tags with their IDs, names, colors, and resource scopes.

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

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