meta_get_insights

Meta performance. One of 59 Meta Ads tools on the Get MCP Ads MCP gateway.

Meta performance. For purchases, leads or conversion analysis request actions (and action_values for revenue), or explicit metrics such as purchases/omni_purchases/leads. The native conversions field is not a universal conversion total; its absence does not mean purchases or leads are unavailable. Label the exact action_type and never sum overlapping purchase types. Fields: meta://metrics, meta://dimensions, meta://breakdowns. Compatible query results are merged.

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	Meta account ID.
`level`	string	Required	Aggregation level: account, campaign, adset, or ad. One of: `account`, `campaign`, `adset`, `ad`.
`metrics`	array	Required	Keys from meta://metrics.
`dimensions`	array	Optional	meta://dimensions fields. Metadata is current.
`adsetIds`	array	Optional	Ad set IDs; adset/ad levels.
`effectiveStatus`	string	Optional	Effective delivery status at the selected level. One of: `ACTIVE`, `PAUSED`.
`breakdowns`	array	Optional	Keys from meta://breakdowns.
`actionBreakdowns`	array	Optional	Action dimensions, e.g. action_type. Action reports only.
`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	1=daily, 7=weekly, monthly or all_days.
`adIds`	array	Optional	Ad IDs; ad level only.
`campaignIds`	array	Optional	Campaign IDs; campaign/adset/ad levels.
`attributionMode`	string	Optional	Account/ad-set settings or explicit windows. Never inferred from values. One of: `account`, `adset`, `explicit`. Default: `"account"`.
`attributionWindows`	array	Optional	Required with explicit mode; identical across queries/totals.
`actionReportTime`	string	Optional	Date basis for actions. One of: `impression`, `conversion`, `mixed`. Default: `"impression"`.
`includeAccountTotals`	boolean	Optional	Native account totals with identical measurement; no entity filters, dimensions or breakdowns. Default: `false`.
`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": "meta_get_insights",
  "arguments": {
    "adAccountId": "<string>",
    "level": "account",
    "metrics": "<array>"
  }
}