Meta (Facebook & Instagram) MCP server

Showing 10 of 10 tools

• meta_ads_connect_catalog_event_source

  Write

  Connect a pixel, app or offline event set to a catalog, enabling dynamic ads to retarget people who interacted with its products.

• meta_ads_create_catalog

  Write

  Create a new, empty product catalog on a Business Portfolio. Use vertical 'commerce' for a standard e-commerce product catalog, or 'test_vertical' for a catalog meant purely for testing.

• meta_ads_create_catalog_feed

  Write

  Register a recurring feed on a catalog: a URL Meta fetches on a schedule to keep the catalog's products in sync.

• meta_ads_create_catalog_feed_rule

  Write

  Add a rule that transforms or maps an attribute during feed ingestion, e.g. set availability to 'out of stock' when inventory is 0. Applies to future imports, not products already loaded.

• meta_ads_create_catalog_feed_upload_session

  Write

  Trigger an immediate, one-time import from a feed's URL, without waiting for its next scheduled run. Useful right after fixing a feed problem.

• meta_ads_create_catalog_product

  Write

  Add a single product to a catalog. retailerId is your own SKU and must be unique within the catalog — re-using one updates that product instead of creating a duplicate. For bulk loading, use a product feed instead.

• meta_ads_create_catalog_product_set

  Write

  Create a product set from a filter rule, e.g. {and:[{category:{i_contains:'shoes'}}]}. The set stays live — products entering or leaving the catalog that match the filter join or drop automatically.

• meta_ads_delete_catalog_feed

  Write

  Destructive

  Permanently delete a product feed and its schedule. Products already imported through it are not removed — only the recurring sync stops.

• meta_ads_delete_catalog_feed_rule

  Write

  Destructive

  Permanently delete a feed transformation rule. Future imports stop applying it; products already transformed by it are not reverted.

• meta_ads_delete_catalog_product

  Write

  Destructive

  Permanently remove a product from a catalog. Cannot be undone, and the product drops out of any product set or dynamic ad using it immediately.

Showing 10 of 10 tools

• meta_ads_get_ad_account_pages

  Read-only

  List the Facebook Pages that have been used for ads on a specific ad account.

• meta_ads_get_ig_accounts

  Read-only

  List the Instagram Business or Creator accounts linked to an ad account.

• meta_ads_get_pages_for_business

  Read-only

  List the Facebook Pages owned by a Business Portfolio. For pages shared with the business by another business or agency, use meta_discover_assets instead.

• meta_create_instagram_post

  Write

  Publish an image or reel to the Instagram Business account linked to a Page.

• meta_create_post

  Write

  Create a post on a Facebook Page, optionally with a link, image, or scheduled publish time.

• meta_delete_post

  Write

  Destructive

  Permanently delete a post from a Facebook Page. This cannot be undone.

• meta_get_instagram_insights

  Read-only

  Impressions, reach and engagement for a single Instagram media item.

• meta_get_page_insights

  Read-only

  Page-level metrics such as fans, impressions and engaged users.

• meta_get_post_insights

  Read-only

  Impressions, engaged users, clicks and reactions for a single Page post.

• meta_hide_comment

  Write

  Hide or unhide a comment. Reversible — pass hide: false to restore it.

Showing 10 of 10 tools

• meta_ads_activate_entity

  Write

  Destructive

  Start delivery on a paused campaign, ad set or ad. THIS BEGINS SPENDING REAL MONEY immediately. Reports the entity's current budget back so the amount at risk is visible before and after.

• meta_ads_create_ad

  Write

  Create an ad by attaching a creative to an ad set. Always created PAUSED — the ad set and campaign must also be active before anything delivers.

• meta_ads_create_ad_set

  Write

  Create an ad set under a campaign with targeting, budget, schedule and optimization goal. Always created PAUSED. For conversion optimization you must supply promotedObject naming the pixel and event.

• meta_ads_create_campaign

  Write

  Create a Meta ad campaign. Always created PAUSED - use meta_ads_activate_entity to start spending. Supports objective, daily or lifetime budget, bid strategy, spend cap and special ad categories.

