Agent-ready read-only health check: validates token metadata, lists accessible ad accounts, and warns about missing read scopes without exposing the access token.

Discover accessible Meta Business assets read-only: businesses, pages, Instagram accounts, pixels, and datasets when permissions allow.

List accessible Facebook Pages with id, name, category, tasks, picture, and linked Instagram account references when available.

List Instagram accounts linked to accessible Pages, Business Manager assets, or an ad account when permissions allow.

List pixels and datasets from an ad account or Business Manager when accessible, returning actionable warnings for permission-limited edges.

Read ad account activity logs from /{ad_account_id}/activities with object, event, actor, timestamp, and extra_data fields.

Aggregate read-only delivery diagnostics across campaigns, ad sets, and ads using status/effective_status/issues_info where available plus simple delivery insights.

Return normalized creative asset metadata for ads or creative IDs: thumbnail, object_story_spec, asset_feed_spec, video/image/link URL, CTA, and page/IG references.

Read detailed custom, saved, and lookalike audiences with pagination and rich fields where permissions allow.

Read Product Catalogs and Product Items when catalog access is available. Returns join-ready product metadata without creating or updating catalog assets.

Query product-breakdown insights and enrich rows with Product Catalog metadata when catalog access is available.

Read brand safety, suitability, placement, and context-control signals from ad account/ad set targeting and optional block-list edges.

Read and interpret A/B test or conversion lift study results with confidence guardrails, cells, objectives, and optional cell entities.

Enrich Facebook Page posts and Instagram organic media with media URLs, permalinks, counts, attachments, and optional read-only insights.

List all Meta ad accounts accessible with the current token. Returns account ID, name, currency, timezone, and status.

Get detailed information for a specific Meta ad account: name, currency, timezone, spend cap, status, business info.

List campaigns for a Meta ad account. Returns campaign ID, name, status, objective, budget, and bid strategy.

List ad sets for a Meta ad account, optionally filtered by campaign. Returns targeting, budget, optimization, and schedule info.

List ads for a Meta ad account, optionally filtered by ad set. Returns ad ID, name, status, and creative reference.

Query Meta Ads performance insights. Supports 170+ metrics, 43+ breakdowns with intelligent query planning. Use meta://metrics resource to see available metrics. Use meta://breakdowns for available breakdowns. The query planner automatically splits incompatible metric/breakdown combinations into multiple API requests and merges results.

Get hierarchical campaign structure: campaigns -> ad sets -> ads. Useful for understanding account organization.

Get ad creative content: text, images, videos, links, call-to-action. Returns creative details for specified ads.

List custom, saved, and lookalike audiences for a Meta ad account.

List conversion lift studies and A/B tests (Ad Studies) for an ad account. Includes study type, status, and cells.

Get detailed results for a conversion lift or A/B test study. Returns objectives, cells, and lift results.

Validate a metric/breakdown combination BEFORE executing. Returns errors and warnings. Use this to check if your query will work.

Get recent posts from a connected Facebook/Instagram page. Requires page access.

Check the current access token validity, expiration, and granted scopes. Useful for diagnosing auth issues.

Search campaigns, ad sets, or ads by name within an ad account. Useful for finding specific entities.

Read arbitrary flat fields from one Meta Graph node. This GET-only escape hatch covers newly released campaign, ad set, ad, creative, audience, catalog, Page, Instagram, pixel, and other accessible node fields without waiting for a fixed MCP schema update.

List an allowlisted read-only Meta Graph edge with caller-selected flat fields, filters, and cursor pagination. Use this for broad metadata/entity discovery when a specialized tool does not expose a newly added field.

Query the Meta Insights edge with validated native field names, breakdowns, action breakdowns, attribution windows, filters, sort, summary, and pagination. This complements meta_get_insights when Meta adds fields before the curated metric catalog is updated.

Search Meta's read-only targeting metadata for interests, validated interests, geographies, locales, countries, cities, regions, markets, or postal codes.

Get the read-only preview markup for an existing Meta ad in a requested placement format. The response may contain an iframe body but never creates or edits a creative.