Meta Ads MCP Server: run Facebook and Instagram ads from Claude or ChatGPT

• Pulls campaigns, ad sets and ads with spend, clicks, CTR and conversions

  Finds campaigns, ad sets and ads and reports their spend, impressions, CTR, CPC, CPM and conversions, with filters, breakdowns, sorting and date ranges. This is the main reporting tool.

  Try: “Show spend, CTR and conversions for every campaign in my ad account last week.”

  Network · ads_get_ad_entities

• Lists the ad accounts you can access, with status and currency

  Lists every ad account you have access to, with its name, status, currency and time zone.

  Try: “List my ad accounts.”

  Network · ads_get_ad_accounts

• Shows how costs, CTR, ROAS and conversion rate change over time

  Tracks how key numbers such as cost per click, cost per result, ROAS, CTR and conversion rate move over a period.

  Try: “How has my cost per purchase changed over the last 60 days?”

  Network · ads_insights_performance_trend

• Gives your account's optimization score with suggestions to improve it

  Returns the ad account's optimization score from 0 to 100, plus Meta's recommendations for improving performance.

  Try: “What is my opportunity score and what should I fix first?”

  Network · ads_get_opportunity_score

• Flags unusual swings in ad performance worth a closer look

  Spots unusual patterns or sudden changes in ad performance that you may want to investigate.

  Try: “Did anything unusual happen to my campaigns this week?”

  Network · ads_insights_anomaly_signal

• Compares your ad sets with similar advertisers

  Compares an ad set's performance against benchmarks from similar advertisers.

  Try: “How does my lead ad set compare with similar advertisers?”

  Network · ads_insights_industry_benchmark

• Shows which ads win in the auction and where quality or bids lag

  Shows which ads performed best in the auction and where better bids or ad quality would help.

  Try: “Which of my ads rank lowest in the auction and why?”

  Network · ads_insights_auction_ranking_benchmarks

• Summarizes your business and funnel to pick the right goal

  Summarizes your business context and marketing funnel to help choose the right optimization goal for a campaign.

  Try: “Which optimization goal suits my business best?”

  Network · ads_insights_advertiser_context

• Finds errors that are stopping campaigns or ads from delivering

  Returns errors that block delivery for campaigns, ad sets, ads or a whole ad account.

  Try: “Why aren't my ads delivering?”

  Network · ads_get_errors

• Searches Meta's Business Help Center for answers

  Searches Meta Business Help Center articles about advertising concepts, policies and troubleshooting.

  Try: “What does Meta's help center say about the learning phase?”

  Network · ads_get_help_article

• Shows who changed what in an ad account, like campaign history

  Reads the activity log for an ad account, the same as the campaign history page in Ads Manager, filtered by object, time, category or person.

  Try: “Who changed the budget on my Spring Sale campaign yesterday?”

  Network · ads_account_get_activity_logs

• Lists the ad creatives in an ad account

  Lists the ad creatives stored in an ad account.

  Try: “List the creatives in my ad account.”

  Network · ads_get_creatives

• Shows which ads use a given creative

  Lists the ads that use a specific creative.

  Try: “Which ads use this creative?”

  Network · ads_get_creative_ads

• Lists images uploaded to an ad account

  Lists the ad images uploaded to an ad account.

  Try: “Show the images in my ad library.”

  Network · ads_get_ad_images

• Lists videos uploaded to an ad account

  Lists the ad videos uploaded to an ad account.

  Try: “Show the videos in my ad library.”

  Network · ads_get_ad_videos

• Previews how an ad looks in Feed, Stories, Reels and more

  Renders a preview of an ad or creative in a chosen placement such as Feed, Stories or Reels.

  Try: “Show me how this ad looks in Instagram Stories.”

  Network · ads_get_ad_preview

• Searches the public Meta Ad Library for competitor ads

  Searches the public Meta Ad Library for competitive research and creative ideas.

  Try: “Find ads competitors are running for running shoes in the US.”

  Network · ads_library_search

• Lists Facebook Pages used for ads on an ad account

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

  Try: “Which Pages have run ads from this ad account?”

  Network · ads_get_ad_account_pages

• Lists Facebook Pages owned by a business

  Lists the Facebook Pages a business owns.

  Try: “List the Pages owned by my business.”

  Network · ads_get_pages_for_business

• Lists all Facebook Pages you can advertise with

  Lists every Facebook Page you can use for advertising across your businesses.

  Try: “Which Pages can I run ads for?”

  Network · ads_get_user_pages

• Lists Instagram accounts linked to an ad account

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

  Try: “Which Instagram accounts are linked to my ad account?”

  Network · ads_get_ig_accounts

• Lists recent Instagram posts and reels you can boost

  Lists recent posts, reels and stories on a linked Instagram account, filtered to items that can be boosted.

  Try: “Show my recent Instagram posts that can be boosted.”

  Network · ads_get_ig_media