• meta_ads_get_entities

  Read-only

  List campaigns, ad sets or ads in an ad account with their configuration - budgets, status, objective, targeting, optimization goal and schedule. Use meta_ads_insights for performance metrics.

• meta_ads_update_entity

  Write

  Update fields on an existing campaign, ad set or ad - rename, change budget, adjust bid or pause it. Cannot activate a paused entity; use meta_ads_activate_entity for that.

• meta_create_ad_set

  Write

  Create an ad set. meta_ads_create_ad_set supports promoted objects, schedules and attribution, and enforces a spend ceiling.

• meta_create_campaign

  Write

  Create a campaign, paused by default. meta_ads_create_campaign supports more fields and enforces a spend ceiling.

• meta_discover_assets

  Read-only

  Discover every ad account, Page and Business Portfolio this connection can reach, across all businesses. Use this first to find the right account IDs — it sees accounts that List Ad Accounts cannot.

• meta_list_ad_accounts

  Read-only

  List ad accounts directly attached to the connected user. Does NOT include accounts held in a Business Portfolio — use meta_discover_assets for those.

Showing 7 of 7 tools

• meta_ads_create_custom_audience

  Write

  Create a custom audience. CUSTOM creates an empty customer list to populate with meta_ads_update_custom_audience_users. WEBSITE and ENGAGEMENT need a rule. LOOKALIKE needs an origin audience, country and ratio.

• meta_ads_delete_custom_audience

  Write

  Destructive

  Permanently delete a custom audience. This cannot be undone, and any ad set targeting it stops delivering to that audience. Refuses while ad sets still reference it unless force is set.

• meta_ads_get_custom_audience

  Read-only

  Details for a single custom audience: size, status, subtype, and when it was created or last updated.

• meta_ads_get_custom_audience_adsets

  Read-only

  List the ad sets currently targeting a custom audience. Check this before deleting or shrinking an audience — those ad sets stop delivering to it.

• meta_ads_get_custom_audiences

  Read-only

  List custom audiences on an ad account with size, subtype and delivery status. Use to see which audiences exist before targeting them.

• meta_ads_update_custom_audience

  Write

  Rename an audience, change its description, or update its rule. Does not change membership.

• meta_ads_update_custom_audience_users

  Write

  Destructive

  Add or remove people on a customer-list audience. Supply plain values — email, phone, name, city and so on — and they are normalised and SHA-256 hashed before leaving this server; Meta never receives, and this server never stores or logs, the raw values. Returns counts only.

Showing 7 of 7 tools

• meta_ads_boost_instagram_post

  Write

  Turn an existing organic Instagram post into an ad creative, ready to run. This creates only the creative -- pass its id to meta_ads_create_ad_set and meta_ads_create_ad to actually start delivery, the same two-step flow every other ad creation path in this integration uses. Not every post can be boosted (copyrighted music and interactive filters are excluded); check with meta_ads_get_ad_preview first if unsure.

• meta_ads_create_creative

  Write

  Create an ad creative — either a link ad from an image plus copy, or a promotion of an existing Page or Instagram post. Returns a creative ID for meta_ads_create_ad.

• meta_ads_get_ad_images

  Read-only

  List images uploaded to an ad account, for use as ad creative. Filter by name or hash, or by minimum dimensions.

• meta_ads_get_ad_preview

  Read-only

  Render a preview of an ad, an existing creative, or a not-yet-created creative spec, in a specific placement. Returns an iframe HTML snippet valid for 24 hours. Use this before creating a creative to see how it will actually look.

• meta_ads_get_ad_videos

  Read-only

  List videos uploaded to an ad account, for use as ad creative. Filter by length or aspect ratio.

• meta_ads_get_creative_ads

  Read-only

  List the ads in an account that use a specific creative. Meta has no direct reverse-lookup edge for this, so it scans the account's ads and filters client-side -- on a very large account, ads outside the page window fetched may be missed; raise maxPages if the creative isn't found.

• meta_ads_get_creatives

  Read-only

  List ad creatives in an account, to reuse an existing one rather than building another.

