Repository avatar
AI Tools
v1.1.1
active

ads

com.whathead/ads

Build, edit, transfer and report on ad campaigns across Meta, Google, TikTok, Snapchat and 8 more.

Documentation

Whathead

Whathead MCP

One remote MCP server for the ad platforms your media plan actually buys.

MCP Registry Transport Auth Writes

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.

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)

  1. Open Settings → Connectors → Add custom connector.
  2. Name it Whathead and paste https://www.whathead.com/mcp.
  3. Click Connect, sign in to Whathead and approve access.
  4. 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/mcp

Then run /mcp inside Claude Code, choose whathead and complete the browser sign-in.

ChatGPT

  1. In Settings → Apps & Connectors, open Advanced settings and turn on Developer mode (required for custom MCP connectors on most plans).
  2. Create a connector with the URL https://www.whathead.com/mcp and OAuth authentication.
  3. Sign in to Whathead and approve access.
  4. 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.

PlatformRead and reportBuild and edit (create, update, pause)Native API actionsMCP gateway
Meta (Facebook, Instagram)YesYes, incl. lead forms and page posts528meta_native_action
Google AdsYesYes (Google Ads API v23; actions flagged for confirmation)171google_ads_native_action
TikTokYesYes496tiktok_native_action
SnapchatYesYes, incl. lead forms and lead webhooks268snapchat_native_action
LinkedInYesYes, incl. campaign groups and lead gen287linkedin_native_action
RedditYesYes, incl. posts, lead gen and catalogs49reddit_native_action
XYesYes186x_ads_native_action
Microsoft AdvertisingYesYes (REST v13 campaign management, bulk, reporting)280microsoft_ads_native_action
Display & Video 360Yes, incl. Bid Manager reportingYes173dv360_native_action
Criteo Retail MediaYesYes108criteo_native_action
Apple AdsYesYes172apple_ads_native_action
Amazon Ads (SP, SB, SD)YesYes188amazon_native_action
Google Analytics 4Reports, async report tasks, metadataAudience exports12 toolsga4_native_action
Google Search ConsoleSites, sitemaps, URL inspection, search analyticsSubmit and delete sitemaps16google_search_console_native_action
ShopifyConnect a store in the workspace (products, orders, inventory, sales)Not yet exposed as MCP toolsn/an/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_transfer copies 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.

GuardrailHow it works
Dry run by defaultWrite tools default to dry_run: true and return the exact payload or diff they would send. Nothing changes until a call is made with dry_run: false.
Explicit confirmationPublishing and destructive actions also require confirmed: true. Google Ads actions carry a per-action confirmation flag.
Paused by defaultCross-platform transfers create paused entities unless you choose to publish after confirmation.
IdempotencyWrites accept an idempotency_key, so a retried call does not create duplicates.
OAuth 2.1Authorization code with PKCE, refresh tokens and dynamic client registration. No API keys pasted into chats.
ScopesNine scopes separate reading accounts, campaigns and reports from writing campaigns, exports, GTM and tracking.
AllowlistsA connector token can be limited to specific ad accounts and tools.
AnnotationsEvery tool declares readOnlyHint, destructiveHint and openWorldHint, so clients can ask before running writes.
Rate limits and logsPer-session rate limiting, and a recent-calls log per client on the connector page.
MeteringOnly 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.

PlanMonthlyMCP access
Builder$29No (visual builder, publishing, media plans, transfer)
MCP Actions$39Yes
Operator Bundle$65Yes, plus builder and client workspaces
Agency$249Yes, more seats and accounts, priority support

Current limits and annual pricing: whathead.com/pricing

Docs and links

In this repo

  • docs/clients/: step-by-step setup for Claude Desktop, Claude Code, ChatGPT, Cursor, Windsurf, Codex CLI, Gemini CLI and n8n
  • docs/tools.md: the 25 gateways on /mcp and the read-only surface on /mcp/read
  • docs/safety.md: dry-run, confirmation and scopes
  • skills/ and commands/: Agent Skills and Claude Code slash commands
  • examples/: ready-to-paste client configs and example prompts

Registry entries

WhereIdentifier
Official MCP Registrycom.whathead/ads (server.json)
Server Cardhttps://www.whathead.com/mcp/server-card
AI Cataloghttps://www.whathead.com/.well-known/ai-catalog.json
OAuth protected resource metadatahttps://www.whathead.com/.well-known/oauth-protected-resource

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.

No installation packages available.