google_ads_get_insights

Query Google Ads performance insights with intelligent query planning. One of 45 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	Sort direction for the selected ordering field. One of: `ASC`, `DESC`. Default: `"DESC"`.
`limit`	integer	Optional	Maximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. Default: `500`.

Calling itLink to this section

jsonDirectly, since it is announced

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