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 ad-linked creative media with actual ad names, collection covers, all carousel/flexible components, resolved image hashes and video URLs. Catalog-only ads are classified separately; use the hosted GetMCPAds service for an interactive visual gallery. Raw creative metadata remains available for diagnostics.

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.

Read Facebook Page posts and Instagram media with URLs, native periods and optional insights. These are content insights, not Ads Insights; do not infer an organic-only breakdown.

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.

Read published Facebook Page posts using a Page token resolved from the connected user. Returns exact PageID_PostID, message, permalink and media attachments. Use postId for an exact existing-post ad preflight. No Instagram media, comments, likes or insights are requested; this read alone does not establish advertising eligibility.

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.

List the ad account image library (/adimages): hash, name, dimensions, status, a permanent publicly served display URL (permalink_url), short-lived CDN URLs, and optionally the creatives using each image.

List the ad account video library (/advideos): title, duration, processing status, and publicly served thumbnails (preferred and largest sizes). Source file URLs are returned only on request because they expire quickly.

Resolve fresh download URLs (source) and thumbnails for specific ad videos. Call this at download time: the returned URLs are signed and expire quickly.

Read a specific entity in its ad account for reconciliation. Read-only; never creates, changes or retries the entity. Missing or normalized fields must be inspected before claiming an exact match.

Check video processing and membership in the selected account library. If the first page misses the ID, use the video title to narrow the account-scoped lookup. A direct video read alone never proves membership or readiness. Bounded pagination; not_found is not success.

Read an existing ad set, its parent campaign budget/objective and account currency before preparing an edit. Returns native settings; no mutation.

Read the completion and per-item errors for a catalog batch handle. Acceptance of a batch is not proof that every product succeeded.