meta_ads_ (or meta_brief_) prefix and is scoped to the brands and ad accounts your organization can access. For how these compare to Meta’s official Ads MCP, see Meta MCP parity.
Discovery
meta_ads_get_ad_accounts
Use it to list the ad accounts linked to your active brand. Each row includes the account’s reporting currency, so monetary metrics label correctly.
Entities and performance
meta_ads_get_metadata
Use it to read entity attributes — name, objective, budget, schedule, status — for a campaign, ad set, ad, or creative. This is the “what is this thing” tool.
meta_ads_get_insights
Use it to evaluate performance over a date range, at the campaign, ad set, or ad level.
Typical metrics:
- impressions
- clicks
- spend
- CTR
- CPC
- CPM
- conversions
- ROAS
meta_ads_insights_performance_trend
Use it to follow a single metric over time when you want to see momentum rather than a point-in-time total.
Attribution
meta_ads_set_attribution_mode
Set the ad account’s attribution mode (default or custom) and optionally pin a window. In custom mode, insights calls apply that window consistently across ad sets.
meta_ads_audit_attribution
Scan an account’s recent ad sets and report which use non-standard attribution windows, so you know whether the numbers are comparable.
Named briefs
Each brief is a single-call orchestration over the tools above. The model selects them from your question; all five return a rendered summary plus the underlying signals. They’re available in both Foxley and the MCP suite.| Tool | What it returns |
|---|---|
meta_brief_pacing_risk | Every active campaign with a pacing percentage and an at-risk / overdelivering / on-track badge. Input: ad_account_id. |
meta_brief_allocation | A budget split across ad sets, badged recommend / steady / saturating. Inputs: ad_account_id, amount_usd. |
meta_brief_preflight | A launch checklist (naming, attribution, pixel health, delivery) with pass / fix / review per item. Inputs: ad_account_id, campaign_id. |
meta_brief_discrepancy | Each connected dataset with its quality score and a severity badge. Input: ad_account_id. |
meta_brief_weekly_summary | The three biggest insights of the week for a client report. Input: ad_account_id. |
ad_account_id accepts either the numeric ID or the act_-prefixed form.
Best workflow
meta_ads_get_ad_accountsmeta_ads_get_insightsmeta_ads_get_metadataon the entities worth a closer look- compare the winners to inspiration results
- generate the next brief
The Meta analytics lane is the performance side of the broader Outfox MCP
suite. Use it together with the inspiration tools for the strongest results.