How the Whathead MCP server is built
Whathead runs one hosted MCP server for every platform you connect in your workspace, so a single connector in Claude or ChatGPT reaches all of them.
It lists 25 tools: one gateway per platform, a workspace gateway, a core gateway for cross-platform work, and whathead_tool_help, which returns the exact input schema for any operation. Behind them sit more than 3,500 native API actions in 13 catalogs, without flooding the assistant's context with thousands of tool definitions.
The core gateway adds plan_campaign_structure, create_campaign (always paused), audit_campaign, export_report and cross_platform_transfer, plus 22 prompts such as campaign-audit, weekly-report and fix-delivery.
What the MCP can do on each platform
| Platform | Coverage in Whathead | Writes through MCP | Official MCP (Nov 2026) |
|---|---|---|---|
| Meta | 528 actions | Campaigns, ad sets, ads, creatives, audiences, catalogs | Hosted, read and write |
| Google Ads | Transfer target, cross-platform review | Paused campaigns created by transfer | Self-hosted, writes only assets and labels |
| TikTok | 496 actions | Campaigns, ad groups, ads, Smart+, Spark Ads, audiences | Hosted, read and write |
| Snapchat | 268 actions | Campaigns, ad squads, ads, creatives, lead forms | Hosted, read-only |
| 287 actions | Campaigns, creatives, lead forms, matched audiences | None announced | |
| Microsoft Advertising | 280 operations | Campaigns, ad groups, ads, keywords, budgets | Read-only pilot |
| Amazon Ads | 188 actions | Sponsored Products, Brands and Display | Open beta, read and write |
| Apple Ads | 172 actions | Campaigns, ad groups, ads, keywords, budget orders | None found |
| X Ads | 186 actions | Campaigns, line items, promoted posts, audiences | Hosted, read and write |
| Reddit Ads | 49 actions | Campaigns, ad groups, ads, posts, lead forms | None found |
| DV360 | 173 methods | Insertion orders, line items, creatives, targeting | None found |
| Criteo Retail Media | 108 actions | Campaigns, line items, keyword bids | Partner access, read-only |
| GA4 | 11 operations | Key events, custom dimensions, data streams | Self-hosted, 3 opt-in writes |
| Search Console | 16 actions | Sites and sitemaps only | None found |
| Shopify | Not on the MCP server | None | Shopify connector for Claude |
When an official MCP is enough, and when it is not
If you run one platform and it ships a write-capable MCP (Meta, TikTok, Amazon and X do), its own server is the simplest start. Snap's and Microsoft's are read-only, Google's Ads MCP only writes assets and labels, and we found none for LinkedIn, Reddit, Apple Ads, DV360 or Search Console.
Whathead is for teams buying across several platforms. One connection covers all of them, writes behave the same everywhere, and some jobs only exist here: copying campaigns between Meta, TikTok, Snapchat and Google, per-connector account allowlists, and in the Whathead app a visual builder, bulk editing, media-plan import and the Anomaly Engine (early access).
Set up the MCP server
Connect your ad accounts in Whathead
Open Integrations, sign in to each platform and pick the accounts the assistant may use.
Claude
Settings, Connectors, add a custom connector, paste https://www.whathead.com/mcp, then sign in to Whathead and approve.
ChatGPT
With developer mode enabled, create a connector with the same URL, approve the OAuth prompt and switch it on per chat.
Cursor and n8n
Mint a bearer token on the Whathead connector page and add it with the endpoint to the client's MCP settings.
Check it works
Ask "list my connected ad accounts". Only the accounts you selected should come back.
Safety model
Guardrails that do not depend on the model behaving well:
- Dry run by default: a write returns a preview of the exact platform request until it is resent with dry_run false.
- Deletes, publishes and other destructive calls also need confirmed: true.
- create_campaign always creates paused campaigns, and transfers create paused copies by default.
- Idempotency keys stop a retried call from creating duplicates.
- Tool annotations flag read-only and destructive tools, so Claude and ChatGPT can ask before risky calls.
- OAuth 2.1 with PKCE, 9 scopes, per-connector account and tool allowlists, a 120 calls per minute session limit and a call log.
Plans that include MCP access
| Plan | Price | MCP reads / month | MCP writes / month | Seats | Ad accounts |
|---|---|---|---|---|---|
| MCP Actions | $39/month | 1,500 | 100 | 1 | 3 |
| Operator Bundle | $65/month | 4,000 | 250 | 3 | 5 |
| Agency | $249/month | 15,000 | 750 | 8 | 15 |
Prompts to try
List every ad account I have connected and the platform each one is on.
Compare yesterday's spend, clicks and conversions across Meta, TikTok, Snapchat and Google Ads in one table.
Run the campaign-audit prompt on our biggest Meta campaign and list the fixes in priority order.
Draft a paused TikTok copy of Meta campaign 120211 and show me what will not map.
Pull last month's Amazon Sponsored Products spend and sales by campaign.
Pause every Snapchat ad squad with zero conversions this week. Show me the preview first.
Compare GA4 key events with Meta-reported purchases for the last 14 days.
Which Search Console queries had more than 1,000 impressions last week at positions 8 to 15?
Frequently asked questions
What is an ads MCP server?
A server that speaks the Model Context Protocol, so an AI assistant can call ad platform APIs as tools. Whathead's is hosted: you add one URL instead of running a server per platform.
Which AI assistants work with it?
Claude (web and desktop), ChatGPT, Cursor, Google Antigravity and n8n have setup guides. Any client that supports remote MCP over Streamable HTTP with OAuth or a bearer token should work.
Can the assistant spend money without my approval?
Not by default. Writes return a preview first, campaigns are created paused, and activating or deleting needs an explicit confirmation. A connector can also be limited to read-only tools or chosen accounts.
How is MCP usage counted?
Platform calls count as reads or writes against your monthly allowance. On Operator and Agency you can buy 1,000 extra reads for $5 or 100 extra actions for $8. MCP Actions shows an upgrade prompt at the limit instead.
Do I need my own developer app or API keys for each platform?
Not for Meta, TikTok, Snapchat, LinkedIn, Microsoft, Amazon, X, Reddit, DV360 or Criteo: you sign in through Whathead. Apple Ads uses your Apple Ads API client credentials.
What does it not do yet?
Shopify is not on the MCP server. Transfers cover Meta, TikTok, Snapchat and Google only. The Anomaly Engine lives in the app and is in early access, and some Google helper tools are in a staged rollout.
Run it from one workspace
Every plan starts with a 14-day free trial. Only successful live work is metered.
Sources
- Meta for Developers: Ads MCP server (16 Jul 2026) (developers.facebook.com)
- TikTok for Business MCP server (help center) (ads.tiktok.com)
- Snapchat Ads MCP introduction (developers.snap.com)
- googleads/google-ads-mcp on GitHub (github.com)
- Microsoft Advertising MCP setup guide (learn.microsoft.com)
- Amazon Ads MCP server open beta (advertising.amazon.com)
- X Ads API MCP docs (docs.x.com)
- Criteo MCP Retail Media tool reference (developers.criteo.com)
- googleanalytics/google-analytics-mcp on GitHub (github.com)
- Shopify connector for Claude (help.shopify.com)