google_ads-mcp

Google Ads — REST API skill

Você tem acesso à Google Ads REST API na 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.

Base URL

https://api.mcp.ai/api/google_ads

Todo endpoint é um POST na Base URL + o path abaixo. Os parâmetros vão no corpo JSON.

Autenticação

Inclua em toda request:

Authorization: Bearer sk_live_...
Content-Type: application/json

Gere sua chave em https://app.mcp.ai/settings/api-keys (workspace API key sk_live_…, não expira, revogável). Uma única chave serve pra todos os seus MCPs.

Formato de resposta

{ "ok": true, "tool": "<tool_id>", "result": <payload> }

Exemplo cURL

curl -X POST https://api.mcp.ai/api/google_ads/accounts \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{}'

Reportar problemas

Se um endpoint retornar erro, vazio ou dado inesperado, reporte (não desista calado): POST /api/google_ads/report com { "message": "...", "context"?: "...", "conversation"?: [...] }. Isso notifica o time da MCP.AI.

Endpoints (25)

google_ads_list_accounts

Listar MCCs e TODOS os customer accounts acessíveis pelo OAuth token (POST /api/google_ads/accounts)

google_ads_status

Overview de MCCs e customer_ids (sem account). (POST /api/google_ads/status)

Parâmetro	Tipo	Obrigatório	Descrição
account	string	Não	MCC: mcc_id ou label da conexão (multi-MCC). Omita se houver apenas uma.
customer_id	string	Não	Customer ID (10 dígitos, hífens opcionais). Default = primeiro customer / MCC.

google_ads_account

Info do customer: nome, moeda, timezone (POST /api/google_ads/customers/info)