Meta Ads insights

Ad account ID

Meta account IDRequired · adAccountId

Level

Aggregation level: account, campaign, adset, or ad (account, campaign, adset or ad)Required · level

Metrics

Keys from meta://metricsRequired · metrics

Dimensions

Meta://dimensions fieldsOptional · dimensions

Adset IDs

Ad set IDs; adset/ad levelsOptional · adsetIds

Effective status

Effective delivery status at the selected level (ACTIVE or PAUSED)Optional · effectiveStatus

Breakdowns

Keys from meta://breakdownsOptional · breakdowns

Action breakdowns

Action dimensions, e.g. action_typeOptional · actionBreakdowns

Date preset

Predefined date range (e.g., last_7d, last_30d)Optional · datePreset

Time range

Custom date range with since/until in YYYY-MM-DD formatOptional · timeRange

Time increment

1=daily, 7=weekly, monthly or all_daysOptional · timeIncrement

Ad IDs

Ad IDs; ad level onlyOptional · adIds

Campaign IDs

Campaign IDs; campaign/adset/ad levelsOptional · campaignIds

Attribution mode

Account/ad-set settings or explicit windows (account, adset or explicit)Optional · attributionMode

Attribution windows

Required with explicit mode; identical across queries/totalsOptional · attributionWindows

Action report time

Date basis for actions (impression, conversion or mixed)Optional · actionReportTime

Include account totals

Native account totals with identical measurement; no entity filters, dimensions or breakdownsOptional · includeAccountTotals

Limit

Maximum number of returned items or rowsOptional · limit

Workspace ID

Authorized workspace ID from list_accounts/list_workspacesOptional · workspace_id

Price

$0.005 per call

Billing

The provider’s price, with no markup. Billed for measured usage.

Your agent reads the schema and the price with inspect_tool before it runs the tool.

MCP call

Copy

cURL command

Copy

TypeScript

Copy

Tool ID

Copy

• Meta ad activityMeta Ads$0.005
• Meta ad set configurationMeta Ads$0.005
• Meta ad setsMeta Ads$0.005
• Meta ad studiesMeta Ads$0.005
• Meta adsMeta Ads$0.005
• Meta Ads account detailsMeta Ads$0.005
• Meta Ads brand safety controlsMeta Ads$0.005
• Meta Ads campaign structureMeta Ads$0.005
• Compare all 18

• Weekly marketing reportLast week against the week before from your own GA4, Search Console, Google Ads and Meta Ads accounts, in one report with the three things to act on.
• Meta creative refreshWhich of your Meta ads are tiring (frequency up, click rate down), what your best ad says, fresh angles from long-running ads in your category, and four new variations.