Google Ads MCP server
online · 100% uptimeFull Google Ads management: read (campaigns, performance, ROAS, keywords, search terms) and write (p
0 stars
Reviews
Write oneNobody has reviewed Google Ads yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Google Ads tools (35, 12 write)
write = sends, deletes, buys or postsauthenticateFreeMCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.
connectFreeReturns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.
google_ads_accountFreeGet Google Ads account info: name, currency, timezone for a customer (uses account + customer_id to resolve scope). Bulk support: accepts customer_ids for batched execution.
google_ads_ad_group_createwrite actionFreeCreate an ad group inside a campaign. Default status ENABLED, type SEARCH_STANDARD. Optional cpc_bid as the ad-group-level default max CPC. Bulk support: accepts campaign_ids, customer_ids for batched execution.
google_ads_ad_group_update_statuswrite actionFreePause, enable or remove ad groups. REMOVED is irreversible.
google_ads_ad_update_statuswrite actionFreePause, enable or remove ads. Each entry needs ad_group_id + ad_id because the ad resource is keyed by both (customers/X/adGroupAds/{ad_group_id}~{ad_id}). Bulk support: accepts customer_ids for batched execution.
google_ads_adsFreeList enabled ads with type, status, campaign name and ad_group_ad.policy_summary (approval_status, review_status, policy_topic_entries) — answers "why is my ad not serving?" without opening the Google Ads UI. Bulk support: accepts customer_ids for batched execution.
google_ads_campaign_budget_createwrite actionFreeCreate a campaign_budget. Required to create a campaign. Amount is daily, in account currency unit (50 = R$50/day). Bulk support: accepts customer_ids for batched execution.
google_ads_campaign_createwrite actionFreeCreate a Google Ads campaign. Defaults to channel_type=SEARCH, status=PAUSED (safe), bidding_strategy=MANUAL_CPC. Provide budget_id from google_ads_campaign_budget_create. Declares no EU political advertising by default (Reg 2024/900, required by Google). Only SEARCH, DISPLAY and SHOPPING can be created through the API: VIDEO (YouTube) is read-only on Google side, and PERFORMANCE_MAX must be created together with its asset group. Build those two in the Google Ads interface and use this MCP to report on them. Bulk support: accepts budget_ids, merchant_ids, customer_ids for batched execution.
google_ads_campaign_update_budgetwrite actionFreeUpdate the daily budget of a campaign. Pass the campaign id and the new amount in the account currency unit (R$50,50 -> 50.5; converted to micros internally). Bulk support: accepts campaign_ids, customer_ids for batched execution.
google_ads_campaign_update_statuswrite actionFreePause, enable or remove one or more Google Ads campaigns. REMOVED is irreversible. Pass campaign ids from google_ads_campaigns. Google rejects status changes on trial (draft/experiment) campaigns, which can only be changed in the Google Ads UI.
google_ads_campaignsFreeList Google Ads campaigns with status and budgets. Default (ALL) returns both ENABLED and PAUSED campaigns; pass status ENABLED or PAUSED to narrow. REMOVED (deleted) campaigns are excluded. Bulk support: accepts customer_ids for batched execution.
google_ads_changesFreeChange history / audit log: who changed what in the account and when. Covers campaigns, ad groups, ads (headlines/descriptions/final URLs), keywords, budgets and bids, with the user_email who made each change, the client (web UI / API / bulk upload), the operation (CREATE/UPDATE/REMOVE), the changed field mask and the old→new resource. Backed by Google Ads change_event (last 30 days only, per customer). Pass `since`/`until` (YYYY-MM-DD or "YYYY-MM-DD HH:MM:SS") or `days`; for incremental polling pass `since` = the last seen change timestamp. Bulk support: accepts customer_ids for batched execution.
google_ads_keyword_addFreeAdd positive keywords to an ad group. Each keyword: { text, match_type, cpc_bid? }. match_type = EXACT | PHRASE | BROAD. Bulk support: accepts ad_group_ids, customer_ids for batched execution.
google_ads_keyword_update_bidwrite actionFreeUpdate max CPC for one or more keywords. Bid in account currency unit (e.g. 1.5 = R$1,50). Bulk support: accepts customer_ids for batched execution.
google_ads_keyword_update_statuswrite actionFreePause, enable or remove keywords. Each entry needs ad_group_id + criterion_id (the keyword criterion id). Bulk support: accepts customer_ids for batched execution.
google_ads_keywords_diagnosticsFreeKeyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT. Uses account + customer_id for scope. Actions: `keywords` (last 7 days metrics top 50), `search_terms` (last 7 days), `status` (ALL enabled keywords with approval_status, system_serving_status — e.g. RARELY_SERVED for "Low search volume" — and disapproval_reasons; answers "why is my keyword not serving?"), `diagnostics` (Quality Score, position estimates / top-of-page CPC, impression share, rank-lost; answers "is it bid or Quality Score?"; bundles per-campaign budget-loss as `_campaign_budget_loss` since budget is a campaign property, not keyword; supports campaign_id/ad_group_id filters and days=7|14|30), `raw` (any GAQL SELECT). [Flattened action: diagnostics] Bulk support: accepts campaign_ids, ad_group_ids, customer_ids for batched execution.
google_ads_keywords_keywordsFreeKeyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT. Uses account + customer_id for scope. Actions: `keywords` (last 7 days metrics top 50), `search_terms` (last 7 days), `status` (ALL enabled keywords with approval_status, system_serving_status — e.g. RARELY_SERVED for "Low search volume" — and disapproval_reasons; answers "why is my keyword not serving?"), `diagnostics` (Quality Score, position estimates / top-of-page CPC, impression share, rank-lost; answers "is it bid or Quality Score?"; bundles per-campaign budget-loss as `_campaign_budget_loss` since budget is a campaign property, not keyword; supports campaign_id/ad_group_id filters and days=7|14|30), `raw` (any GAQL SELECT). [Flattened action: keywords] Bulk support: accepts campaign_ids, ad_group_ids, customer_ids for batched execution.
google_ads_keywords_rawFreeKeyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT. Uses account + customer_id for scope. Actions: `keywords` (last 7 days metrics top 50), `search_terms` (last 7 days), `status` (ALL enabled keywords with approval_status, system_serving_status — e.g. RARELY_SERVED for "Low search volume" — and disapproval_reasons; answers "why is my keyword not serving?"), `diagnostics` (Quality Score, position estimates / top-of-page CPC, impression share, rank-lost; answers "is it bid or Quality Score?"; bundles per-campaign budget-loss as `_campaign_budget_loss` since budget is a campaign property, not keyword; supports campaign_id/ad_group_id filters and days=7|14|30), `raw` (any GAQL SELECT). [Flattened action: raw] Bulk support: accepts campaign_ids, ad_group_ids, customer_ids for batched execution.
google_ads_keywords_search_termsFreeKeyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT. Uses account + customer_id for scope. Actions: `keywords` (last 7 days metrics top 50), `search_terms` (last 7 days), `status` (ALL enabled keywords with approval_status, system_serving_status — e.g. RARELY_SERVED for "Low search volume" — and disapproval_reasons; answers "why is my keyword not serving?"), `diagnostics` (Quality Score, position estimates / top-of-page CPC, impression share, rank-lost; answers "is it bid or Quality Score?"; bundles per-campaign budget-loss as `_campaign_budget_loss` since budget is a campaign property, not keyword; supports campaign_id/ad_group_id filters and days=7|14|30), `raw` (any GAQL SELECT). [Flattened action: search_terms] Bulk support: accepts campaign_ids, ad_group_ids, customer_ids for batched execution.
google_ads_keywords_statusFreeKeyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT. Uses account + customer_id for scope. Actions: `keywords` (last 7 days metrics top 50), `search_terms` (last 7 days), `status` (ALL enabled keywords with approval_status, system_serving_status — e.g. RARELY_SERVED for "Low search volume" — and disapproval_reasons; answers "why is my keyword not serving?"), `diagnostics` (Quality Score, position estimates / top-of-page CPC, impression share, rank-lost; answers "is it bid or Quality Score?"; bundles per-campaign budget-loss as `_campaign_budget_loss` since budget is a campaign property, not keyword; supports campaign_id/ad_group_id filters and days=7|14|30), `raw` (any GAQL SELECT). [Flattened action: status] Bulk support: accepts campaign_ids, ad_group_ids, customer_ids for batched execution.
google_ads_list_accountsFreeList all Google Ads MCCs and ALL customer accounts the OAuth token can access (via customers:listAccessibleCustomers — not just hierarchy of the MCC). Each customer comes enriched with descriptive_name, currency_code, time_zone, manager flag, status. Use the returned customer_id (10 digits) in `customer_id` on other tools, and `account` to pick the MCC connection when multiple are present. Bulk support: accepts customer_ids for batched execution.
google_ads_negative_keyword_addFreeAdd negative keywords at campaign or ad group scope. Pass scope + the matching target_id (campaign_id or ad_group_id). Bulk support: accepts target_ids, customer_ids for batched execution.
google_ads_performanceFreeDaily performance breakdown: cost, impressions, clicks, conversions, revenue per day. Bulk support: accepts customer_ids for batched execution.
google_ads_responsive_search_ad_createwrite actionFreeCreate a Responsive Search Ad (RSA) inside an ad group. Headlines: 3-15 entries (each <= 30 chars). Descriptions: 2-4 entries (each <= 90 chars). final_urls required. Default status PAUSED. Bulk support: accepts ad_group_ids, customer_ids for batched execution.
google_ads_roasFreeROAS for a date range (defaults to current month). Per-campaign cost, conversions, revenue, plus _summary. Bulk support: accepts customer_ids for batched execution.
google_ads_sitelink_createwrite actionFreeCreate sitelink extensions and attach them to a campaign (default), the whole account (scope=customer) or an ad group. A sitelink is a SitelinkAsset (its own link_text + final_url, optionally 2 description lines) linked to the scope — it is NOT the ad's display path (that is path1/path2 on the RSA). link_text <= 25 chars; if you set descriptions you must set BOTH (each <= 35 chars). Google needs at least ~2 sitelinks to actually show them. The created assets are shared in the account library. Bulk support: accepts target_ids, customer_ids for batched execution.
google_ads_sitelink_removewrite actionFreeDetach sitelinks from a campaign / account / ad group. Pass the link_resource_name(s) from google_ads_sitelinks. Removes only the association (the shared sitelink asset stays in the account library), so it is reversible by re-attaching. Bulk support: accepts customer_ids for batched execution.
google_ads_sitelinksFreeList sitelink assets in the account and where they are attached (campaign / account / ad group level), with each link's resource_name (pass it to google_ads_sitelink_remove) and status. Use to audit existing sitelinks before creating new ones. Bulk support: accepts customer_ids for batched execution.
google_ads_statusFreeWithout account: overview of all Google Ads MCCs and customer_ids. With account (and optional customer_id): details for that scope. Bulk support: accepts customer_ids for batched execution.
google_ads_todayFreeToday Google Ads performance: cost, impressions, clicks, conversions, ROAS per campaign plus _summary. Bulk support: accepts customer_ids for batched execution.
marketplaceFreeThe official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.
report_bugFreeReport a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
show_versionFreeShow the current MCP platform and adapter versions.
toolkit_infoFreeReturns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.
Public scan report
scanner v0.1.10 · 2026-11-01 · same rubric, same numbers if you re-run it
- –Code scanremote-only server, no package to scann/a
- Live reliabilityremote reachable in 10648ms; handshake note: MCP handshake timed out after 10000ms12/20
- –Tool poisoningtools not inspected (endpoint requires auth); not countedn/a
- Auth qualityopen endpoint, read-only tools10/15
- Maintenancelast push 63 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
How Google Ads compares
Against every graded Web search MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 72/100
- higher than 41% of 3,472 Web search servers
- Tools
- 35
- the typical Web search server has 5
- Tools that change things
- 34%
- typical: 0%. Fewer write tools means less an agent can break
- Uptime
- 100%
- of our recent checks; the typical remote Web search server answers 100%
- Response time
- 77 ms
- faster than 91% of 2,237 Web search servers
What its tools let an agent do: 22 read · 13 change
Install Google Ads in Claude Code, Cursor or VS Code
claude mcp add --transport http google_ads-mcp https://api.mcp.ai/p_google_ads
What the publisher says
From the Google Ads repository's README, as published. We do not edit it. Read it on GitHub
Google Ads
Google Ads para Claude, ChatGPT e agentes de IA
Gestão completa de Google Ads: leitura (campanhas, performance, ROAS, keywords, termos de busca) e escrita (pausar/ativar/remover campanhas, ad groups, ads e keywords, ajustar orçamento e lance, criar budget, campanha, ad group, keywords positivas/negativas e RSAs). Você fornece developer token, OAuth clientid/secret, refreshtoken e MCC, sem etapa OAuth no servidor.
- 📊 29 ferramentas
- ✏️ Leitura e escrita
- 💬 Funciona com qualquer cliente MCP: Claude Desktop, Cursor, VS Code, Cline, Continue
- 🔑 Login via magic-link (sem senha)
English version · Documentação completa · Skill pra agentes
Instalar em 1 clique
Claude (Web e Desktop)
A Anthropic unificou a instalação de MCPs em claude.ai/customize/connectors. O mesmo link serve pra Claude Web e Claude Desktop (basta estar logado):
➕ Abrir no Claude e conectar
Manual (se o deeplink não abrir): claude.ai/customize/connectors → + → Adicionar conector personalizado → cole Nome Google Ads e URL https://api.mcp.ai/pgoogleads.
Cursor
➕ Instalar Google Ads no Cursor
VS Code (Copilot Chat)
➕ Instalar Google Ads no VS Code
ChatGPT, Manus, OpenClaw e mais 40+ clientes
Funciona em qualquer cliente MCP que suporte MCP over HTTP. A URL do servidor é sempre:
https://api.mcp.ai/p_google_adsDetalhes por cliente: INSTALL.md.
Exemplos de uso
Liste minhas contas Google Ads acessíveis pela MCC
Quanto gastei hoje em Google Ads e qual o ROAS por campanha?
Top 10 palavras-chave por custo nos últimos 7 dias29 ferramentas disponíveis
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Google Ads: common questions
- Is Google Ads MCP server safe?
- Mostly: it is graded B (72/100). Read the Google Ads safety report
- How do I install Google Ads?
- It runs remotely at api.mcp.ai. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does Google Ads need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Google Ads maintained?
- The last commit was 64 days ago (2026-08-30). The latest release is v0.1.0.
- Is Google Ads up?
- 100% of our last 28 checks got an answer. We check remote servers about four times a day.
- What can I use instead of Google Ads?
- Servers from other publishers that do the same job: Pubmed MCP server, Google Maps MCP Server and SerpApi MCP server.
- How does Google Ads compare with other Web search MCP servers?
- safety score 72/100 (higher than 41% of 3,472 Web search servers); tools 35 (the typical Web search server has 5); tools that change things 34% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Google Ads
Same job from other publishers: the closest match first, then the best rated.
- PubmedSearch PubMed/Europe PMC, fetch articles and full text (PMC/EPMC/Unpaywall), citations, MeSH terms.not reviewedEstablishedA
- Google Maps MCP Server18 Google Maps tools for AI agents — geocode, search, directions, weather, and more.not reviewedEstablishedB
- SerpApiOfficial SerpApi MCP server for Google, Bing, and other search engines.not reviewedEstablishedA
HasData Google ScholarGoogle Scholar search results, citation counts and citation export formats, as structured JSON.not reviewedGrowingA- Google FlightsMCP server for searching Google Flights — flight search, date grid pricing, and airport lookup.not reviewedGrowingA