MCP Server

Ask about your ad accounts without switching tools.

Campaign Agents ships with an MCP server. Connect it to Claude, ChatGPT, or any MCP-compatible agent and query your ad performance directly inside your AI workflow.

  • OAuth 2.1 for Claude.ai, ChatGPT, Claude Desktop — or paste a long-lived API key for everything else
  • Free tier: read-only, 1 platform, 100 actions/month, free forever
  • Pro tier: all platforms, write access, 1,000 actions/month
  • Write receipts with action_id, status, and timestamp on every operation
Get your API keySee MCP pricing
MCP request

// ask in Claude

"Which Google Ads campaigns are trending down this week?"

// tool call

get_campaign_performance(

"google_ads",

"last_7_days"

)

// response

{ campaigns: [...], anomalies: 2,

recommendations: [...] }

Available MCP tools

Free tier includes read tools. Pro unlocks write access across all platforms.

Free — Read only

get_campaign_performance

Query performance metrics for a platform and date range

params: platform, date_range

get_anomalies

Surface campaigns deviating from their baseline

params: threshold

get_recommendations

Get optimization recommendations for connected accounts

params: —

Pro — Write access

pause_campaign

Pause a campaign by ID

params: campaign_id

resume_campaign

Resume a paused campaign

params: campaign_id

adjust_budget

Update a campaign's daily budget

params: campaign_id, amount

create_ad_group

Create a new ad group within a campaign

params: campaign_id, ...

Common questions about the MCP server

How do I authenticate with the Campaign Agents MCP server?

Two methods. Claude.ai, ChatGPT, and Claude Desktop connect via OAuth 2.1 — paste the MCP URL into Custom Connectors and approve a consent screen, no key to copy. Cursor, VS Code, Claude Code, and any other client connects with a long-lived API key passed as a Bearer token. Both flows hit the same endpoint with the same scopes and rate limits.

What is the difference between free and Pro MCP access?

The free tier gives you read-only access to one ad platform with 100 actions/month. You can query campaign performance, surface anomalies, and get recommendations. Pro unlocks all platforms, write access (pause campaigns, adjust budgets, create ad groups), 1,000 actions/month, full historical data, and cross-platform queries.

What happens when a write action requires confirmation?

Writes that exceed your guardrail thresholds — budget changes over 30%, or bulk operations affecting more than 10 campaigns — return status: pending_approval with a link to confirm in the Campaign Agents app. All other writes execute immediately and return a structured receipt with action_id, status, affected object, and timestamp.

What happens if I hit the MCP rate limit?

The server returns a 429 with a Retry-After header and structured JSON that includes an upgrade URL. MCP-compatible agents can parse this response and surface an upgrade prompt automatically.

Explore more Campaign Agents features

CLI

Run queries and actions from your terminal or scripts.

Proactive Alerts

Pushed anomaly detection — no polling required.

Pricing

Free MCP tier — permanent, no credit card.

Connect your AI workflow to your ad accounts.

Free tier available — no credit card, no time limit.

Get your API key