Showing 6 of 6 tools

• meta_ads_get_custom_conversions

  Read-only

  List the custom conversions defined on an ad account: the rule each one matches, the standard event category it reports as, its value, and which dataset feeds it. These are the conversion events available as ad set optimization goals.

• meta_ads_get_dataset_details

  Read-only

  Full configuration for one dataset (pixel): automatic advanced matching and which fields it matches on, first-party cookie status, data use setting, owner, and when it last received an event. Set includeInstallCode to also return the pixel install snippet.

• meta_ads_get_dataset_event_rules

  Read-only

  List the event rules on a dataset — the rules created by the Event Setup Tool that derive a standard event such as Purchase from a page URL or a click, plus any domain-control rules that drop events. Pass ruleId instead for one rule's full condition set.

• meta_ads_get_dataset_quality

  Read-only

  Event Match Quality for a dataset: Meta's 0-10 composite score per event, the coverage of each identifier feeding it, and how much more conversion reporting each identifier could unlock. Adds Meta's own diagnostics, the browser/Conversions API split, events dropped for carrying unhashed PII, and time since last event. This is the tool for why conversions are under-reporting.

• meta_ads_get_datasets

  Read-only

  List the datasets — what Events Manager calls pixels — on an ad account or a Business Portfolio. Supply businessId to see every dataset the portfolio owns or is shared, which is usually more than the ad account edge returns. Returns configuration and last-fired time, not the install snippet.

• meta_ads_get_dataset_stats

  Read-only

  Event volume received by a dataset, in hourly buckets, broken down by a dimension. Use aggregation 'event' for the event mix, 'event_source' to split browser from Conversions API, 'match_keys' for which identifiers arrive, 'url' for the pages firing. Meta keeps only the last 28 days.

Showing 6 of 6 tools

• meta_ads_create_abtest

  Write

  Create a split test comparing two or more campaigns, ad sets, or (for a creative test) ads. Traffic is divided between cells by treatmentPercentage, which must sum to 100 across all cells.

• meta_ads_create_lift_study

  Write

  Create a conversion lift study: a holdout-based measurement of the real incremental conversions your ads cause, as opposed to conversions that would have happened anyway.

• meta_ads_get_abtest

  Read-only

  Details, status and results for an existing A/B (split) test — cells, allocation, and per-objective results once concluded.

• meta_ads_get_lift_study

  Read-only

  Details, status and results for an existing conversion lift study — cells, measurement objectives, and incrementality results once concluded.

• meta_ads_list_experiments

  Read-only

  List the A/B tests and conversion lift studies on a Business Portfolio or ad account, optionally filtered by type.

• meta_ads_update_experiment

  Write

  Destructive

  Rename an A/B test or lift study, extend or shorten its end time before it concludes, or cancel it early by setting endTime to now. start_time and cell allocations cannot change once a study has started — create a new study instead.

Showing 5 of 5 tools

• meta_ads_get_activity_logs

  Read-only

  Activity log entries for an ad account -- who changed what, and when. Filter by date range or category (e.g. BUDGET, STATUS, TARGETING).

• meta_ads_get_errors

  Read-only

  Delivery-blocking errors and issues for a campaign, ad set, ad, or the whole ad account. Check this when something isn't spending or delivering as expected.

• meta_ads_get_opportunity_score

  Read-only

  The ad account's optimization score (0-100), with the specific recommendations behind it. Higher means campaigns, ad sets and ads are closer to Meta's own best-practice configuration.

• meta_ads_insights

  Read-only

  Full Meta Ads performance reporting at account, campaign, ad set or ad level. Supports explicit date ranges or presets, any Meta metric, breakdowns (platform, placement, age, gender, country, device), conversion-action breakdowns, server-side filtering, sorting and time bucketing. Use this for any question about spend, ROAS, CPA, CTR, conversions or trends.

• meta_get_campaign_insights

  Read-only

  Basic performance for a single campaign. meta_ads_insights is far more capable — explicit date ranges, any metric, breakdowns, filtering and sorting at any level.