Meta Ads MCP Server

Create or update up to 50 catalog products by retailer_id. Returns asynchronous batch handles; acceptance is not completion. No deletion or automatic upsert. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.

Create a PAUSED ad using an existing ad set and creative from the selected account. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.

Create an ad creative from an existing post or an explicit object_story_spec and optional asset_feed_spec. Supports image, video, carousel, collection and flexible specs. Does not launch an ad. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.

Create a PAUSED Meta ad set with explicit targeting, optimization, placements, attribution, bidding and schedule. Amounts use major account-currency units. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.

Create a PAUSED Meta campaign with either ad set budgets (omit campaign budget), a daily campaign budget, or a lifetime campaign budget. Supports native validate_only. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.

Create a website, engagement, customer-list container or lookalike audience. Does not upload customer data. Terms and eligibility are enforced by Meta. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.

Create a filtered product set in a catalog owned by the same Business as the selected ad account. Never publishes to Shops. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.

Inspect token identity, validity, expiry and scopes using server app credentials. If privileged inspection is unavailable, independently check the connecting user and granted permissions; token/app metadata remains unknown.

Duplicate a known-good ad set within the selected account, preserving complex native configuration. Always PAUSED and WITHOUT copying ads. Rename it afterwards with meta_rename_adset. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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 get_creative_gallery for a visual gallery. Raw creative metadata remains available for diagnostics.

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

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

Meta performance. For purchases, leads or conversion analysis request actions (and action_values for revenue), or explicit metrics such as purchases/omni_purchases/leads. The native conversions field is not a universal conversion total; its absence does not mean purchases or leads are unavailable. Label the exact action_type and never sum overlapping purchase types. Fields: meta://metrics, meta://dimensions, meta://breakdowns. Compatible query results are merged.

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

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.

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.

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

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

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

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.

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-only connection diagnostic: inspects token identity and granted permissions, and lists accessible selected ad accounts. Unavailable checks remain unknown; granted scopes do not prove app access level or clearance of Meta security checkpoints.

Read a specific acknowledged Launcher 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.

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

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

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

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.

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

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

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

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

Replace an ad’s creative with another existing creative from the same account. The ad status is unchanged. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.

Pause or reactivate a Meta ad. Previews by default: without confirm: true, the tool describes the change without applying it.

Change an ad set daily or lifetime budget after checking its parent budget and existing schedule. Status stays unchanged. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.

Update targeting, optimization, placements, attribution, bidding, budget or schedule. Targeting is a COMPLETE replacement, not a partial merge. Status is unchanged. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.

Change start and/or end time using ISO 8601 with an explicit offset. Check the resulting range against existing dates before any mutation. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.

Pause or reactivate a Meta ad set. Previews by default: without confirm: true, the tool describes the change without applying it.

Change an existing campaign-owned budget after verifying currency and ownership. Does not convert an ad-set-budget campaign or change status. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.

Pause or reactivate a Meta campaign. Previews by default: without confirm: true, the tool describes the change without applying it.

Update an existing custom audience name, description, retention or complete rule. Does not change audience membership directly. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.

Replace a product set filter or rename it. Catalog ownership and set membership are checked before writing. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.

Upload an image into the selected ad account using base64 bytes (up to 5 MiB decoded). Preview reports size only, never the file body. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.

Import a video from a publicly reachable HTTPS URL or base64 MP4 bytes (up to 5 MiB decoded). Meta processes it asynchronously. No campaign is launched. Local preview by default. No automatic retry. Account ownership is checked before Meta validation or mutation.

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