# Google Ads — how to use (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.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_google_ads?ms=1781044860000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `google_ads_list_accounts`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/google_ads`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/google_ads/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/google_ads/accounts` — Listar MCCs e TODOS os customer accounts acessíveis pelo OAuth token
- `POST https://api.mcp.ai/api/google_ads/status` — Overview de MCCs e customer_ids (sem account). Detalhes do escopo (com account).
  - body: { account?: string, customer_id?: string }
- `POST https://api.mcp.ai/api/google_ads/customers/info` — Info do customer: nome, moeda, timezone
  - body: { account?: string, customer_id?: string }
- `POST https://api.mcp.ai/api/google_ads/customers/campaigns` — Listar campanhas com status e orçamentos
  - body: { account?: string, customer_id?: string, status?: string }
- `POST https://api.mcp.ai/api/google_ads/customers/today` — Performance de hoje: custo, impressões, cliques, conversões, ROAS por campanha + _summary
  - body: { account?: string, customer_id?: string }
- `POST https://api.mcp.ai/api/google_ads/customers/roas` — ROAS por período (default mês corrente). Por campanha + _summary.
  - body: { account?: string, customer_id?: string, since?: string, until?: string }
- `POST https://api.mcp.ai/api/google_ads/customers/ads` — Listar ads habilitados com tipo, status e nome da campanha
  - body: { account?: string, customer_id?: string }
- `POST https://api.mcp.ai/api/google_ads/customers/keywords` — Analytics de keywords (últimos 7 dias), search terms ou GAQL raw
  - body: { account?: string, customer_id?: string, action?: string, query?: string }
- `POST https://api.mcp.ai/api/google_ads/customers/changes` — Histórico de alterações (quem mudou o quê): campanhas, anúncios, lances, URLs, headlines, keywords, orçamentos
  - body: { account?: string, customer_id?: string, since?: string, until?: string, days?: number, limit?: number }
- `POST https://api.mcp.ai/api/google_ads/customers/performance` — Performance diária: custo, impressões, cliques, conversões, revenue por dia
  - body: { account?: string, customer_id?: string, days?: number }

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

## More
- Page: https://mcp.ai/google_ads
- Agent spec (llms.txt): https://mcp.ai/google_ads/llms.txt
- Postman collection: https://mcp.ai/google_ads/postman.json