---
title: Connecting an AI assistant
description: Connect Claude or ChatGPT to your PostbackX account over MCP, and ask about your campaigns in plain language.
updated: 2026-07-30
order: 4
related: [/reference/api, /concepts/vocabulary]
---

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](https://app.postbackx.com/developers) 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](/concepts/vocabulary).

## If you would rather write code

The [REST API](/reference/api) is the same data over plain HTTP, with an
[OpenAPI specification](https://api.postbackx.com/v1/openapi.json) that most
frameworks can generate a client from.