Skip to content
Get MCP AdsGet MCP Ads, home
Start free

MCP server

Google AdsMCP Server

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

https://mcp.getmcpads.com/google-ads/mcp
Start free

This endpoint serves Google Ads on its own. One shared URL reaches every platform you connect.

38
Tools
7
That write
130
Metrics
84
Dimensions

What you can ask it.

Real questions, with the tools each one resolves to. Every tool named below is in the catalogue on this page.

6 questions

Show me search terms we paid for last month that we would never have bid on.

Pulls the search term report, joins it to keyword performance, and lists spend against terms with no conversion and no match to your keyword set.

google_ads_get_search_termsgoogle_ads_get_keyword_performancegoogle_ads_get_budgets

Is any Performance Max campaign spending without the ad strength to justify it?

Reads asset group diagnostics, ad strength, coverage action items and placement types, then ranks campaigns by spend over asset health.

google_ads_get_pmax_asset_diagnosticsgoogle_ads_get_pmax_placementsgoogle_ads_get_pmax_assets

Who changed what in this Google Ads account in the last two weeks?

Reads the change event log inside the 30-day window Google allows, with the actor, the resource and the field that moved.

google_ads_get_change_eventsgoogle_ads_get_campaigns

Spend, CPA and ROAS by campaign across all four platforms, last 7 days against the 7 before.

One request, four APIs. Each platform's insights tool plans its own query, then the assistant lines the rows up in a single table.

meta_get_insightsgoogle_ads_get_insightstiktok_get_insightspinterest_run_report

Which Shopping products take spend and return nothing?

Joins Shopping performance to the Merchant Center catalogue by item ID, brand and custom label, so the answer names products rather than IDs.

google_ads_get_shopping_performancegoogle_ads_get_shopping_products

Cut the daily budget on the three worst Google campaigns by 30 percent.

Resolves the campaign budget IDs, computes the new amounts in the account currency, and shows them to you before writing anything.

google_ads_get_budgetsgoogle_ads_get_campaignsgoogle_ads_update_campaign_budget

Every question, across every platform

Every Google Ads tool, as the gateway ships it.

Each description is the one the tool reports to your assistant during discovery, which is what it reads before deciding to call it.

7 write

What it can change: 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. Every write previews first.

38 tools

  • google_ads_list_accounts

    List Google Ads customer accounts accessible with the current credentials.

  • google_ads_get_account_details

    Get detailed information for a specific Google Ads customer account.

  • google_ads_run_gaql

    Execute a raw GAQL (Google Ads Query Language) query.

  • google_ads_get_insights

    Query Google Ads performance insights with intelligent query planning.

  • google_ads_get_campaigns

    List campaigns for a Google Ads account with status, budget, channel type, and bidding strategy.

  • google_ads_get_adgroups

    List ad groups for a Google Ads account, optionally filtered by campaign.

  • google_ads_get_keyword_performance

    Get keyword-level performance data from keyword_view resource.

  • google_ads_validate_query

    Validate metric/dimension/resource compatibility BEFORE executing a query.

  • google_ads_health_check

    Read-only connectivity check. Verifies credential presence, Google Ads API access, login customer visibility, API version, and actionable warnings without returning secrets.

  • google_ads_get_account_hierarchy

    List accessible customers and, where possible, manager/client relationships from GAQL customer_client.

  • 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.

  • google_ads_get_change_events

    Fetch recent change_event rows. Enforces Google Ads constraints: date window within the last 30 days and LIMIT <= 10000.

  • google_ads_get_recommendations

    List Google Ads recommendations with type, resource, campaign/ad group links, dismissed state, and impact when supported.

  • google_ads_get_budgets

    List campaign budgets with amount, status, delivery method, and recommended budget fields when supported.

  • google_ads_get_bidding_strategies

    List portfolio bidding strategies. Includes metrics only when startDate/endDate are provided; otherwise returns structure only.

  • google_ads_get_search_terms

    Fetch search term performance from search_term_view or campaign_search_term_insight depending on reportType.

  • 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.

  • 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.

  • google_ads_get_simulations

    Read-only planning/forecast query for campaign, ad group, or portfolio bidding simulations.

  • google_ads_get_paid_organic_search_terms

    Read-only paid/organic search terms report. Uses paid_organic_search_term_view when available and falls back to paid-only search_term_view if organic fields are unavailable.

  • google_ads_get_shopping_products

    Read-only Merchant Center product catalog/eligibility report via shopping_product.

  • google_ads_get_shopping_performance

    Read-only Shopping performance report keyed by Merchant Center product dimensions.

  • google_ads_get_pmax_placements

    Read-only Performance Max placement diagnostics from performance_max_placement_view.

  • google_ads_get_pmax_asset_diagnostics

    Read-only Performance Max asset group diagnostics.

  • google_ads_update_campaign_statuswrite

    Pause, re-enable or remove a Google Ads campaign.

  • google_ads_update_campaign_budgetwrite

    Change a campaign's daily budget, in the account currency.

  • google_ads_create_campaignwrite

    Create a Google Ads campaign with its budget. Always created PAUSED, with no option to create it active.

  • google_ads_generate_ad_group_themes

    Organize supplied keywords into existing Google Ads ad groups.

  • google_ads_generate_keyword_forecast_metrics

    Forecast impressions, clicks, CTR, CPC, cost, conversions, and CPA for a temporary keyword campaign.

  • google_ads_generate_keyword_historical_metrics

    Get Keyword Planner search-volume history for supplied keywords.

  • google_ads_generate_keyword_ideas

    Discover Keyword Planner ideas from up to 20 seed keywords, a URL, keywords plus URL, or a whole site.

  • 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...

  • google_ads_search_fields

    Search Google's live GoogleAdsField catalog.

  • google_ads_suggest_geo_targets

    Resolve up to 25 location names or geo target IDs to Google Ads geoTargetConstants.

  • google_ads_rename_campaignwrite

    Rename a Google Ads campaign. Delivery, budget and targeting are untouched.

  • google_ads_update_adgroup_bidwrite

    Change the default CPC bid of a Google Ads ad group.

  • google_ads_update_adgroup_statuswrite

    Pause, re-enable or remove a Google Ads ad group.

  • google_ads_update_campaign_schedulewrite

    Change the start or end date of a Google Ads campaign.

What you can measure, and how you can cut it.

The full catalogues live in the reference, where every entry carries the API field it maps to and the constraints that come with it. Here is their shape.

Metrics

130

12 families

  • Conversion28
  • Video21
  • Core18
  • Calculated13
  • Impression share13
  • Shopping10
  • Spend7
  • Competitive6
  • Engagement6
  • Quality5
  • Invalid traffic2
  • Cross device1

All 130 metrics

Dimensions

84

13 families

  • Shopping26
  • Entity19
  • Bidding9
  • Time7
  • Budget5
  • Conversion4
  • Geographic3
  • Interaction3
  • Campaign type2
  • Demographic2
  • Device2
  • Ad format1
  • Network1

All 84 dimensions