meta_ads_get_account_summary
Get Meta Ads Account Summary
Description
Standardized account-level performance summary for cross-platform comparison. Normalized format identical to google_ads_get_account_summary. Includes conversion_detail breakdown from both Meta actions and conversions arrays. Preferred over get_insights or get_performance_report for quick account-level overviews. Always fetches fresh data.
Read-onlyIdempotent
Usage
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "meta_ads_get_account_summary",
"arguments": {
"account_id": "act_123",
"reason": "Quick performance overview"
}
}
}
hopkin meta account-summary get
| Flag | Type | Required | Description |
|---|---|---|---|
--account | string | Required | Meta ad account ID |
--date-preset | string | Optional | Predefined date range (e.g., last_7d, last_30d, this_month) |
--time-range | object | Optional | Custom date range {since, until} in YYYY-MM-DD |
{
"mcpServers": {
"meta-ads": {
"url": "https://mcp.hopkin.ai/meta-ads/mcp",
"transport": "sse"
}
}
}
- Last 30 days summary
- Last 7 days
- Custom date range
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
account_id |
string |
Required | Meta ad account IDminLength: 1 |
reason |
string |
Required | Why this tool call is neededminLength: 1, maxLength: 500 |
Optional parameters (2)
| Name | Type | Required | Description |
|---|---|---|---|
date_preset |
string |
Optional | Predefined date range (e.g., last_7d, last_30d, this_month)today yesterday this_week_mon_today this_week_sun_today last_week_mon_sun last_week_sun_sat this_month last_month this_quarter last_quarter this_year last_year last_3d last_7d last_14d last_28d last_30d last_90d lifetime maximum |
time_range |
object |
Optional | Custom date range {since, until} in YYYY-MM-DD |
Examples
Last 30 days summary
{
"account_id": "act_123",
"reason": "Quick performance overview"
}
hopkin meta account-summary get --account act_123
Last 7 days
{
"account_id": "act_123",
"date_preset": "last_7d",
"reason": "Weekly check-in"
}
hopkin meta account-summary get --account act_123 --date-preset last_7d
Custom date range
{
"account_id": "act_123",
"time_range": {
"since": "2026-01-01",
"until": "2026-01-31"
},
"reason": "January performance review"
}
hopkin meta account-summary get --account act_123 --time-range [object Object]