Skip to main content

​
What this tool family is for

The Meta analytics lane is built for questions like:
  • Which campaigns are working right now?
  • Which creatives are doing the heavy lifting?
  • Which ad sets deserve more attention?
  • What patterns keep showing up in the winners?
All of these tools carry the meta_ads_ prefix. They wrap Meta’s Marketing API with organization scoping, server-side attribution policy, and currency-aware reporting. If you’re coming from Meta’s official Ads MCP, see Meta MCP parity for the field and behavior differences.

​
Core tools

meta_ads_get_ad_accounts

List the ad accounts linked to your active brand, with reporting currency.

meta_ads_get_metadata

Read entity attributes — name, objective, budget, schedule, status — for campaigns, ad sets, ads, and creatives.

meta_ads_get_insights

Pull performance metrics (spend, CPC, CPM, CTR, conversions, ROAS, and more) over a date range, at any level.

meta_ads_insights_performance_trend

Track a metric over time to spot momentum and inflection points.
meta_ads_get_metadata and meta_ads_get_insights are the two you reach for most: one answers what is this entity, the other answers how is it doing. Attribution is handled for you — set a per-account window once with meta_ads_set_attribution_mode and every insights call applies it.

​
Named briefs

Five tools package a common analyst task into one call. The model picks them based on your question — you don’t have to name them — and they return a rendered summary you can read at a glance. They work in both Foxley and the MCP suite.
ToolAnswers
meta_brief_pacing_riskWhich live campaigns need attention this week?
meta_brief_allocationWhere should an incremental budget go?
meta_brief_preflightIs this campaign safe to launch?
meta_brief_discrepancyCan I trust these conversion numbers?
meta_brief_weekly_summaryWhat are the top insights this week?
Run a pacing and risk check on this ad account and flag anything off track.

I have $5,000 more to spend this week — where should it go?

​
Typical questions to ask

Show me the top-performing creatives in this ad account over the last 14 days.

Which campaigns have the strongest CTR but weak conversion efficiency?

Compare the best and worst ad sets in this campaign and tell me what the loser should steal from the winner.

​
The real advantage

The point is not generic dashboard replacement. The point is to combine analytics with Outfox context:
  • brand voice
  • inspiration patterns
  • briefs
  • creative history
That is where the conversation becomes strategy instead of reporting.

​
Best combined workflow

  1. Pull top-performing creatives with meta_ads_get_insights
  2. Search inspiration for similar patterns
  3. Generate a new brief for the next test
  4. Ask the model to explain the analytics reason behind that recommendation
Use this page as the conceptual reference for the Meta analytics lane of the suite. For setup, start with Quickstart. For the per-tool inputs and outputs, see the Meta analytics reference.