Overview
Google Ads MCP server — server URL, prerequisites, and the full tool catalog.
Google Ads MCP
The Google Ads MCP server gives AI assistants read-only access to your Google Ads data through Madgicx. List customer accounts, campaigns, ad groups, and ads, and pull performance metrics with breakdowns — all from any MCP-compatible client.
Read-only
The Google Ads MCP server does not perform any mutations. Use it for discovery, reporting, and analysis. Write operations are available on the Facebook Ads MCP.
Server URL
Use this URL when configuring your MCP client. See Connecting Clients for client-specific setup guides — the steps are identical to the Facebook Ads MCP, just substitute this URL.
Prerequisites
Before connecting, make sure you have:
- A Madgicx account with an active subscription or active trial — start here if you don't have one
- An Active Workspace
- A connected Google token and at least one Google Ads account linked in Settings → Ad Accounts → Google Ad Accounts
The server will return an authentication error if no Google token is present on your active team.
Tool Catalog
| Category | Tools |
|---|---|
| Identity | whoiam — verify connection, team, and Google Ads token status |
| Ad Accounts | list_ad_accounts — list Google Ads customers (accounts) |
| Campaigns | list_campaigns — list campaigns with filters |
| Ad Groups | list_ad_groups — list ad groups (Google's ad sets) with filters |
| Ads | list_ads — list ads with filters |
| Insights | get_insights — performance metrics at customer / campaign / ad group / ad level |
See the Tools section for full parameter documentation on every tool.
Google Ads vs Facebook Ads terminology
If you're coming from Facebook Ads, here's the mapping the AI assistant will use:
| Google Ads | |
|---|---|
| Ad Account | Customer (also called "ad account") |
| Campaign | Campaign |
| Ad Set | Ad Group |
| Ad | Ad |
Quick Examples
Working with customer IDs
Google Ads customer IDs are 10-digit numbers, often shown in dashed form (123-456-7890). The tools accept either format — both are normalized to the digits-only form required by the API.
For accounts you access via a manager (MCC) account, you'll also need to provide a login_customer_id for the manager account.