Meta Ads MCP Server (Facebook & Instagram)

Connect Meta Ads to Claude, ChatGPT or Perplexity

Meta's official ads MCP server. Pull reporting and benchmarks, create and edit campaigns, ad sets and ads, and manage catalogs, audiences, signals and A/B tests across Facebook and Instagram — straight from a chat.

https://mcp.facebook.com/adsConnect
  • 91 tools
  • Official Meta server
  • Sign in with Facebook
  • Every new ad starts paused
Claude.ai
1. Open Claude.ai → Settings
2. Go to Connectors → Add custom connector
3. Enter the URL:https://mcp.facebook.com/ads
4. Click Add, then sign in with your Facebook account
ChatGPT

Requires a ChatGPT paid plan (Plus, Pro, or Business).

1. Open ChatGPT → Settings → Apps
2. Enable Developer Mode under Advanced
3. Create, name it "meta-ads", enter URL:https://mcp.facebook.com/ads
4. In a new chat: + → More → enable meta-ads
Claude Code

Run this command in your terminal:

BASH
claude mcp add meta-ads --transport http https://mcp.facebook.com/ads

You will be prompted to sign in on first use.

Perplexity works too. Other clients, such as Cursor, n8n or Zapier, need a Meta developer app of your own. Meta's setup guide

Tools Reference

91 tools organized by category. Click any category to expand.

ads_get_ad_entities

Retrieve ad campaigns, ad sets, and ads with performance metrics (spend, impressions, CTR, CPC, CPM, conversions), plus filtering, breakdowns, sorting, and date ranges.

Meta docs
ads_get_opportunity_score

Return the ad account's optimization score (0–100) along with actionable recommendations for improving performance.

Meta docs
ads_insights_advertiser_context

Summarize business context and marketing funnel to help pick the right optimization goal.

Meta docs
ads_insights_anomaly_signal

Detect unusual patterns or deviations in ad performance that warrant investigation.

Meta docs
ads_insights_auction_ranking_benchmarks

Show which ads performed best in the auction and where bid or ad-quality investment would help.

Meta docs
ads_insights_industry_benchmark

Compare ad set performance against benchmarks from similar advertisers.

Meta docs
ads_insights_performance_trend

Track how key performance metrics (CPC, CPM, cost per result, ROAS, CTR, conversion rate) change over time.

Meta docs

ads_get_ad_accounts

List the ad accounts the user has access to (name, status, currency, timezone).

Meta docs
ads_get_ad_account_pages

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

Meta docs
ads_get_pages_for_business

List Facebook Pages owned by a business.

Meta docs
ads_get_user_pages

List all Facebook Pages the user can use for advertising, across their businesses.

Meta docs
ads_get_field_context

Look up metadata for ad fields (type, filterability, enum values, supported entity levels) before calling ads_get_ad_entities.

Meta docs
ads_create_campaign

Create a new ad campaign (paused).

Meta docs
ads_create_ad_set

Create an ad set with targeting, budget, and optimization goal under a campaign (paused).

Meta docs
ads_create_ad

Create an ad with a creative under an ad set (paused).

Meta docs
ads_update_entity

Update fields on an existing campaign, ad set, or ad.

Meta docs
ads_activate_entity

Change a paused campaign, ad set, or ad to active — starts spending budget.

Meta docs
ads_create_creative

Create a single-image link ad creative.

Meta docs
ads_get_creatives

List ad creatives in an ad account.

Meta docs
ads_get_creative_ads

List the ads that use a specific creative.

Meta docs
ads_get_ad_images

List ad images uploaded to an ad account.

Meta docs
ads_get_ad_videos

List ad videos uploaded to an ad account.

Meta docs
ads_get_ad_preview

Render a preview of an ad or creative in a specific placement (Feed, Story, Reels, and so on).

Meta docs
ads_library_search

Search the public Meta Ad Library for competitive research and creative inspiration.

Meta docs
ads_get_ig_accounts

List Instagram Business or Creator Accounts linked to an ad account.

Meta docs
ads_get_ig_media

List recent media (posts, reels, stories) on an Instagram Business or Creator Account, filtered to boost-eligible items.

Meta docs
ads_boost_ig_post

Turn an existing organic Instagram post into a boosted ad.

Meta docs
ads_get_ad_account_custom_audiences

List custom audiences on an ad account (optionally filtered by subtype).

