Whathead MCP
Integrates with Amazon Ads, including Sponsored Products, Sponsored Brands, and Sponsored Display, for reporting and campaign management through native Amazon Ads actions.
Integrates with Apple Ads for reporting and creating, updating, or pausing campaigns through native Apple Ads actions.
Part of the Meta integration, covering Facebook ad accounts, lead forms, and page posts for reporting and campaign edits.
Integrates with the Google Ads API v23 for reporting and campaign management, with write actions flagged for confirmation.
Provides GA4 reporting, asynchronous report tasks, metadata access, and audience export tools.
Provides Search Console tools for sites, sitemaps, URL inspection, search analytics, and submitting or deleting sitemaps.
Available through MCP for Google Tag Manager and tracking-related operations in the workspace.
Part of the Meta integration, covering Instagram ad accounts for reporting and campaign edits through Meta native actions.
Integrates with Meta ad accounts across Facebook and Instagram for reporting, campaign creation and editing, lead forms, and page posts.
Integrates with Reddit Ads for reporting and campaign management, including posts, lead generation, and catalogs.
Connects Shopify stores so the workspace can access products, orders, inventory, and sales data; Shopify writes are not yet exposed as MCP tools.
Integrates with Snapchat Ads for reporting and campaign management, including lead forms and lead webhooks.
Integrates with TikTok Ads for reporting and creating, updating, or pausing campaigns and related entities.
Provides MCP access to WooCommerce as an ecommerce and store integration alongside other marketing and commerce platforms.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
Whathead MCP
One remote MCP server for the ad platforms your media plan actually buys.
https://www.whathead.com/mcp
Connect · Platforms · Safety · Example prompts · Pricing · Docs
What it is
Whathead is an ad-operations workspace and remote MCP server for performance marketers and agencies. It connects Meta, Google Ads, TikTok, Snapchat, LinkedIn, Reddit, X, Microsoft Ads, DV360, Criteo, Apple Ads and Amazon Ads, plus GA4, Search Console and Shopify, so teams can build, edit, transfer, report on and monitor campaigns from one workspace or from Claude, ChatGPT and other MCP clients.
The MCP server is hosted by Whathead. You do not install or run anything: point your MCP client at the URL above, sign in with your Whathead account, and your assistant can work with the ad accounts your workspace has connected.
What this repository contains: the MCP Registry manifest (server.json), the Glama manifest (glama.json), client configuration examples, example prompts and documentation. It does not contain the server's source code. See License.
Related MCP server: Ads MCP
Connect
You need a Whathead account on a plan that includes MCP connectors (see Pricing) and at least one ad platform connected in your workspace.
Claude (claude.ai and Claude Desktop)
Open Settings → Connectors → Add custom connector.
Name it
Whatheadand pastehttps://www.whathead.com/mcp.Click Connect, sign in to Whathead and approve access.
In a chat, enable Whathead from the tools menu and ask a question about your accounts.
Claude Code
claude mcp add --transport http whathead https://www.whathead.com/mcpThen run /mcp inside Claude Code, choose whathead and complete the browser sign-in.
ChatGPT
In Settings → Apps & Connectors, open Advanced settings and turn on Developer mode (required for custom MCP connectors on most plans).
Create a connector with the URL
https://www.whathead.com/mcpand OAuth authentication.Sign in to Whathead and approve access.
Turn the connector on in each chat where you want to use it. The toggle is per chat; if Whathead shows as unavailable, it is usually not enabled in that conversation.
Read-only connection. For workspaces that only allow read-only tools, or accounts that should never change anything, use https://www.whathead.com/mcp/read instead. It uses the same sign-in, and every tool it lists is read-only (readOnlyHint: true): reporting, account and campaign reads for each platform. Any attempt to change data is refused before it reaches the ad platform.
Cursor
Create a bearer token for Cursor on the Whathead MCP connector page, then add this to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):
{
"mcpServers": {
"whathead": {
"url": "https://www.whathead.com/mcp",
"headers": { "Authorization": "Bearer ${env:WHATHEAD_MCP_TOKEN}" }
}
}
}Keep the token in an environment variable, not in a committed file. You can restrict a token to specific ad accounts and tools when you create it.
VS Code (GitHub Copilot agent mode)
Add to .vscode/mcp.json, or run MCP: Add Server from the Command Palette and choose HTTP:
{
"servers": {
"whathead": {
"type": "http",
"url": "https://www.whathead.com/mcp"
}
}
}VS Code opens the Whathead sign-in the first time a tool is used.
Other clients (n8n, Manus, Antigravity, MCP Inspector)
Any client that speaks Streamable HTTP can connect to https://www.whathead.com/mcp. Clients that support MCP OAuth discover the authorization server automatically from https://www.whathead.com/.well-known/oauth-protected-resource. Automation tools without an OAuth flow use a bearer token from the connector page. More configs are in examples/.
Full setup guide: docs.whathead.com/ai-assistant/connect
Platforms and capabilities
Verified against the Whathead codebase on 18 Nov 2026. "Native API actions" counts the platform API operations available through each gateway; your assistant discovers the exact inputs with whathead_tool_help.
Platform | Read and report | Build and edit (create, update, pause) | Native API actions | MCP gateway |
Meta (Facebook, Instagram) | Yes | Yes, incl. lead forms and page posts | 528 |
|
Google Ads | Yes | Yes (Google Ads API v23; actions flagged for confirmation) | 171 |
|
TikTok | Yes | Yes | 496 |
|
Snapchat | Yes | Yes, incl. lead forms and lead webhooks | 268 |
|
Yes | Yes, incl. campaign groups and lead gen | 287 |
| |
Yes | Yes, incl. posts, lead gen and catalogs | 49 |
| |
X | Yes | Yes | 186 |
|
Microsoft Advertising | Yes | Yes (REST v13 campaign management, bulk, reporting) | 280 |
|
Display & Video 360 | Yes, incl. Bid Manager reporting | Yes | 173 |
|
Criteo Retail Media | Yes | Yes | 108 |
|
Apple Ads | Yes | Yes | 172 |
|
Amazon Ads (SP, SB, SD) | Yes | Yes | 188 |
|
Google Analytics 4 | Reports, async report tasks, metadata | Audience exports | 12 tools |
|
Google Search Console | Sites, sitemaps, URL inspection, search analytics | Submit and delete sitemaps | 16 |
|
Shopify | Connect a store in the workspace (products, orders, inventory, sales) | Not yet exposed as MCP tools | n/a | n/a |
Also available through MCP: Google Tag Manager, Google Business Profile, Google Merchant Center, Klaviyo, Adjust, AppsFlyer, Microsoft Clarity and WooCommerce.
Cross-platform workflows
Campaign transfer.
cross_platform_transfercopies a full campaign tree (campaign, ad sets, ads, media) between Meta, TikTok and Snapchat, and from those into Google. It maps objectives, placements and creatives, and creates the copy paused by default. The transfer screen in the workspace also maps X, Reddit, LinkedIn and OpenAI Ads.One workspace, many accounts. Agencies assign ad accounts to client workspaces and scope each token to the accounts it may touch.
Monitoring (workspace). The Anomaly Engine compares what is live with what was approved (objective, targeting, tracking, naming, budget) and flags pacing and performance anomalies for Meta, Snapchat, TikTok, X and DV360.
What it does not do: it does not run campaigns on its own. Your assistant proposes; you approve.
Safety model
Letting an AI touch live ad accounts needs guardrails that do not depend on the model behaving well.
Guardrail | How it works |
Dry run by default | Write tools default to |
Explicit confirmation | Publishing and destructive actions also require |
Paused by default | Cross-platform transfers create paused entities unless you choose to publish after confirmation. |
Idempotency | Writes accept an |
OAuth 2.1 | Authorization code with PKCE, refresh tokens and dynamic client registration. No API keys pasted into chats. |
Scopes | Nine scopes separate reading accounts, campaigns and reports from writing campaigns, exports, GTM and tracking. |
Allowlists | A connector token can be limited to specific ad accounts and tools. |
Annotations | Every tool declares |
Rate limits and logs | Per-session rate limiting, and a recent-calls log per client on the connector page. |
Metering | Only successful live work counts against your plan. Drafts, dry runs and failed jobs do not. |
Security and data handling: whathead.com/security-data · Privacy policy: whathead.com/privacy-policy
Example prompts
Paste these into your client once Whathead is connected.
"List my connected ad accounts by platform with currency, timezone and status."
"Compare spend, CPA and ROAS for Meta, TikTok and Snapchat over the last 14 days, by campaign."
"Find ad sets on Meta that spent more than 2x their target CPA in the last 7 days with no conversions. Show them, don't pause anything yet."
"Copy my best-performing Meta prospecting campaign to Snapchat as a paused draft. Show me the field mapping first."
"Check every active TikTok ad group for automatic placement and Smart+ settings, and list the ones that differ from manual placement."
"Pull last month's DV360 line item performance and flag line items pacing more than 20% behind."
"Build a Google Ads search campaign from this brief as a dry run and show me the payload."
"Which Search Console queries with more than 500 impressions in the last 28 days rank between positions 8 and 20?"
"Lower the daily budget of these three X campaigns by 15%. Dry run first."
More: docs.whathead.com/ai-assistant/what-it-can-do and examples/prompts.md.
Pricing
All plans include a 14-day free trial.
Plan | Monthly | MCP access |
Builder | $29 | No (visual builder, publishing, media plans, transfer) |
MCP Actions | $39 | Yes |
Operator Bundle | $65 | Yes, plus builder and client workspaces |
Agency | $249 | Yes, more seats and accounts, priority support |
Current limits and annual pricing: whathead.com/pricing
Docs and links
Connect your AI assistant: docs.whathead.com/ai-assistant/connect
What the assistant can do: docs.whathead.com/ai-assistant/what-it-can-do
Platform tools: docs.whathead.com/ai-assistant/platform-tools
Cross-platform transfer: docs.whathead.com/workflows/cross-platform-transfer
Free paid-media skills for Claude: github.com/SHAHINOOOO/claude-paid-media-skills
Support: whathead.com/support
In this repo
docs/clients/: step-by-step setup for Claude Desktop, Claude Code, ChatGPT, Cursor, Windsurf, Codex CLI, Gemini CLI and n8ndocs/tools.md: the 25 gateways on/mcpand the read-only surface on/mcp/readdocs/safety.md: dry-run, confirmation and scopesskills/andcommands/: Agent Skills and Claude Code slash commandsexamples/: ready-to-paste client configs and example prompts
Registry entries
Where | Identifier |
Official MCP Registry |
|
Server Card |
|
AI Catalog |
|
OAuth protected resource metadata |
|
License
The Whathead MCP server and the Whathead service are proprietary and hosted by Whathead. Using them is governed by the Terms of Service. This repository holds the registry manifest, documentation, configuration examples and example prompts, which you may copy, modify and use to connect to and integrate with Whathead (see LICENSE). "Whathead" and the Whathead logo are trademarks of Whathead and are not covered by that license.
Platform names are trademarks of their owners. Whathead is not affiliated with or endorsed by Meta, Google, TikTok, Snap, LinkedIn, Reddit, X, Microsoft, Criteo, Apple or Amazon.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Manage and optimize your ads on Meta, Google, TikTok, X, ChatGPT Ads, Reddit and LinkedIn from chat.
Ads MCP for Meta, Google Ads, TikTok, Snapchat and LinkedIn: stage launches and manage campaigns.
AI agents that manage paid ads on Meta, LinkedIn, and Google Ads from any MCP client.
Creative intelligence for Meta, TikTok, Google Ads and Amazon DSP, in Claude and other MCP clients.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables users to create, manage, and monitor Meta (Facebook/Instagram) ad campaigns directly from Claude using natural language.13145 PyPI17MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to create, analyze, and optimize ad campaigns across Google Ads, Meta Ads, TikTok Ads, LinkedIn Ads, Amazon Ads, and ChatGPT Ads through natural language using 400+ tools.107MIT

PaidSync MCP Serverofficial
AlicenseNot gradedqualityFmaintenanceConnects Google Ads, Meta Ads, and LinkedIn Ads to AI assistants, enabling natural language ad campaign management, reporting, and optimization across platforms.MIT
PaidSync MCPofficial
AlicenseNot gradedqualityCmaintenanceEnables AI assistants to create, manage, and optimize advertising campaigns across 14 ad and measurement platforms through a single MCP endpoint, with over 530 executable tools.4MIT