# Google Ads — MCP server on mcp.ai
> 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 client_id/secret, refresh_token e MCC, sem etapa OAuth no servidor.

By: mcp.ai · official
Page: https://mcp.ai/google_ads

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_google_ads?ms=1788956820000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/google_ads/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/google_ads/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/google_ads/skill.md
Postman collection (v2.1): https://mcp.ai/google_ads/postman.json

## Tools
- google_ads_list_accounts() — Listar MCCs e TODOS os customer accounts acessíveis pelo OAuth token
- google_ads_status(account?: string, customer_id?: string) — Overview de MCCs e customer_ids (sem account). Detalhes do escopo (com account).
- google_ads_account(account?: string, customer_id?: string) — Info do customer: nome, moeda, timezone
- google_ads_campaigns(account?: string, customer_id?: string, status?: string) — Listar campanhas com status e orçamentos
- google_ads_today(account?: string, customer_id?: string) — Performance de hoje: custo, impressões, cliques, conversões, ROAS por campanha + _summary
- google_ads_roas(account?: string, customer_id?: string, since?: string, until?: string) — ROAS por período (default mês corrente). Por campanha + _summary.
- google_ads_ads(account?: string, customer_id?: string) — Listar ads habilitados com tipo, status, nome da campanha e policy_summary (approval/review status)
- google_ads_keywords(account?: string, customer_id?: string, action?: string, query?: string, campaign_id?: string, ad_group_id?: string, days?: number) — Keywords: métricas, search terms, status/policy (action=status), diagnóstico de leilão / Quality Score (action=diagnostics) ou GAQL raw
- google_ads_changes(account?: string, customer_id?: string, since?: string, until?: string, days?: number, limit?: number) — Histórico de alterações (quem mudou o quê): campanhas, anúncios, lances, URLs, headlines, keywords, orçamentos
- google_ads_performance(account?: string, customer_id?: string, days?: number) — Performance diária: custo, impressões, cliques, conversões, revenue por dia
- google_ads_campaign_update_status(account?: string, customer_id?: string, campaign_ids: array, status: string, partial_failure?: boolean) — Pausar, ativar ou remover campanhas (REMOVED é irreversível)
- google_ads_campaign_update_budget(account?: string, customer_id?: string, campaign_id: string, amount: number) — Ajustar o orçamento diário de uma campanha (na unidade da moeda da conta)
- google_ads_ad_group_update_status(account?: string, customer_id?: string, ad_group_ids: array, status: string, partial_failure?: boolean) — Pausar, ativar ou remover ad groups
- google_ads_ad_update_status(account?: string, customer_id?: string, ads: array, status: string, partial_failure?: boolean) — Pausar, ativar ou remover anúncios (precisa de ad_group_id + ad_id)
- google_ads_keyword_update_status(account?: string, customer_id?: string, keywords: array, status: string, partial_failure?: boolean) — Pausar, ativar ou remover keywords (precisa de ad_group_id + criterion_id)
- google_ads_keyword_update_bid(account?: string, customer_id?: string, keywords: array, cpc_bid: number, partial_failure?: boolean) — Ajustar max CPC de keywords (na unidade da moeda da conta)
- google_ads_campaign_budget_create(account?: string, customer_id?: string, name: string, amount: number, delivery_method?: string) — Criar um campaign_budget (pré-requisito de toda campanha)
- google_ads_campaign_create(account?: string, customer_id?: string, name: string, budget_id: string, channel_type?: string, bidding_strategy?: string, status?: string, merchant_id?: string, feed_label?: string, campaign_priority?: number) — Criar uma campanha (default SEARCH, PAUSED, MANUAL_CPC). budget_id obrigatório.
- google_ads_ad_group_create(account?: string, customer_id?: string, campaign_id: string, name: string, type?: string, status?: string, cpc_bid?: number) — Criar um ad group dentro de uma campanha
- google_ads_keyword_add(account?: string, customer_id?: string, ad_group_id: string, keywords: array, status?: string, partial_failure?: boolean) — Adicionar keywords positivas a um ad group
- google_ads_negative_keyword_add(account?: string, customer_id?: string, scope: string, target_id: string, keywords: array, partial_failure?: boolean) — Adicionar keywords negativas (campaign ou ad group)
- google_ads_responsive_search_ad_create(account?: string, customer_id?: string, ad_group_id: string, headlines: array, descriptions: array, final_urls: array, path1?: string, path2?: string, status?: string) — Criar um Responsive Search Ad (RSA) num ad group
- google_ads_sitelinks(account?: string, customer_id?: string) — Listar sitelinks e onde estão linkados (campanha / conta / ad group)
- google_ads_sitelink_create(account?: string, customer_id?: string, scope?: string, target_id?: string, sitelinks: array, partial_failure?: boolean) — Criar sitelinks e linkar numa campanha (default), na conta ou num ad group
- google_ads_sitelink_remove(account?: string, customer_id?: string, link_resource_names: array, partial_failure?: boolean) — Desligar sitelinks (remove só a associação; o asset fica na biblioteca)

## Example prompts
- "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 dias"

## Links
Docs: https://mcp.ai/docs/mcps/google_ads
Website: https://mcp.ai/mcps/google_ads