Meta docs
ads_get_custom_audience

Get details for a single custom audience (size, status, subtype).

Meta docs
ads_get_custom_audience_adsets

List the ad sets currently targeting a given custom audience.

Meta docs
ads_create_custom_audience

Create a new custom audience (customer file, website, lookalike, app, engagement, or offline conversion).

Meta docs
ads_update_custom_audience

Update the name, description, rule, or labels on an existing custom audience.

Meta docs
ads_update_custom_audience_users

Add or remove users on a customer list audience by uploading hashed personal data.

Meta docs
ads_delete_custom_audience

Delete a custom audience.

Meta docs

ads_catalog_create

Create a new product catalog and optionally upload initial product data via a feed URL, inline items, or file upload.

Meta docs
ads_catalog_update_catalog

Update settings on an existing catalog (for example, rename it).

Meta docs
ads_catalog_get_catalogs

List product catalogs, optionally filtered by business or name.

Meta docs
ads_catalog_get_details

Retrieve details about a catalog — name, vertical, item count, business ownership, and (optionally) feeds.

Meta docs
ads_catalog_get_diagnostics

List issues on a catalog (errors, warnings, opportunities) that may affect ad delivery.

Meta docs
ads_catalog_get_dynamic_ads_health

Check whether a catalog (or product set) is healthy enough to serve Advantage+ catalog ads.

Meta docs
ads_catalog_get_data_sources

List all data sources associated with a catalog (feed URLs, uploads, API sources).

Meta docs
ads_catalog_get_product_details

Get details for a single product (name, price, availability, image).

Meta docs
ads_catalog_product_create

Create a product in a catalog.

Meta docs
ads_catalog_update_product

Update a product's fields (name, price, availability, brand, and so on).

Meta docs
ads_catalog_delete_product

Delete a product from a catalog.

Meta docs
ads_catalog_get_product_product_sets

List the product sets a given product belongs to.

Meta docs
ads_catalog_search_product

Search a catalog with a structured filter rule and preview matching products.

Meta docs
ads_catalog_create_product_set

Create a dynamic product set from a filter rule.

Meta docs
ads_catalog_update_product_set

Update a product set's name, filter, retailer ID, visibility, or parent.

Meta docs
ads_catalog_get_product_sets

List product sets in a catalog.

Meta docs
ads_catalog_get_product_set_details

Get details for a single product set, including its filter rule and match count.

Meta docs
ads_catalog_get_product_set_products

List products in a product set, with optional attribute filters.

Meta docs
ads_catalog_product_set_delete

Delete a product set and its filter rule. Products themselves are not deleted; only the set that groups them.

Meta docs
ads_catalog_create_product_feed

Register a new product feed on a catalog (optionally scheduled to fetch from a URL).

Meta docs
ads_catalog_update_product_feed

Update a feed's name, currency defaults, parsing options, or schedules.

Meta docs
ads_catalog_get_product_feed_details

Get feed configuration — URL, schedule, format, and status.

Meta docs
ads_catalog_create_product_feed_upload_session

Start a new upload session for a feed (used for chunked uploads).

Meta docs
ads_catalog_get_product_feed_upload_sessions

List upload sessions for a feed, including status and error counts.

Meta docs
ads_catalog_product_feed_delete

Delete a product feed and its schedule. Products ingested by the feed are also removed asynchronously; products also supplied by another data source are kept.

Meta docs
ads_catalog_create_feed_rule

Create a supplementary rule that maps or transforms an attribute on a feed.

Meta docs
ads_catalog_get_feed_rules

List the supplementary rules applied to a feed.

Meta docs
ads_catalog_product_feed_delete_rule

Delete a transformation rule from a product feed. The feed and its products are not affected.

Meta docs
ads_catalog_event_source_get

List the event sources (pixels, apps, or offline conversion data sets) connected to a catalog.

Meta docs
ads_catalog_event_source_get_catalogs

Get the catalogs connected to a given event source (pixel, app, or offline conversion data set).

Meta docs
ads_catalog_event_source_get_health

Report the match rate and setup issues for a catalog's connected event sources, including 28-day historical match rate stats.

Meta docs
ads_catalog_event_source_get_recommendations

Recommend event sources to connect to a catalog with weak or missing signal coverage, based on which sources' conversion events best match the catalog's products.

Meta docs
ads_catalog_event_source_connect

