Connecting an AI assistant

Connect Claude or ChatGPT to your PostbackX account over MCP, and ask about your campaigns in plain language.

Updated 2026-07-30 Use with AI Markdown source

PostbackX runs an MCP server, which lets an AI assistant read your reporting data directly. Connect it once and you can ask which campaigns lost money last week instead of building the report yourself.

Access is read-only and scoped to one organization, the same as an API key.

The endpoint#

https://mcp.postbackx.com/mcp

Claude Code#

bash

claude mcp add --transport http postbackx https://mcp.postbackx.com/mcp

Then run /mcp inside Claude and choose Authenticate to sign in. You can also pass a key directly with --header "Authorization: Bearer pbx_live_...", but signing in avoids putting a credential in your shell history.

Claude Desktop, claude.ai and ChatGPT#

Add it as a custom connector, using the same URL:

Claude Desktop or claude.ai — Settings, then Connectors, then Add custom

connector.

ChatGPT — Settings, Security and login, enable Developer mode, then add the

same URL.

Full setup with animated walkthroughs is on API & MCP in the app, which also mints the API keys.

What it can do#

Reporting: totals, time series, and breakdowns by campaign, offer, ad and inbound call. Listing: campaigns, offers, offer sources, tracking domains, organizations, and raw click and conversion rows.

It can also draft a campaign link for you — which produces a pre-filled URL into the app for you to review, not a created campaign.

Status changes to campaigns and offers exist as tools but are disabled by default, so a connected assistant cannot pause anything unless writes are explicitly turned on for your deployment.

Asking useful questions#

Always say what period you mean. There is no default window; an assistant will either ask or guess, and guessing is worse.

Ask for the comparison you want, not the rows. "Which offers beat 1.2 ROAS last week, and what did each spend?" gets you an answer. "Show me my conversions" gets you a wall of rows.

Metrics are already computed. ROAS, EPC and CPA come back calculated — an assistant that recomputes them from raw fields can drift from what the dashboard shows.

Watch the vocabulary. An offer source is where offers come from; a platform is where ad spend goes. Assistants trained on the wider industry tend to say "network" for the first. See vocabulary.

If you would rather write code#

The REST API is the same data over plain HTTP, with an OpenAPI specification that most frameworks can generate a client from.