Google Ads MCP API reference
Every Google Ads tool the MCP server exposes, with its parameters. 38 tools, 130 metrics and 84 dimensions, on a dedicated endpoint.
44 rows
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 requestedLink to this section
| Scope | Grants | Allows writes |
|---|---|---|
https:/ | 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 |
CataloguesLink to this section
Write tools (7)Link to this section
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_ | Create a Google Ads campaign. | Write | On demand |
google_ | Rename a Google Ads campaign. | Write | On demand |
google_ | Change the default CPC bid of a Google Ads ad group. | Write | On demand |
google_ | Pause, re-enable or remove a Google Ads ad group. | Write | On demand |
google_ | Change the daily budget of a Google Ads campaign. | Write | On demand |
google_ | Change the start or end date of a Google Ads campaign. | Write | On demand |
google_ | Pause, re-enable or remove a Google Ads campaign. | Write | On demand |
Read tools (31)Link to this section
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_ | Organize supplied keywords into existing Google Ads ad groups. | Read | On demand |
google_ | Forecast impressions, clicks, CTR, CPC, cost, conversions, and CPA for a temporary keyword campaign. | Read | On demand |
google_ | Get Keyword Planner search-volume history for supplied keywords. | Read | On demand |
google_ | Discover Keyword Planner ideas from up to 20 seed keywords, a URL, keywords plus URL, or a whole site. | Read | On demand |
google_ | Get detailed information for a specific Google Ads customer account. | Read | On demand |
google_ | List accessible customers and, where possible, manager/client relationships from GAQL customer_client. | Read | On demand |
google_ | List ad groups for a Google Ads account, optionally filtered by campaign. | Read | On demand |
google_ | List portfolio bidding strategies. | Read | On demand |
google_ | List campaign budgets with amount, status, delivery method, and recommended budget fields when supported. | Read | On demand |
google_ | List campaigns for a Google Ads account with status, budget, channel type, and bidding strategy. | Read | Announced |
google_ | Fetch recent change_event rows. | Read | On demand |
google_ | List conversion actions with status, type, category, primary/include-in-conversions flags, owner customer, and last activity dates when supported. | Read | On demand |
google_ | Query Google Ads performance insights with intelligent query planning. | Read | Announced |
google_ | Get keyword-level performance data from keyword_view resource. | Read | On demand |
google_ | 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_ | Read-only paid/organic search terms report. | Read | On demand |
google_ | Read-only Performance Max asset group diagnostics. | Read | On demand |
google_ | 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_ | Read-only Performance Max placement diagnostics from performance_max_placement_view. | Read | On demand |
google_ | List Google Ads recommendations with type, resource, campaign/ad group links, dismissed state, and impact when supported. | Read | On demand |
google_ | Fetch search term performance from search_term_view or campaign_search_term_insight depending on reportType. | Read | Announced |
google_ | Read-only Shopping performance report keyed by Merchant Center product dimensions. | Read | On demand |
google_ | Read-only Merchant Center product catalog/eligibility report via shopping_product. | Read | On demand |
google_ | Read-only planning/forecast query for campaign, ad group, or portfolio bidding simulations. | Read | On demand |
google_ | Read-only connectivity check. | Read | Announced |
google_ | List Google Ads customer accounts accessible with the current credentials. | Read | Announced |
google_ | Execute a raw GAQL (Google Ads Query Language) query. | Read | On demand |
google_ | 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_ | Search Google's live GoogleAdsField catalog. | Read | On demand |
google_ | Resolve up to 25 location names or geo target IDs to Google Ads geoTargetConstants. | Read | On demand |
google_ | Validate metric/dimension/resource compatibility BEFORE executing a query. | Read | On demand |
MCP resourcesLink to this section
Read these with resources/read for machine readable metadata about the source.
| Name | URI |
|---|---|
| google-ads-manifest | google-ads:/ |
| google-ads-recipes | google-ads:/ |
| google-ads-metrics | google-ads:/ |
| google-ads-dimensions | google-ads:/ |
| google-ads-compatibility | google-ads:/ |