Connect an event source (pixel, app, or offline conversion data set) to a catalog so its signals can be matched against catalog products for dynamic ads and Advantage+ catalog ads.

Meta docs
ads_catalog_event_source_disconnect

Disconnect an event source from a catalog, so its signals are no longer matched against catalog products.

Meta docs

ads_get_datasets

List datasets (pixels or applications) on a business or ad account.

Meta docs
ads_get_dataset_details

Get metadata and configuration for a dataset, including Conversions API setup.

Meta docs
ads_get_dataset_stats

Report event volume received by a dataset over a configurable window (up to 28 days), with optional breakdown by device or event source.

Meta docs
ads_get_dataset_quality

Report Event Match Quality (EMQ) scores, per-match-key coverage, and data freshness by channel.

Meta docs
ads_pixel_event_read

List event rules on a pixel, or fetch a single rule by ID.

Meta docs
ads_pixel_event_create

Create a new event rule on a pixel (starts inactive).

Meta docs
ads_pixel_event_update

Activate or deactivate an existing event rule.

Meta docs
ads_pixel_event_delete

Delete an event rule.

Meta docs
ads_pixel_parameter_read

List parameters on a pixel, or fetch a single parameter by ID.

Meta docs
ads_pixel_parameter_create

Create a new parameter extractor.

Meta docs
ads_pixel_parameter_update

Update an existing parameter.

Meta docs
ads_pixel_parameter_delete

Delete a parameter.

Meta docs
ads_get_customconversions

List custom conversions defined on an ad account.

Meta docs

ads_get_errors

Return delivery-blocking errors for campaigns, ad sets, ads, or an ad account.

Meta docs
ads_get_help_article

Search Meta Business Help Center for articles about advertising concepts, policies, or troubleshooting guidance.

Meta docs

ads_experiment_list_tests

List studies on an ad account, optionally scoped to a specific ad entity or study type.

Meta docs
ads_experiment_check_eligibility

Check whether an ad account or set of entities is eligible for A/B testing before you try to create one.

Meta docs
ads_experiment_abtest_create_test

Create a new A/B test by defining test cells.

Meta docs
ads_experiment_abtest_get_test

Retrieve details, status, and results of an existing A/B test.

Meta docs
ads_experiment_abtest_update_test

Edit or cancel an existing A/B test.

Meta docs
ads_experiment_lift_create_test

Create a new conversion lift study on an ad account.

Meta docs
ads_experiment_lift_get_test

Retrieve details, status, and results of an existing lift study.

Meta docs

ads_account_get_activity_logs

Retrieve activity log entries for an ad account, optionally scoped by object, time window, event category, or user.

Meta docs
All tools in Meta's docs

Authentication

This is Meta's own server, so you sign in with your Facebook account or Meta Managed Account (Facebook Login for Business) and approve the permissions it asks for. Your AI client talks to Meta directly — there are no tokens to copy.

How it works
  1. 1. Your AI client connects to Meta's server
  2. 2. Facebook Login for Business opens in your browser
  3. 3. You sign in and approve the requested permissions
  4. 4. Your client can work with the ad accounts you have access to

Good to Know

  • New campaigns, ad sets and ads are created paused — nothing spends until you set it live.
  • If you manage a business portfolio, you can allow or block what agents may do in each ad account, in Meta Business Suite under Settings → Integrations → Ads MCP server.
  • Meta is rolling the server out gradually, so some tools may not be on your account yet.

What to Ask

Once connected, talk to your AI assistant in plain language. Here are some things you can ask:

“List my ad accounts.”
Lists the Meta ad accounts you can access, with their status, currency and timezone.
“Summarize the top-spending campaigns in my account over the last 30 days.”
Pulls spend and results for the last 30 days and ranks your campaigns.
“Create a new traffic campaign in my main ad account.”
Creates the campaign paused, so nothing spends until you say so.
“Draft an ad set for my Spring Sale campaign that optimizes for link clicks.”
Creates the ad set with its targeting, budget and goal — also paused.
“Why isn't my Spring Sale ad delivering?”
Checks for delivery-blocking errors and explains what they mean.
“How does my click-through rate compare with similar advertisers?”
Compares your ad set performance against benchmarks from similar advertisers.

Ready to connect?

Add the endpoint to Claude, ChatGPT or Claude Code and sign in with Facebook.

https://mcp.facebook.com/adsConnect

Other MCP servers