google_ads_get_insights

Query Google Ads performance insights with intelligent query planning. One of 38 Google Ads tools on the Get MCP Ads MCP gateway.

Query Google Ads performance insights with intelligent query planning. Auto-generates GAQL, handles metric/segment incompatibilities by splitting queries. Use google-ads://metrics for available metrics, google-ads://dimensions for dimensions.

Source: Google Ads
Kind: Read
Discovery: Announced in the tool list
Account parameter: customerId
Endpoint: https://mcp.getmcpads.com/google-ads/mcp

ParametersLink to this section

Name	Type	Required	Notes
`customerId`	string	Required	Google Ads customer ID (without dashes, e.g., 1234567890)
`resource`	string	Optional	GAQL FROM clause resource type (campaign, ad_group, ad_group_ad, keyword_view, shopping_performance_view, asset_group, geographic_view, video, search_term_view, landing_page_view, etc.) Default: `"campaign"`.
`metrics`	array	Required	Metric keys (e.g., impressions, clicks, cost_micros, conversions)
`dimensions`	array	Optional	Dimension keys (e.g., date, campaignName, device)
`startDate`	string	Optional	Start date YYYY-MM-DD.
`endDate`	string	Optional	End date YYYY-MM-DD.
`datePreset`	string	Optional	Predefined date range. One of: `TODAY`, `YESTERDAY`, `LAST_7_DAYS`, `LAST_14_DAYS`, `LAST_30_DAYS`, `LAST_90_DAYS`, `THIS_MONTH`, `LAST_MONTH`, `THIS_QUARTER`, `LAST_QUARTER`.
`orderBy`	string	Optional	Optional GAQL field to order by, e.g. metrics.impressions or campaign.name.
`orderDirection`	string	Optional	One of: `ASC`, `DESC`. Default: `"DESC"`.
`limit`	integer	Optional	Default: `500`.

Calling itLink to this section

jsonDirectly, since it is announced

{
  "name": "google_ads_get_insights",
  "arguments": {
    "customerId": "<string>",
    "metrics": "<array>"
  }
}