Meta AdsMCP Server

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.

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.

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.

List ads for a Meta ad account, optionally filtered by ad set.

Query Meta Ads performance insights. Supports 170+ metrics, 43+ breakdowns with intelligent query planning. Use meta://metrics resource to see available metrics. Use.

Get hierarchical campaign structure: campaigns -> ad sets -> ads.

Get ad creative content: text, images, videos, links, call-to-action.

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.

Get detailed results for a conversion lift or A/B test study.

Validate a metric/breakdown combination BEFORE executing.

Get recent posts from a connected Facebook/Instagram page.

Check the current access token validity, expiration, and granted scopes.

Search campaigns, ad sets, or ads by name within an ad account.

List the ad account image library with hashes, dimensions, permanent display URLs, and creative usage.

List the ad account video library with titles, durations, statuses, and publicly served thumbnails.

Resolve fresh short-lived download URLs and thumbnails for specific ad videos at download time.

Pause or reactivate a Meta campaign.

Pause or reactivate a Meta ad set.

Pause or reactivate a single Meta ad.

Change an ad set's daily or lifetime budget, in the account currency.

Create a Meta campaign. Always created PAUSED, with no option to create it active.

Rename a Meta ad. The name is the only thing that changes.

Rename a Meta ad set. The name is the only thing that changes.

Rename a Meta campaign. The name is the only thing that changes.

Read an existing ad set and its parent budget/currency before preparing an edit.

Read the completion and per-item errors for a catalog batch handle.

Create a PAUSED Meta ad set with explicit targeting, optimization, placements, attribution, bidding and schedule.

Update targeting, optimization, placements, attribution, bidding, budget or schedule.

Duplicate a known-good ad set within the selected account, preserving complex native configuration.

Create an ad creative from an existing post or an explicit object_story_spec and optional asset_feed_spec.

Create a PAUSED ad using an existing ad set and creative from the selected account.

Replace an ad’s creative with another existing creative from the same account.

Upload an image into the selected ad account using base64 bytes (up to 5 MiB decoded).

Import a video from a public HTTPS URL or base64 MP4 bytes; processing is asynchronous.

Create a website, engagement, customer-list container or lookalike audience.

Update an existing custom audience name, description, retention or complete rule.

Create a filtered product set in a catalog owned by the same Business as the selected ad account.

Replace a product set filter or rename it.

Create or update up to 50 catalog products by retailer_id.

Change the start or end time of a Meta ad set.

Change the budget of a Meta campaign that holds its budget at campaign level (Advantage campaign budget).