Get account health (`adsap_get_account_health`)

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

What it does

Runs a health check on a Meta ad account and returns a scorecard. It covers account status, payment health, Business Manager verification, pixel health, connected assets, ad volume limits, attribution consistency and Conversions API coverage. Use it as the foundation for an audit or a readiness check before launching.

When to use it

Use it at the start of an audit or before a launch, to check the account itself and not its campaigns.
It needs only the ad account ID with the act_ prefix. Get it from adsap_list_ad_accounts.
It runs eight checks: account status, payment, business verification, pixel, Conversions API coverage of the Purchase event, connected assets, ad volume and attribution windows.
Each check has a health of pass, warn or fail. One fail makes overall_health critical. One warn makes it warnings. Otherwise it is healthy.
It returns no spend or results. For those, use adsap_get_insights. For campaign and budget structure, use adsap_get_account_summary.

Worked example

You ask

“Is act_1234567890 healthy enough to launch on next week?”

The assistant calls `adsap_get_account_health`


{
  "ad_account_id": "act_1234567890"
}

Adsap returns

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


{
  "ad_account_id": "act_1234567890",
  "account_name": "Example Store",
  "overall_health": "warnings",
  "checks_failed": [],
  "account_status": {
    "status": "ACTIVE",
    "disable_reason": null,
    "health": "pass",
    "detail": "Account is active and in good standing."
  },
  "attribution_consistency": {
    "active_ad_set_count": 6,
    "attribution_windows": [
      { "window": "CLICK_THROUGH_7d + VIEW_THROUGH_1d", "count": 4 },
      { "window": "CLICK_THROUGH_1d", "count": 2 }
    ],
    "is_consistent": false,
    "health": "warn",
    "detail": "6 active ad sets use 2 different attribution windows. Cross-campaign ROAS comparison is unreliable."
  },
  "human_readable_summary": "Account is ACTIVE. Payment OK. BM: Example Store (verified). Pixel active. Purchase CAPI healthy. 42 ads running. Attribution windows inconsistent across ad sets. 2 page(s), 1 IG account(s), 1 pixel(s) connected."
}

How to read it

Start with overall_health, then open the checks whose health is not pass. Here the account can run ads, and the one warning is that active ad sets use two attribution windows. Each check also carries a detail sentence you can read as is. The other checks have the same shape under payment, business_verification, pixel_health, capi_health, connected_assets and ad_volume. This example shows two of the eight.

checks_failed lists any check that could not read its data from Meta. An empty list means every check ran.

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

“Is this ad account healthy enough to launch on?”
“Run a health check on account act_123456789.”
“Are there any payment or verification problems on my account?”

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_summary: Structural snapshot of a Meta ad account: campaign counts by status/objective, ad set counts, active ad count, budget allocation, top…
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 health (adsap_get_account_health)