traffic-google-ads-mcp

Queries Google Ads account and campaign data via the official read-only Google Ads MCP server using GAQL.

3|3|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/joaoguirunas/team-os --skill traffic-google-ads-mcp-joaoguirunas
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: traffic-google-ads-mcp
Source: https://github.com/joaoguirunas/team-os/tree/main/.claude/skills/traffic-google-ads-mcp
Command: npx skills add https://github.com/joaoguirunas/team-os --skill traffic-google-ads-mcp-joaoguirunas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It removes the guesswork of querying Google Ads data by providing a validated GAQL cookbook, a canonical account-discovery workflow, and clear read-only guardrails for the official Google Ads MCP server. ## Core Features & Use Cases - Canonical MCP workflow: Discover accessible customer IDs with list_accessible_customers, validate fields with get_resource_metadata, then run search queries. - Validated GAQL cookbook: Ready-to-run queries for campaign performance, budget pacing, search terms mining, Quality Score, RSA performance, Performance Max asset groups, change-event audits, and conversion actions. - Guardrails and handoffs: Enforces read-only limits, micros-to-currency conversion, developer-token access levels, and routes all mutations to the Google Ads API via traffic-automation. - Use Case: A media buyer asks why spend spiked last week; the agent runs the change-event and campaign performance GAQL queries against the live account and reports which campaigns, budgets, and users drove the change. ## Quick Start Ask the agent to list accessible Google Ads customers and then pull a 30-day campaign performance report with cost, conversions, and CPA using the Google Ads MCP.

Frequently Asked Questions about traffic-google-ads-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query Google Ads data with the official MCP server?▼

Start with list_accessible_customers to get the customer ID without hyphens, optionally validate fields with get_resource_metadata, then run a GAQL query through the search tool. All three tools are read-only.

How do I write a GAQL query for campaign performance?▼

Select campaign fields plus metrics like impressions, clicks, cost_micros, and conversions FROM campaign, filter with segments.date DURING LAST_30_DAYS, and order by cost. Divide cost_micros by 1,000,000 to get the account currency value.

Can the Google Ads MCP pause campaigns or change budgets?▼

No. The official Google Ads MCP is strictly read-only and cannot create, pause, or edit anything. All mutations such as negative keywords, budgets, and bids must go through the Google Ads API, handled by the traffic-automation agent.

Why does the Google Ads MCP search return a permission error?▼

A developer token with Explorer access can only see test accounts; production accounts require Basic or Standard access. If search fails on a real account, the token level is the likely cause and should be reported rather than retried.

Why do Google Ads metrics not match GA4 numbers?▼

Google Ads and GA4 use different attribution models and reporting windows, so conversions and revenue rarely match exactly. Cross-source comparisons should follow a documented discrepancy protocol rather than forcing the numbers to align.