Meta Ads MCP server

Read from the package source without running it. The installed server may list more.

• meta_debug_token

  Inspect token identity, validity, expiry and scopes. When Meta refuses to inspect this token with itself, independently check the connecting user and granted permissions; token and app metadata then remain unknown.

• meta_get_account_details

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

• meta_get_ad_activity

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

• meta_get_ad_preview

  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.

• meta_get_ad_studies

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

• meta_get_ads

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

• meta_get_adsets

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

• meta_get_audience_details

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

• meta_get_audiences

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

• meta_get_brand_safety_controls

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

• meta_get_business_assets

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

• meta_get_campaign_structure

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

• meta_get_campaigns

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

• meta_get_catalog_products

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

• meta_get_creative_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 the hosted GetMCPAds service for an interactive visual gallery. Raw creative metadata remains available for diagnostics.

• meta_get_creatives

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

• meta_get_delivery_diagnostics

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

• meta_get_insights

  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. For purchases, leads or conversion analysis, request actions

• meta_get_insights_raw

  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.

• meta_get_instagram_accounts

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

• meta_get_node_fields

  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.

• meta_get_organic_content_enrichment

  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.

• meta_get_page_posts

  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.

• meta_get_pages

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

• meta_get_pixels

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

• meta_get_study_results

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

• meta_get_video_sources

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

• meta_health_check

  Read-only connection diagnostic: inspects token identity and granted permissions, and lists accessible ad accounts without exposing the access token. Unavailable checks remain unknown; granted scopes do not prove app access level or clearance of Meta security checkpoints.

• meta_interpret_experiment_results

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

• meta_join_product_insights

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

• meta_list_ad_accounts

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

• meta_list_ad_images

  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.

• meta_list_ad_videos

  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.

• meta_list_edge_raw

  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.

• meta_rename_ad_account

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

• meta_search_entities

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

• meta_search_targeting_options

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

• meta_validate_query

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

• Code scan9 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 4 days ago15/15
• Maintainer identitynamespace and repository owner differ; website matches verified namespace6/10

Safety score

80/100

higher than 60% of 48,255 servers

Tools

38

the typical server has 7

Tools that change things

0%

typical: 0%. Fewer write tools means less an agent can break

GitHub stars

1

more than 65% of 28,688 servers

Downloads a week

623

more than 91% of 12,191 servers with a package

Grade history

• 2026-10-30restoreC → Bscore 80

Meta Ads: common questions

Is Meta Ads MCP server safe?

Mostly: it is graded B (80/100). Read the Meta Ads safety report

How do I install Meta Ads?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does Meta Ads need an API key?

Yes. The registry entry asks for META_ACCESS_TOKEN.

Is Meta Ads maintained?

The last commit was 9 days ago (2026-10-26). The latest release is v2.1.1.

What can I use instead of Meta Ads?

Servers from other publishers that do the same job: AdLoop MCP server.

How does Meta Ads compare with other MCP servers?

safety score 80/100 (higher than 60% of 48,255 servers); tools 38 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.