# Google Ads

> Every Google Ads tool the MCP server exposes, with its parameters. 38 tools, 130 metrics and 84 dimensions, on a dedicated endpoint.

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources)

Raw GAQL, search terms, Shopping, Performance Max diagnostics, change history.

Connection

|  |  |
| --- | --- |
| Platform id | `google_ads` |
| Tool prefix | `google_ads_` |
| Account parameter | `customerId` |
| Dedicated endpoint | https://mcp.getmcpads.com/google-ads/mcp |
| Tools | 38, 7 of which write |
| Metrics | 130 |
| Dimensions | 84 |

## Scope requested

| Scope | Grants | Allows writes |
| --- | --- | --- |
| `https://www.googleapis.com/auth/adwords` | Read and write on Google Ads. Google publishes no read-only alternative, so read-only enforcement is done by this gateway, not by Google. | Yes |

> **Note** What the gateway can change here: Pause, resume or remove a campaign or ad group. Rename a campaign, change its dates, change a daily budget or an ad group CPC bid. Create a campaign, always paused.

## Catalogues

- [Metrics](https://www.getmcpads.com/docs/sources/google-ads/metrics): 130 metrics, with the field name each one maps to.
- [Dimensions](https://www.getmcpads.com/docs/sources/google-ads/dimensions): 84 dimensions, with their constraints.

## Write tools (7)

Absent from the tool list on the Free plan. Each one previews by default and needs a second call with `confirm: true`.

| Tool | What it does | Kind | Discovery |
| --- | --- | --- | --- |
| [`google_ads_create_campaign`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_create_campaign) | Create a Google Ads campaign. | Write | On demand |
| [`google_ads_rename_campaign`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_rename_campaign) | Rename a Google Ads campaign. | Write | On demand |
| [`google_ads_update_adgroup_bid`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_update_adgroup_bid) | Change the default CPC bid of a Google Ads ad group. | Write | On demand |
| [`google_ads_update_adgroup_status`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_update_adgroup_status) | Pause, re-enable or remove a Google Ads ad group. | Write | On demand |
| [`google_ads_update_campaign_budget`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_update_campaign_budget) | Change the daily budget of a Google Ads campaign. | Write | On demand |
| [`google_ads_update_campaign_schedule`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_update_campaign_schedule) | Change the start or end date of a Google Ads campaign. | Write | On demand |
| [`google_ads_update_campaign_status`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_update_campaign_status) | Pause, re-enable or remove a Google Ads campaign. | Write | On demand |

## Read tools (31)

Tools marked *Announced* appear in your client's tool list. The rest are reachable through `search_tools` and `run_tool`, which run the same checks.

| Tool | What it does | Kind | Discovery |
| --- | --- | --- | --- |
| [`google_ads_generate_ad_group_themes`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_generate_ad_group_themes) | Organize supplied keywords into existing Google Ads ad groups. | Read | On demand |
| [`google_ads_generate_keyword_forecast_metrics`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_generate_keyword_forecast_metrics) | Forecast impressions, clicks, CTR, CPC, cost, conversions, and CPA for a temporary keyword campaign. | Read | On demand |
| [`google_ads_generate_keyword_historical_metrics`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_generate_keyword_historical_metrics) | Get Keyword Planner search-volume history for supplied keywords. | Read | On demand |
| [`google_ads_generate_keyword_ideas`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_generate_keyword_ideas) | Discover Keyword Planner ideas from up to 20 seed keywords, a URL, keywords plus URL, or a whole site. | Read | On demand |
| [`google_ads_get_account_details`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_account_details) | Get detailed information for a specific Google Ads customer account. | Read | On demand |
| [`google_ads_get_account_hierarchy`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_account_hierarchy) | List accessible customers and, where possible, manager/client relationships from GAQL customer_client. | Read | On demand |
| [`google_ads_get_adgroups`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_adgroups) | List ad groups for a Google Ads account, optionally filtered by campaign. | Read | On demand |
| [`google_ads_get_bidding_strategies`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_bidding_strategies) | List portfolio bidding strategies. | Read | On demand |
| [`google_ads_get_budgets`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_budgets) | List campaign budgets with amount, status, delivery method, and recommended budget fields when supported. | Read | On demand |
| [`google_ads_get_campaigns`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_campaigns) | List campaigns for a Google Ads account with status, budget, channel type, and bidding strategy. | Read | Announced |
| [`google_ads_get_change_events`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_change_events) | Fetch recent change_event rows. | Read | On demand |
| [`google_ads_get_conversion_actions`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_conversion_actions) | List conversion actions with status, type, category, primary/include-in-conversions flags, owner customer, and last activity dates when supported. | Read | On demand |
| [`google_ads_get_insights`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_insights) | Query Google Ads performance insights with intelligent query planning. | Read | Announced |
| [`google_ads_get_keyword_performance`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_keyword_performance) | Get keyword-level performance data from keyword_view resource. | Read | On demand |
| [`google_ads_get_landing_pages`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_landing_pages) | Fetch landing_page_view performance with final URL, campaign/ad group context, traffic, conversion, and landing-page quality metrics when supported. | Read | On demand |
| [`google_ads_get_paid_organic_search_terms`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_paid_organic_search_terms) | Read-only paid/organic search terms report. | Read | On demand |
| [`google_ads_get_pmax_asset_diagnostics`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_pmax_asset_diagnostics) | Read-only Performance Max asset group diagnostics. | Read | On demand |
| [`google_ads_get_pmax_assets`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_pmax_assets) | List Performance Max asset group assets from asset_group_asset with asset group/campaign context and optional date-range performance metrics. | Read | On demand |
| [`google_ads_get_pmax_placements`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_pmax_placements) | Read-only Performance Max placement diagnostics from performance_max_placement_view. | Read | On demand |
| [`google_ads_get_recommendations`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_recommendations) | List Google Ads recommendations with type, resource, campaign/ad group links, dismissed state, and impact when supported. | Read | On demand |
| [`google_ads_get_search_terms`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_search_terms) | Fetch search term performance from search_term_view or campaign_search_term_insight depending on reportType. | Read | Announced |
| [`google_ads_get_shopping_performance`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_shopping_performance) | Read-only Shopping performance report keyed by Merchant Center product dimensions. | Read | On demand |
| [`google_ads_get_shopping_products`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_shopping_products) | Read-only Merchant Center product catalog/eligibility report via shopping_product. | Read | On demand |
| [`google_ads_get_simulations`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_get_simulations) | Read-only planning/forecast query for campaign, ad group, or portfolio bidding simulations. | Read | On demand |
| [`google_ads_health_check`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_health_check) | Read-only connectivity check. | Read | Announced |
| [`google_ads_list_accounts`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_list_accounts) | List Google Ads customer accounts accessible with the current credentials. | Read | Announced |
| [`google_ads_run_gaql`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_run_gaql) | Execute a raw GAQL (Google Ads Query Language) query. | Read | On demand |
| [`google_ads_run_readonly_rpc`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_run_readonly_rpc) | Advanced read-only escape hatch for allowlisted Google Ads services outside GAQL: Audience Insights, Reach Planner, benchmarks, creator/trending insights, targeting suggestions, Smart Campaign suggestions, identity verification, invoices, and payments accounts. | Read | On demand |
| [`google_ads_search_fields`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_search_fields) | Search Google's live GoogleAdsField catalog. | Read | On demand |
| [`google_ads_suggest_geo_targets`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_suggest_geo_targets) | Resolve up to 25 location names or geo target IDs to Google Ads geoTargetConstants. | Read | On demand |
| [`google_ads_validate_query`](https://www.getmcpads.com/docs/sources/google-ads/tools/google_ads_validate_query) | Validate metric/dimension/resource compatibility BEFORE executing a query. | Read | On demand |

## MCP resources

Read these with `resources/read` for machine readable metadata about the source.

| Name | URI |
| --- | --- |
| google-ads-manifest | `google-ads://manifest` |
| google-ads-recipes | `google-ads://recipes` |
| google-ads-metrics | `google-ads://metrics` |
| google-ads-dimensions | `google-ads://dimensions` |
| google-ads-compatibility | `google-ads://compatibility` |

---

This page as HTML: https://www.getmcpads.com/docs/sources/google-ads
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.