Google Ads MCP API reference
Every Google Ads tool the MCP server exposes, with its parameters. 45 tools, 130 metrics and 84 dimensions, on a dedicated endpoint.
51 rows
Raw GAQL, search terms, Shopping, Performance Max diagnostics, change history.
To connect another identity without replacing your existing access, open this source in the dashboard and choose Add another account. Select accounts from the combined list and save. See account scoping for selection, plan limits and reconnection.
Connection
- Platform id
google_ads- Tool prefix
google_ads_- Account parameter
customerId- Dedicated endpoint
- https:/
/ mcp. getmcpads. com/ google-ads/ mcp - Access
- Available for authorized, selected accounts.
- Tools
- 45, 10 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 (10)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_ | Preview, validate and atomically apply a Google Ads v25 build/change plan: campaigns, budgets, ad groups, RSA/Display/Demand Gen ads, image/text/YouTube assets, PMax asset groups and links, keywords, geographic/language targeting listing groups and conversion action configuration (no conversion event uploads). | Write | On demand |
google_ | Create a Google Ads campaign. | Write | On demand |
google_ | Remove a video upload owned by the selected ad account. | 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 |
google_ | Upload MP4/WebM/QuickTime bytes (max 16 MiB) to the Google-managed YouTube channel for the selected ad account. | Write | On demand |
Read tools (35)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_ | List Demand Gen ads (video responsive, multi-asset, carousel) with their referenced creatives resolved: stable image URLs and YouTube video IDs with embed and thumbnail URLs. | Read | Announced |
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 the processing state and YouTube video ID of one Google Ads upload in the selected customer. | Read | On demand |
google_ | Read-only connectivity check. | Read | Announced |
google_ | List Google Ads customer accounts accessible with the current credentials. | Read | Announced |
google_ | List the account's image asset library (FROM asset) with stable, publicly served full-size URLs on tpc.googlesyndication.com, dimensions, file size, and mime type. | Read | Announced |
google_ | List the account's YouTube video assets (FROM asset) with derived watch, embed, and public thumbnail URLs. | 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:/ |