Open-source MCP server for the Meta (Facebook & Instagram) Ads Marketing API. 34 read tools and 10 write tools that preview before they apply, 190 metrics, 56 breakdowns. Self-hosted, bring your own token.
Inferred from the transports this listing declares (stdio). A client not listed here hasn’t been ruled out — it just isn’t something Forge can confirm.
META_ACCESS_TOKENAPI keyrequiredMeta access token with at least the ads_read permission.
Declared by the author in the official MCP registry. Forge does not store, broker, or ever see these values — the config below is scaffolded with placeholders you fill in locally.
Verification confirms publisher identity (repo ownership), not code safety. The security scan covers known CVEs and suspicious install scripts.
Read out of the source npm actually ships, at scan time. The package was never executed. Tools registered dynamically at runtime, or hidden inside bundled or minified code, can be missed — so this is a floor on the tool surface, not a complete census of it.
meta_get_node_fieldsRead 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.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.
No input schema was published for this tool.
meta_list_edge_rawList 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.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.
No input schema was published for this tool.
meta_get_insights_rawQuery 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.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.
No input schema was published for this tool.
meta_search_targeting_optionsSearch Meta's read-only targeting metadata for interests, validated interests, geographies, locales, countries, cities, regions, markets, or postal codes.Search Meta's read-only targeting metadata for interests, validated interests, geographies, locales, countries, cities, regions, markets, or postal codes.
No input schema was published for this tool.
meta_get_ad_previewGet 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.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.
No input schema was published for this tool.
meta_health_checkAgent-ready read-only health check: validates token metadata, lists accessible ad accounts, and warns about missing read scopes without exposing the access token.Agent-ready read-only health check: validates token metadata, lists accessible ad accounts, and warns about missing read scopes without exposing the access token.
No input schema was published for this tool.
meta_get_business_assetsDiscover accessible Meta Business assets read-only: businesses, pages, Instagram accounts, pixels, and datasets when permissions allow.Discover accessible Meta Business assets read-only: businesses, pages, Instagram accounts, pixels, and datasets when permissions allow.
No input schema was published for this tool.
meta_get_pagesList accessible Facebook Pages with id, name, category, tasks, picture, and linked Instagram account references when available.List accessible Facebook Pages with id, name, category, tasks, picture, and linked Instagram account references when available.
No input schema was published for this tool.
meta_get_instagram_accountsList Instagram accounts linked to accessible Pages, Business Manager assets, or an ad account when permissions allow.List Instagram accounts linked to accessible Pages, Business Manager assets, or an ad account when permissions allow.
No input schema was published for this tool.
meta_get_pixelsList pixels and datasets from an ad account or Business Manager when accessible, returning actionable warnings for permission-limited edges.List pixels and datasets from an ad account or Business Manager when accessible, returning actionable warnings for permission-limited edges.
No input schema was published for this tool.
meta_get_ad_activityRead ad account activity logs from /{ad_account_id}/activities with object, event, actor, timestamp, and extra_data fields.Read ad account activity logs from /{ad_account_id}/activities with object, event, actor, timestamp, and extra_data fields.
No input schema was published for this tool.
meta_get_delivery_diagnosticsAggregate read-only delivery diagnostics across campaigns, ad sets, and ads using status/effective_status/issues_info where available plus simple delivery insights.Aggregate read-only delivery diagnostics across campaigns, ad sets, and ads using status/effective_status/issues_info where available plus simple delivery insights.
No input schema was published for this tool.
meta_get_creative_assetsReturn 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.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.
No input schema was published for this tool.
meta_get_audience_detailsRead detailed custom, saved, and lookalike audiences with pagination and rich fields where permissions allow.Read detailed custom, saved, and lookalike audiences with pagination and rich fields where permissions allow.
No input schema was published for this tool.
meta_get_catalog_productsRead Product Catalogs and Product Items when catalog access is available. Returns join-ready product metadata without creating or updating catalog assets.Read Product Catalogs and Product Items when catalog access is available. Returns join-ready product metadata without creating or updating catalog assets.
No input schema was published for this tool.
meta_join_product_insightsQuery product-breakdown insights and enrich rows with Product Catalog metadata when catalog access is available.Query product-breakdown insights and enrich rows with Product Catalog metadata when catalog access is available.
No input schema was published for this tool.
meta_get_brand_safety_controlsRead brand safety, suitability, placement, and context-control signals from ad account/ad set targeting and optional block-list edges.Read brand safety, suitability, placement, and context-control signals from ad account/ad set targeting and optional block-list edges.
No input schema was published for this tool.
meta_interpret_experiment_resultsRead and interpret A/B test or conversion lift study results with confidence guardrails, cells, objectives, and optional cell entities.Read and interpret A/B test or conversion lift study results with confidence guardrails, cells, objectives, and optional cell entities.
No input schema was published for this tool.
meta_get_organic_content_enrichmentEnrich Facebook Page posts and Instagram organic media with media URLs, permalinks, counts, attachments, and optional read-only insights.Enrich Facebook Page posts and Instagram organic media with media URLs, permalinks, counts, attachments, and optional read-only insights.
No input schema was published for this tool.
meta_list_ad_accountsList all Meta ad accounts accessible with the current token. Returns account ID, name, currency, timezone, and status.List all Meta ad accounts accessible with the current token. Returns account ID, name, currency, timezone, and status.
No input schema was published for this tool.
meta_get_account_detailsGet detailed information for a specific Meta ad account: name, currency, timezone, spend cap, status, business info.Get detailed information for a specific Meta ad account: name, currency, timezone, spend cap, status, business info.
No input schema was published for this tool.
meta_get_campaignsList campaigns for a Meta ad account. Returns campaign ID, name, status, objective, budget, and bid strategy.List campaigns for a Meta ad account. Returns campaign ID, name, status, objective, budget, and bid strategy.
No input schema was published for this tool.
meta_get_adsetsList ad sets for a Meta ad account, optionally filtered by campaign. Returns targeting, budget, optimization, and schedule info.List ad sets for a Meta ad account, optionally filtered by campaign. Returns targeting, budget, optimization, and schedule info.
No input schema was published for this tool.
meta_get_adsList ads for a Meta ad account, optionally filtered by ad set. Returns ad ID, name, status, and creative reference.List ads for a Meta ad account, optionally filtered by ad set. Returns ad ID, name, status, and creative reference.
No input schema was published for this tool.
meta_get_insightsQuery 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 mu…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 mu…
No input schema was published for this tool.
meta_get_campaign_structureGet hierarchical campaign structure: campaigns -> ad sets -> ads. Useful for understanding account organization.Get hierarchical campaign structure: campaigns -> ad sets -> ads. Useful for understanding account organization.
No input schema was published for this tool.
meta_get_creativesGet ad creative content: text, images, videos, links, call-to-action. Returns creative details for specified ads.Get ad creative content: text, images, videos, links, call-to-action. Returns creative details for specified ads.
No input schema was published for this tool.
meta_get_audiencesList custom, saved, and lookalike audiences for a Meta ad account.List custom, saved, and lookalike audiences for a Meta ad account.
No input schema was published for this tool.
meta_get_ad_studiesList conversion lift studies and A/B tests (Ad Studies) for an ad account. Includes study type, status, and cells.List conversion lift studies and A/B tests (Ad Studies) for an ad account. Includes study type, status, and cells.
No input schema was published for this tool.
meta_get_study_resultsGet detailed results for a conversion lift or A/B test study. Returns objectives, cells, and lift results.Get detailed results for a conversion lift or A/B test study. Returns objectives, cells, and lift results.
No input schema was published for this tool.
meta_validate_queryValidate a metric/breakdown combination BEFORE executing. Returns errors and warnings. Use this to check if your query will work.Validate a metric/breakdown combination BEFORE executing. Returns errors and warnings. Use this to check if your query will work.
No input schema was published for this tool.
meta_get_page_postsGet recent posts from a connected Facebook/Instagram page. Requires page access.Get recent posts from a connected Facebook/Instagram page. Requires page access.
No input schema was published for this tool.
meta_debug_tokenCheck the current access token validity, expiration, and granted scopes. Useful for diagnosing auth issues.Check the current access token validity, expiration, and granted scopes. Useful for diagnosing auth issues.
No input schema was published for this tool.
meta_search_entitiesSearch campaigns, ad sets, or ads by name within an ad account. Useful for finding specific entities.Search campaigns, ad sets, or ads by name within an ad account. Useful for finding specific entities.
No input schema was published for this tool.
meta_create_campaignCreate a Meta campaign. It is always created PAUSED and there is no option to create it active. Previews by default.Create a Meta campaign. It is always created PAUSED and there is no option to create it active. Previews by default.
No input schema was published for this tool.
meta_update_adset_budgetChange the daily or lifetime budget of a Meta ad set. Amount in the account currency (12.50 for 12.50 EUR). Meta expects minor units, the conversion is done here. Previews by default.Change the daily or lifetime budget of a Meta ad set. Amount in the account currency (12.50 for 12.50 EUR). Meta expects minor units, the conversion is done here. Previews by default.
No input schema was published for this tool.
meta_update_campaign_budgetChange the budget of a Meta campaign that holds its budget at campaign level (Advantage campaign budget). On a campaign without one, Meta refuses and the ad set budget is the one to change. Amount in the account currency. Previews by default.Change the budget of a Meta campaign that holds its budget at campaign level (Advantage campaign budget). On a campaign without one, Meta refuses and the ad set budget is the one to change. Amount in the account currency. Previews by default.
No input schema was published for this tool.
meta_update_adset_scheduleChange the start or end time of a Meta ad set. Times are ISO 8601 with an offset, for example 2026-09-01T00:00:00+0200. Previews by default.Change the start or end time of a Meta ad set. Times are ISO 8601 with an offset, for example 2026-09-01T00:00:00+0200. Previews by default.
No input schema was published for this tool.
38 of 38 tools published a description.
Tool names and descriptions are written by the publisher and shown verbatim as inert text. They are the strings an MCP client passes to a model, so Forge scans them for prompt-injection patterns — any finding appears with the security scan above. “Privileged” is a keyword match on the tool name, not an audit of what the tool does: a benign-sounding name can still do anything.
Open-source MCP server for the Meta (Facebook & Instagram) Ads Marketing API. 34 read tools and 10 write tools that preview before they apply, 190 metrics, 56 breakdowns. Self-hosted, bring your own token.
Linked names open Forge’s index of every entry observed exposing that tool. Browse all indexed tools.
The crawl stopped at the depth-4 limit. Anything below that level was never resolved.
The crawl stopped at the 60-package limit. The rest of the tree was never resolved.
36 more resolved packages are not drawn here (display cap: 24). Every dependency carrying an advisory is drawn regardless of the cap. Full inventory (CycloneDX SBOM)
54 declared dependencies never landed in the tree. They are missing from Forge's resolution, not from the package.
+42 more not listed. The counts by reason above cover all of them.
Not followed: peerDependencies. This tree covers runtime dependencies only, so anything those pull in was never resolved.