# Google Ads — MCP server on mcp.ai
> Leitura de campanhas, performance, ROAS, keywords e termos de busca do Google Ads. 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=1781044980000
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 e nome da campanha
- google_ads_keywords(account?: string, customer_id?: string, action?: string, query?: string) — Analytics de keywords (últimos 7 dias), search terms 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

## 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