Skip to content
Get MCP AdsGet MCP Ads, home
Start free
View as Markdown

Connect Google Ads to an AI assistant

Connect Google Ads to Claude, ChatGPT, Codex or any MCP client, what to ask it once it is connected, and the 38 tools behind the answers.

For you

What the answer looks like, and what to type to get it.

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

Connect itLink to this section

  1. Open the dashboard and choose this platform.
  2. Approve the consent screen. The gateway stores an encrypted refresh token, never a password.
  3. Tick the accounts to expose. Nothing is readable until you do.
  4. Paste the endpoint into your assistant, or use the shared one for every platform at once.
textGoogle Ads on its own endpoint
https://mcp.getmcpads.com/google-ads/mcp

What to askLink to this section

text
Which campaigns spend the most and return the least?
Show me search terms we paid for that we would never have bid on.
Is any Performance Max campaign spending without the ad strength to justify it?
Who changed what in the last two weeks?
Which Shopping products take spend and return nothing?
What would these keywords cost, and how much volume is there?
Run this exact GAQL query.

What answers each oneLink to this section

QuestionTools
Which campaigns spend the most and return the least?google_ads_get_insights, google_ads_get_campaigns
Show me search terms we paid for that we would never have bid on.google_ads_get_search_terms
Is any Performance Max campaign spending without the ad strength to justify it?google_ads_get_pmax_asset_diagnostics, google_ads_get_pmax_placements
Who changed what in the last two weeks?google_ads_get_change_events
Which Shopping products take spend and return nothing?google_ads_get_shopping_performance, google_ads_get_shopping_products
What would these keywords cost, and how much volume is there?google_ads_generate_keyword_ideas, google_ads_generate_keyword_forecast_metrics
Run this exact GAQL query.google_ads_run_gaql, google_ads_search_fields

What it can changeLink to this section

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.

For your agent

The tool sequence, the parameters that matter, and what will be refused.

Both readings as Markdown: /guides/sources/google-ads.md

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
Announced by default
google_ads_get_campaigns, google_ads_get_insights, google_ads_get_search_terms, google_ads_health_check, google_ads_list_accounts
Metrics
130, see /docs/sources/google-ads/metrics
Dimensions
84, see /docs/sources/google-ads/dimensions

Scope requested from the platformLink to this section

ScopeGrantsAllows writes
https://www.googleapis.com/auth/adwordsRead and write on Google Ads. Google publishes no read-only alternative, so read-only enforcement is done by this gateway, not by Google.Yes

Reaching a tool that is not announcedLink to this section

text
search_tools({ task: "..." })      find it
describe_tool({ name: "..." })     read its schema
run_tool({ name, args })           execute, with the same checks

What will refuse youLink to this section

  • An account not ticked by the owner. Call list_accounts and use a customerId from it.
  • A write on a plan without writes. The tool is absent from the list and refused if called anyway.
  • A write without confirm: true returns a preview and applies nothing. That is not an error.
  • A call to this platform on another platform's dedicated endpoint. The refusal names the URL that serves it.

Questions this source answersLink to this section

QuestionTools, in order
Which campaigns spend the most and return the least?google_ads_get_insights then google_ads_get_campaigns
Show me search terms we paid for that we would never have bid on.google_ads_get_search_terms
Is any Performance Max campaign spending without the ad strength to justify it?google_ads_get_pmax_asset_diagnostics then google_ads_get_pmax_placements
Who changed what in the last two weeks?google_ads_get_change_events
Which Shopping products take spend and return nothing?google_ads_get_shopping_performance then google_ads_get_shopping_products
What would these keywords cost, and how much volume is there?google_ads_generate_keyword_ideas then google_ads_generate_keyword_forecast_metrics
Run this exact GAQL query.google_ads_run_gaql then google_ads_search_fields