google ads run gaql
google_ads_run_gaqlRun raw Google Ads Query Language queries to retrieve custom reporting data for any account, enabling flexible analysis beyond preset reports.
Instructions
Execute a raw GAQL (Google Ads Query Language) query. Full flexibility for any reporting need. Example: SELECT campaign.name, metrics.impressions FROM campaign WHERE campaign.status = 'ENABLED' AND segments.date DURING LAST_30_DAYS ORDER BY metrics.impressions DESC LIMIT 100
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"customerId": "<customerId>",
"query": "<query>"
},
"name": "google_ads_run_gaql"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | GAQL query string (SELECT ... FROM ... WHERE ...) | |
| customerId | Yes | Google Ads customer ID (without dashes, e.g., 1234567890) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | Original tool result: parsed JSON when the text is JSON, otherwise the text or multiple MCP content blocks. Provider fields depend on the selected query. |