• Lists the custom audiences in an ad account

  Lists custom audiences on an ad account, optionally by type.

  Try: “List my custom audiences.”

  Network · ads_get_ad_account_custom_audiences

• Shows a custom audience's size and status

  Gets details for one custom audience, such as its size, status and type.

  Try: “How big is my Past Purchasers audience?”

  Network · ads_get_custom_audience

• Shows which ad sets target a custom audience

  Lists the ad sets currently targeting a given custom audience.

  Try: “Which ad sets use my Newsletter Subscribers audience?”

  Network · ads_get_custom_audience_adsets

• Creates a new campaign, paused until you turn it on

  Creates a new ad campaign. It starts paused, so it spends nothing until activated.

  Try: “Create a new traffic campaign in my ad account.”

  Write · ads_create_campaign

• Creates an ad set with targeting, budget and goal, paused

  Creates an ad set under a campaign with targeting, budget and optimization goal. It starts paused.

  Try: “Draft an ad set for my Spring Sale campaign that optimizes for link clicks.”

  Write · ads_create_ad_set

• Creates an ad under an ad set, paused

  Creates an ad with a creative under an ad set. It starts paused.

  Try: “Create an ad in the US Women ad set using my new summer creative.”

  Write · ads_create_ad

• Creates an ad creative from images, video or both

  Creates a single-image link ad creative, with placement customization or mixed image and video options where available.

  Try: “Create a link ad creative with this image and the headline Summer Sale.”

  Write · ads_create_creative

• Edits an existing campaign, ad set or ad, such as budget or name

  Updates fields on an existing campaign, ad set or ad, such as its name, budget or targeting.

  Try: “Raise the daily budget on my Spring Sale ad set to $50.”

  Write · ads_update_entity

• Turns on a paused campaign, ad set or ad so it starts spending

  Switches a paused campaign, ad set or ad to active. This starts spending budget, so your assistant asks first.

  Try: “Activate the Spring Sale campaign.”

  Write · ads_activate_entity

• Turns an Instagram post into a boosted ad

  Turns an existing organic Instagram post into a boosted ad.

  Try: “Boost my latest Instagram reel to people in Canada for a week.”

  Write · ads_boost_ig_post

• Creates a custom or lookalike audience

  Creates a new custom audience from a customer file, website visitors, a lookalike, app activity, engagement or offline conversions.

  Try: “Create a 1% lookalike audience of my past purchasers.”

  Write · ads_create_custom_audience

• Renames or edits a custom audience's rule or labels

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

  Try: “Rename my Newsletter audience to Email Subscribers.”

  Write · ads_update_custom_audience

• Adds or removes people on a customer list from hashed data

  Adds or removes people on a customer list audience by uploading hashed personal data.

  Try: “Remove these hashed emails from my customer list audience.”

  Write · ads_update_custom_audience_users

• Deletes a custom audience

  Deletes a custom audience from the ad account.

  Try: “Delete my old Black Friday 2024 audience.”

  Delete · ads_delete_custom_audience

• Lists your product catalogs with item counts

  Lists the catalogs you can access, for a business or ad account, or one catalog with its counts.

  Try: “List my product catalogs.”

  Network · ads_catalog_list_catalogs

• Lists or searches products in a catalog

  Lists products in a catalog or product set, searches them with a filter, or gets one product.

  Try: “Show products in my catalog that are out of stock.”

  Network · ads_catalog_list_products

• Lists catalog errors and warnings that can hurt ad delivery

  Lists issues on a catalog, such as errors, warnings and opportunities, that may affect ad delivery.

  Try: “What problems does my product catalog have?”

  Network · ads_catalog_get_diagnostics

• Checks whether a catalog is ready for catalog ads

  Checks whether a catalog or product set is healthy enough to serve Advantage+ catalog ads.

  Try: “Is my catalog ready for catalog ads?”

  Network · ads_catalog_get_dynamic_ads_health

• Finds catalogs your ad account can use for catalog ads

  Finds and ranks catalogs that an ad account can use for dynamic or Advantage+ catalog ads, with a recommended one when available.

  Try: “Which catalog should I use for catalog ads on this account?”

  Network · ads_catalog_list_dpa_eligible_catalogs

• Lists the feeds and uploads that fill a catalog

  Lists the data sources connected to a catalog, such as feed URLs, uploads and API sources.

  Try: “Where does my catalog get its product data from?”

  Network · ads_catalog_get_data_sources

• Lists product sets in a catalog

  Lists product sets in a catalog, gets one set, or lists the sets that contain a product.

  Try: “List the product sets in my catalog.”

  Network · ads_catalog_list_product_sets

• Lists product feeds with their schedule and status

  Lists feeds in a catalog, or one feed with its configuration, schedule and status.

  Try: “Show my product feeds and when they last ran.”

  Network · ads_catalog_list_product_feeds

