meta_get_insights

Query Meta Ads performance insights. One of 39 Meta Ads tools on the Get MCP Ads MCP gateway.

Query Meta Ads performance insights. Supports 170+ metrics, 43+ breakdowns with intelligent query planning. Use meta://metrics resource to see available metrics. Use meta://breakdowns for available breakdowns. The query planner automatically splits incompatible metric/breakdown combinations into multiple API requests and merges results.

Source: Meta Ads
Kind: Read
Discovery: Announced in the tool list
Account parameter: adAccountId
Endpoint: https://mcp.getmcpads.com/meta-ads/mcp

ParametersLink to this section

Name	Type	Required	Notes
`adAccountId`	string	Required	Ad account ID (e.g., act_123456789)
`level`	string	Required	Aggregation level: account, campaign, adset, or ad. One of: `account`, `campaign`, `adset`, `ad`.
`metrics`	array	Required	Metric keys from meta://metrics (e.g., impressions, spend, ctr)
`breakdowns`	array	Optional	Breakdown keys from meta://breakdowns (e.g., age, gender, country)
`datePreset`	string	Optional	Predefined date range (e.g., last_7d, last_30d) One of: `today`, `yesterday`, `this_month`, `last_month`, `this_quarter`, `maximum`, `data_maximum`, `last_3d`, `last_7d`, `last_14d`, `last_28d`, `last_30d`, `last_90d`, `last_week_mon_sun`, `last_week_sun_sat`, `last_quarter`, `last_year`, `this_week_mon_today`, `this_week_sun_today`, `this_year`.
`timeRange`	object	Optional	Custom date range with since/until in YYYY-MM-DD format.
`timeIncrement`	unknown	Optional	Time granularity: 1 (daily), 7 (weekly), 'monthly', or 'all_days'.
`limit`	integer	Optional	Default: `500`.

Calling itLink to this section

jsonDirectly, since it is announced

{
  "name": "meta_get_insights",
  "arguments": {
    "adAccountId": "<string>",
    "level": "account",
    "metrics": "<array>"
  }
}