meta_join_product_insights

Query product-breakdown insights and enrich rows with Product Catalog metadata when catalog access is available.

Source: Meta Ads
Kind: Read
Discovery: Reachable through search_tools and run_tool
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.
`catalogId`	string	Optional	Product Catalog ID used to load product metadata for joins.
`productBreakdown`	string	Optional	Native product grouping used to join catalog items with reported insights. One of: `product_id`, `product_brand_breakdown`, `product_category_breakdown`, `product_type_breakdown`, `product_custom_label_0_breakdown`, `product_custom_label_1_breakdown`, `product_custom_label_2_breakdown`, `product_custom_label_3_breakdown`, `product_custom_label_4_breakdown`, `product_group_content_id_breakdown`. Default: `"product_id"`.
`metrics`	array	Optional	Native or documented calculated metric names to request. Check compatibility with the selected dimensions. Default: `["impressions","clicks","spend","actions","action_values"]`.
`level`	string	Optional	Entity or aggregation level for the requested report. One of: `account`, `campaign`, `adset`, `ad`. Default: `"ad"`.
`datePreset`	string	Optional	Insights date preset. Defaults to 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	Optional custom insights date range.
`limit`	integer	Optional	Maximum number of returned items or rows. The declared bounds and default apply; use pagination for additional results. Default: `500`.
`catalogProductLimit`	integer	Optional	Maximum catalog product records read for the join. Default: `500`.

Calling itLink to this section

jsonThrough run_tool, since it is not announced

{
  "name": "run_tool",
  "arguments": {
    "name": "meta_join_product_insights",
    "args": {
      "adAccountId": "<string>"
    }
  }
}