• Lists the rules that transform a feed's data

  Lists the supplementary rules applied to a product feed.

  Try: “What rules are applied to my main product feed?”

  Network · ads_catalog_get_feed_rules

• Lists pixels and apps connected to a catalog

  Lists the event sources, such as pixels, apps or offline data sets, connected to a catalog.

  Try: “Which pixels are connected to my catalog?”

  Network · ads_catalog_event_source_get

• Shows which catalogs a pixel or app is connected to

  Gets the catalogs connected to a given pixel, app or offline conversion data set.

  Try: “Which catalogs use my website pixel?”

  Network · ads_catalog_event_source_get_catalogs

• Reports how well pixel events match catalog products

  Reports the match rate and setup issues for a catalog's connected event sources, with 28 days of history.

  Try: “How well do my pixel events match my catalog products?”

  Network · ads_catalog_event_source_get_health

• Suggests pixels or apps to connect to a catalog

  Recommends event sources to connect to a catalog with weak or missing signal coverage.

  Try: “Which pixel should I connect to my catalog?”

  Network · ads_catalog_event_source_get_recommendations

• Creates a product catalog and can load products into it

  Creates a new product catalog and can upload initial product data from a feed URL, inline items or a file.

  Try: “Create a catalog called Summer Collection from this feed URL.”

  Write · ads_catalog_create

• Renames or changes catalog settings

  Updates settings on an existing catalog, such as its name.

  Try: “Rename my catalog to Main Store.”

  Write · ads_catalog_update_catalog

• Adds a product to a catalog

  Creates a product in a catalog.

  Try: “Add a product called Blue Linen Shirt priced at $45 to my catalog.”

  Write · ads_catalog_product_create

• Edits a product's name, price, stock or brand

  Updates a product's fields such as name, price, availability and brand.

  Try: “Mark the Blue Linen Shirt as out of stock.”

  Write · ads_catalog_update_product

• Creates a product set from a filter rule

  Creates a dynamic product set from a filter rule.

  Try: “Create a product set of red dresses under $50 that are in stock.”

  Write · ads_catalog_create_product_set

• Changes a product set's name or filter

  Updates a product set's name, filter or retailer ID.

  Try: “Change the Sale product set to include items under $40.”

  Write · ads_catalog_update_product_set

• Adds a product feed to a catalog, optionally on a schedule

  Registers a new product feed on a catalog, optionally fetching from a URL on a schedule.

  Try: “Add a daily feed from this URL to my catalog.”

  Write · ads_catalog_create_product_feed

• Changes a feed's settings or schedule

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

  Try: “Change my main feed to update every 6 hours.”

  Write · ads_catalog_update_product_feed

• Adds a rule that maps or transforms a feed field

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

  Try: “Add a feed rule that maps the color column to the color field.”

  Write · ads_catalog_create_feed_rule

• Connects a pixel or app to a catalog

  Connects a pixel, app or offline data set to a catalog so its events can be matched to products for catalog ads.

  Try: “Connect my website pixel to the Summer Collection catalog.”

  Write · ads_catalog_event_source_connect

• Disconnects a pixel or app from a catalog

  Disconnects an event source from a catalog so its events are no longer matched to products.

  Try: “Disconnect the old app from my catalog.”

  Write · ads_catalog_event_source_disconnect

• Deletes a product from a catalog

  Deletes a product from a catalog.

  Try: “Delete the discontinued Wool Scarf from my catalog.”

  Delete · ads_catalog_delete_product

• Deletes a product set, not the products in it

  Deletes a product set and its filter rule. The products themselves stay in the catalog.

  Try: “Delete the Black Friday product set.”

  Delete · ads_catalog_product_set_delete

• Deletes a product feed and the products it supplied

  Deletes a product feed and its schedule. Products that only came from that feed are removed too.

  Try: “Delete my old test feed.”

  Delete · ads_catalog_product_feed_delete

• Deletes a feed rule, leaving the feed and products

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

  Try: “Remove the color mapping rule from my feed.”

  Delete · ads_catalog_product_feed_delete_rule

• Lists your pixels and app data sets

  Lists the datasets, meaning pixels or apps, on a business or ad account.

  Try: “List my pixels.”

  Network · ads_get_datasets

• Shows a pixel's settings, including Conversions API setup

  Gets the metadata and configuration for a dataset, including its Conversions API setup.

  Try: “Is the Conversions API set up on my website pixel?”

  Network · ads_get_dataset_details

• Shows how many events a pixel received, up to 28 days

  Reports the event volume a dataset received over a window of up to 28 days, by device or source.

  Try: “How many purchase events did my pixel get this week?”

  Network · ads_get_dataset_stats

