Get account summary (`adsap_get_account_summary`)

Platform: Meta · Read or write: Read · Plan: All plans · Consumes a task: No · Preview supported: No

What it does

Gives a structural snapshot of a Meta ad account. It covers campaign counts by status and objective, ad set counts, active ad count and budget allocation. It also lists the top spending campaigns of the last 30 days and counts any disapproved ads. Use it to see the big picture before a detailed audit.

When to use it

Use it first in an audit, to see how many campaigns, ad sets and ads exist and where the budget sits.
It takes the ad account ID and nothing else. The tool takes no date parameter: spend figures always cover the last 30 days.
top_campaigns holds up to ten campaigns, ranked by 30-day spend, with purchases and ROAS.
Disapproved, pending and problem ads come back as counts only. To see which ads they are, use adsap_get_ad_review_status.
For another date range, or for metrics by ad set or ad, use adsap_get_insights.

Worked example

You ask

“Give me the big picture of act_1234567890 before we audit it.”

The assistant calls `adsap_get_account_summary`


{
  "ad_account_id": "act_1234567890"
}

Adsap returns

The field names are the ones Adsap returns. The values are examples.


{
  "ad_account_id": "act_1234567890",
  "currency": "USD",
  "campaigns": {
    "total": 8,
    "by_status": { "ACTIVE": 3, "PAUSED": 5 },
    "by_objective": { "OUTCOME_SALES": 6, "OUTCOME_TRAFFIC": 2 },
    "active_with_cbo": 2
  },
  "ads": {
    "total_active": 24,
    "total_paused": 61,
    "disapproved": 0,
    "pending_review": 2,
    "with_issues": 0
  },
  "top_campaigns": [
    {
      "campaign_id": "120210000000002",
      "name": "Spring sale",
      "spend_30d": 6420.25,
      "pct_of_total_spend": 50,
      "conversions": 214,
      "roas": 3.12
    }
  ],
  "budget_concentration": 86.4,
  "warnings": ["2 ad(s) pending review"]
}

How to read it

campaigns counts by the status you set, and active_with_cbo counts active campaigns that hold their budget at campaign level. ads counts by what Meta does with each ad. budget_concentration is the share of 30-day spend that went to the top three campaigns, as a percentage. In top_campaigns, conversions counts purchases only. warnings lists what needs a look. Here two ads wait for review.

This example leaves out three parts of the payload. ad_sets holds total_active, total_configured_active and total_daily_budget, the sum of daily budgets under active campaigns. spend_30d holds total, total_impressions and average_cpm. human_readable_summary is a one-paragraph recap. Each entry in top_campaigns also carries objective, status and impressions.

Parameters

Descriptions are shortened from the tool schema. Your assistant sees the full text.

Name	Type	Required	Description
`ad_account_id`	string	Yes	Must include act_ prefix.

Example prompts

“Give me an overview of this ad account.”
“How many campaigns are active, and where is the budget going?”
“Which campaigns spent the most in the last 30 days?”

Notes

The summary takes no date parameter and always covers a fixed last-30-day window. Ask for insights instead when you need a specific period.

adsap_get_account_activities: Retrieve change log for a Meta ad account: budget changes, status toggles, ad creation/deletion, billing events, policy actions.
adsap_get_account_health: Full health check on a Meta ad account.
adsap_get_insights: Retrieve aggregated spend and performance metrics for accounts, campaigns, ad sets, or ads over a date range.
adsap_get_insights_breakdown: Live Meta API call: get spend and performance metrics sliced by demographic or placement dimensions (age, gender, platform, country).
adsap_list_experiments: List an ad account’s Meta experiments / ad studies (live from Meta): A/B split tests and conversion-lift studies, with type, status…

Guide

Read Insights and reporting for the workflow around this tool, and the Tool reference for every tool.

The Meta Ads MCP server page shows how to connect Meta Ads to Claude, ChatGPT or Perplexity.

Get account summary (adsap_get_account_summary)