meta_ads_get_account_summary

Get Meta Ads Account Summary

Meta

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
FlagTypeRequiredDescription
--accountstringRequiredMeta ad account ID
--date-presetstringOptionalPredefined date range (e.g., last_7d, last_30d, this_month)
--time-rangeobjectOptionalCustom 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

NameTypeRequiredDescription
account_id string Required Meta ad account IDminLength: 1
reason string Required Why this tool call is neededminLength: 1, maxLength: 500
Optional parameters (2)
NameTypeRequiredDescription
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]