# meta_get_insights

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

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources) / [Meta Ads](https://www.getmcpads.com/docs/sources/meta-ads)

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](https://www.getmcpads.com/docs/sources/meta-ads) |
| Kind | Read |
| Discovery | Announced in the tool list |
| Account parameter | `adAccountId` |
| Endpoint | https://mcp.getmcpads.com/meta-ads/mcp |

## Parameters

| 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 it

Directly, since it is announced

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

- [Meta Ads metrics](https://www.getmcpads.com/docs/sources/meta-ads/metrics): What you can ask for.
- [Meta Ads dimensions](https://www.getmcpads.com/docs/sources/meta-ads/dimensions): How you can break it down.

---

This page as HTML: https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_get_insights
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.