• Shows Event Match Quality scores and data freshness

  Reports Event Match Quality scores, coverage for each match key and data freshness by channel.

  Try: “What is the Event Match Quality for my purchase event?”

  Network · ads_get_dataset_quality

• Lists the event rules set up on a pixel

  Lists the event rules on a pixel, or gets one rule.

  Try: “What events are set up on my pixel?”

  Network · ads_pixel_event_read

• Lists the parameters a pixel's events capture

  Lists the parameters on a pixel, such as value or currency, or gets one.

  Try: “Which parameters does my purchase event capture?”

  Network · ads_pixel_parameter_read

• Lists custom conversions on an ad account

  Lists the custom conversions defined on an ad account.

  Try: “List my custom conversions.”

  Network · ads_get_customconversions

• Adds a new event rule to a pixel, starting inactive

  Creates a new event rule on a pixel based on website interactions, such as Add to Cart. It starts inactive.

  Try: “Add an AddToCart event when someone clicks the Add to bag button.”

  Write · ads_pixel_event_create

• Turns a pixel event rule on or off

  Activates or deactivates an existing pixel event rule.

  Try: “Turn on the AddToCart event rule.”

  Write · ads_pixel_event_update

• Adds a parameter for a pixel event to capture

  Creates a new parameter extractor, such as value or currency, for pixel events.

  Try: “Capture the order total as the value parameter on purchases.”

  Write · ads_pixel_parameter_create

• Changes an existing pixel parameter

  Updates an existing pixel parameter.

  Try: “Change the currency parameter to read from the checkout page.”

  Write · ads_pixel_parameter_update

• Deletes a pixel event rule

  Deletes an event rule from a pixel.

  Try: “Delete the old Lead event rule.”

  Delete · ads_pixel_event_delete

• Deletes a pixel parameter

  Deletes a parameter from a pixel.

  Try: “Remove the unused content_type parameter.”

  Delete · ads_pixel_parameter_delete

• Lists A/B tests and lift studies on an ad account

  Lists the studies on an ad account, optionally for one campaign or study type.

  Try: “List my A/B tests.”

  Network · ads_experiment_list_tests

• Shows an A/B test's status and results

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

  Try: “What were the results of my creative A/B test?”

  Network · ads_experiment_abtest_get_test

• Shows a conversion lift study's status and results

  Gets the details, status and results of an existing conversion lift study.

  Try: “What did my lift study find?”

  Network · ads_experiment_lift_get_test

• Checks whether an account or campaign can run an A/B test

  Checks whether an ad account or set of campaigns is eligible for A/B testing before you create one.

  Try: “Can I run an A/B test on these two campaigns?”

  Network · ads_experiment_check_eligibility

• Creates an A/B test between campaigns or ad sets

  Creates a new A/B test by defining the groups to compare.

  Try: “Set up an A/B test comparing my video and image ad sets for two weeks.”

  Write · ads_experiment_abtest_create_test

• Edits or cancels an A/B test

  Edits or cancels an existing A/B test.

  Try: “Cancel my running A/B test.”

  Write · ads_experiment_abtest_update_test

• Starts a conversion lift study

  Creates a new conversion lift study on an ad account to measure the extra sales your ads drive.

  Try: “Start a conversion lift study for my Spring Sale campaign.”

  Write · ads_experiment_lift_create_test

• Used by the assistant behind the scenes

  Looks up which ad fields and values can be used in reports

  Looks up metadata for ad fields, such as type, filter support and allowed values, before a reporting query.

  Try: “Which fields can I break down campaign results by?”

  Network · ads_get_field_context

• Turns a plain request like "red dresses under $50" into a filter

  Converts a natural-language product request into a catalog filter that other tools then use. It does not change the catalog.

  Try: “Build a filter for red dresses under $50 that are in stock.”

  Network · ads_catalog_get_suggested_filter

• Starts an upload session for a feed file

  Starts a new upload session for a feed, used for uploading product files in chunks.

  Try: “Start an upload for my new product file.”

  Write · ads_catalog_create_product_feed_upload_session

• Lists feed uploads with their status and errors

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

  Try: “Did my last feed upload have errors?”

  Network · ads_catalog_get_product_feed_upload_sessions

Watch out for

• It can launch ads that spend real money

  New campaigns start paused, but activating one starts spending your budget. Block activation or cap budgets with ads MCP server rules in Business Suite. developers.facebook.com

• It can delete audiences, products and feeds

  Tools delete custom audiences, catalog products, product sets, feeds and pixel event rules. Review every delete before you approve it. developers.facebook.com

• It can upload customer lists

  One tool adds or removes people on customer list audiences from hashed personal data. Only allow it if you have consent to use that data for ads. developers.facebook.com

• Connecting it does not by itself risk a ban

  Meta says account bans come from breaking its ad policies, not from using the server. facebook.com

Security advisories