AI Assistants (MCP)

AdStage provides an MCP (Model Context Protocol) server. Add it as a connector in claude.ai, Claude Code or ChatGPT and your AI assistant can read attribution reports, saved reports, deep links, funnels, retention and the event catalog without opening the dashboard.

Before you start

You need an AdStage account that is a member of the organization you want to query.

Server URL: https://api.adstage.app/mcp (you can copy it from Settings > AI Assistants in the dashboard)

1. Security model

Item	Description
Permissions	Read-only. Nothing can be created, changed or deleted.
Organization	You pick one organization when you connect. Only that organization's data is accessible; other organizations are never visible.
Authentication	OAuth 2.1 with PKCE. You sign in with your own AdStage account and approve the connection — no API keys are copied anywhere.
Disconnecting	Disconnect at any time under Settings > AI Assistants. Access also stops immediately when you are removed from the organization.
Data	Query results are sent to the Anthropic/OpenAI conversation. Make sure this is acceptable under your company policy.

2. Connect from claude.ai

Go to Customize > Connectors.
Click Add custom connector, enter the server URL https://api.adstage.app/mcp and click Add.
Click Connect on the connector. The AdStage sign-in page opens: sign in, choose the organization to share and click Approve.
In a chat, enable AdStage under + > Connectors and ask, e.g. "Compare last week's ad spend and ROAS by channel" or "Show daily installs this month".

On Team/Enterprise plans an Owner adds the connector once under Organization settings > Connectors; each member then clicks Connect and approves with their own account.

3. Connect from Claude Code

claude mcp add --transport http adstage https://api.adstage.app/mcp

Run /mcp in a session to sign in; a browser window opens. Choose the organization, approve, and the tools become available.

4. Connect from ChatGPT

Under Settings > Connectors > Advanced, enable Developer mode.
Click Create, enter the server URL and choose OAuth as the authentication method.
Click connect: the AdStage sign-in, organization selection and approval screens open.

5. Available tools

Tool	Purpose
`query_attribution_report`	Spend, impressions, clicks, installs, conversions, revenue and ROAS grouped by date / channel / campaign / platform …
`list_report_fields`	Available metrics, dimensions and filters
`run_saved_report` / `list_saved_reports`	Run reports saved in the dashboard
`get_event_name_histogram` / `list_event_catalog`	Event names and counts being collected
`list_deeplinks`	Deep links and tracking links
`list_funnels` / `get_funnel_report`	Funnel definitions and step conversion
`query_retention_report`	Cohort retention
`list_ad_platform_integrations`	Connected ad platforms
`get_connection_info`	Connected organization, currency, timezone and today's date

How to read the numbers: money is in the organization base currency; roas_*, ctr and cvr_* are percentages (x100); conversion_value_total includes organic revenue while roas_total uses paid-attributed revenue. Date presets end yesterday by default because today's data is still being collected.

6. Switching organizations · disconnecting

Disconnect your connection under Settings > AI Assistants, then click Connect again in your AI client and choose another organization. Organization OWNERs/ADMINs can see and disconnect every member's connection on the Organization connections tab.

7. Troubleshooting

Symptom	What to do
"Couldn't reach the MCP server"	Check that the server URL is exactly `https://api.adstage.app/mcp`
The sign-in page keeps saying "Sign in required"	Sign in to the dashboard again, then retry from your AI client. GAMEPOT dashboard accounts: open the AD+ tab once, then retry
"This request was started in a different browser"	Approve in the same browser that started the connection from your AI client. Start the connection again
No eligible organization	Ask to be invited as a member of the organization (Organization settings > Users)