google-ads-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_accessible_customersA | List the Google Ads customer IDs directly accessible to the configured credentials. |
| get_account_hierarchyB | List the accounts under a Google Ads manager (MCC) account, including nesting level. Args: customer_id: The manager account's customer ID (10 digits, dashes optional). |
| list_campaignsA | List campaigns in an account with their basic settings (no performance metrics). Args: customer_id: The Google Ads customer ID (10 digits, dashes optional). status: Optional filter - one of ENABLED, PAUSED, REMOVED. |
| get_campaign_performanceA | Get campaign-level performance metrics (impressions, clicks, cost, conversions). Args: customer_id: The Google Ads customer ID (10 digits, dashes optional). date_range: A GAQL date range literal, e.g. LAST_30_DAYS, LAST_7_DAYS, THIS_MONTH. campaign_id: Optional campaign ID to restrict results to a single campaign. |
| get_ad_group_performanceA | Get ad group-level performance metrics (impressions, clicks, cost, conversions). Args: customer_id: The Google Ads customer ID (10 digits, dashes optional). date_range: A GAQL date range literal, e.g. LAST_30_DAYS, LAST_7_DAYS, THIS_MONTH. campaign_id: Optional campaign ID to restrict results to a single campaign. |
| get_keyword_performanceA | Get keyword-level performance metrics (impressions, clicks, cost, conversions). Args: customer_id: The Google Ads customer ID (10 digits, dashes optional). date_range: A GAQL date range literal, e.g. LAST_30_DAYS, LAST_7_DAYS, THIS_MONTH. campaign_id: Optional campaign ID to restrict results to a single campaign. |
| run_gaqlA | Run a raw read-only GAQL SELECT query against the Google Ads API. Use this for reporting needs not covered by the other tools. GAQL only supports SELECT statements, so this cannot modify any Google Ads data. Args: customer_id: The Google Ads customer ID (10 digits, dashes optional). query: A GAQL SELECT query, e.g. "SELECT campaign.id, campaign.name FROM campaign WHERE campaign.status = 'ENABLED'". |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool targets a distinct resource or action: account listing, hierarchy, campaign listing, and performance at campaign, ad group, and keyword levels, plus a raw query fallback. There is no overlap or ambiguity between them.
All tool names follow a consistent verb_noun pattern (list_, get_, run_) and use snake_case throughout. The verbs accurately reflect the operation, and the nouns clearly indicate the target resource.
With 7 tools, the server is well-scoped for a read-only Google Ads reporting use case. Each tool serves a clear purpose, and the count is neither too sparse nor overwhelming.
The surface covers account enumeration, hierarchy, campaign listing, and performance at three key levels, plus a generic GAQL escape hatch. Minor gaps like structured ad group or keyword listing exist, but run_gaql can fill them, so no dead ends remain.