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.
LABSCO SUMMARY
Per-tool scopes mean a reporting connection and a spending connection are genuinely different grants.
Advertising APIs move money, and Meta's answer is granularity at the consent screen: an analyst's client can be given reporting and diagnostics without the ability to create a campaign. The inclusion of signal and dataset health is the underrated part — most spending problems on Meta trace back to a broken pixel or a bad feed, and having that diagnosable in the same conversation as the reporting is where the time is saved.
What it is
Meta's hosted endpoint for advertising. Seven capability groups, spanning the analysis, the editing and the diagnostics an advertiser needs.
What you get
- Detailed reporting and campaign insights
- Creating and editing ads, ad sets and campaigns
- Catalogue creation and management, including product data and feed troubleshooting
- Signals and dataset health and quality
- Search across the Meta Business Help Center
- A/B tests and conversion lift studies
- Activity logs matching the history in Ads Manager
Requirements
Meta account OAuth, with per-tool scopes chosen on the consent screen and revocable from Meta account settings.
Setup effort
Paste a URL, then authorize — add the endpoint to your client, then approve the OAuth consent screen
USE CASES
01
Explaining a spend change
Pull reporting and campaign insights, then check the activity log for what changed and when.
02
Diagnosing a broken feed
Troubleshoot catalogue product data and check signal and dataset quality.
03
Measuring incrementality
Set up A/B tests and conversion lift studies rather than reading platform-attributed ROAS.
04
Giving read-only access
Choose reporting scopes at consent and leave campaign editing out.
91 tools
Listed in project docs. Your client may show a different list.
ads_get_opportunity_score
Return the ad account's optimization score (0–100) along with actionable recommendations for improving performance.
ads_insights_advertiser_context
Summarize business context and marketing funnel to help pick the right optimization goal.
ads_insights_anomaly_signal
Detect unusual patterns or deviations in ad performance that warrant investigation.
ads_insights_auction_ranking_benchmarks
Show which ads performed best in the auction and where bid or ad-quality investment would help.
ads_insights_industry_benchmark
Compare ad set performance against benchmarks from similar advertisers.
ads_insights_performance_trend
Track how key performance metrics (CPC, CPM, cost per result, ROAS, CTR, conversion rate) change over time.
ads_get_ad_accounts
List the ad accounts the user has access to (name, status, currency, timezone).
ads_get_ad_account_pages
List Facebook Pages that have been used for ads on a specific ad account.
ads_get_pages_for_business
List Facebook Pages owned by a business.
ads_get_user_pages
List all Facebook Pages the user can use for advertising, across their businesses.
ads_get_field_context
Look up metadata for ad fields (type, filterability, enum values, supported entity levels) before calling ads_get_ad_entities.
ads_create_campaign
Create a new ad campaign (paused).
ads_create_ad_set
Create an ad set with targeting, budget, and optimization goal under a campaign (paused).
ads_create_ad
Create an ad with a creative under an ad set (paused).
ads_update_entity
Update fields on an existing campaign, ad set, or ad.
ads_activate_entity
Change a paused campaign, ad set, or ad to active — starts spending budget.
ads_create_creative
Create a single-image link ad creative.
ads_get_creatives
List ad creatives in an ad account.
ads_get_creative_ads
List the ads that use a specific creative.
ads_get_ad_images
List ad images uploaded to an ad account.
ads_get_ad_videos
List ad videos uploaded to an ad account.
ads_get_ad_preview
Render a preview of an ad or creative in a specific placement (Feed, Story, Reels, and so on).
ads_library_search
Search the public Meta Ad Library for competitive research and creative inspiration.
ads_get_ig_accounts
List Instagram Business or Creator Accounts linked to an ad account.
ads_get_ig_media
List recent media (posts, reels, stories) on an Instagram Business or Creator Account, filtered to boost-eligible items.
ads_boost_ig_post
Turn an existing organic Instagram post into a boosted ad.
ads_get_ad_account_custom_audiences
List custom audiences on an ad account (optionally filtered by subtype).
ads_get_custom_audience
Get details for a single custom audience (size, status, subtype).
ads_get_custom_audience_adsets
List the ad sets currently targeting a given custom audience.
ads_create_custom_audience
Create a new custom audience (customer file, website, lookalike, app, engagement, or offline conversion).
ads_update_custom_audience
Update the name, description, rule, or labels on an existing custom audience.
ads_update_custom_audience_users
Add or remove users on a customer list audience by uploading hashed personal data.
ads_delete_custom_audience
Delete a custom audience.
ads_catalog_create
Create a new product catalog and optionally upload initial product data via a feed URL, inline items, or file upload.
ads_catalog_update_catalog
Update settings on an existing catalog (for example, rename it).
ads_catalog_get_catalogs
List product catalogs, optionally filtered by business or name.
ads_catalog_get_details
Retrieve details about a catalog — name, vertical, item count, business ownership, and (optionally) feeds.
ads_catalog_get_diagnostics
List issues on a catalog (errors, warnings, opportunities) that may affect ad delivery.
ads_catalog_get_dynamic_ads_health
Check whether a catalog (or product set) is healthy enough to serve Advantage+ catalog ads.
ads_catalog_get_data_sources
List all data sources associated with a catalog (feed URLs, uploads, API sources).
ads_catalog_get_product_details
Get details for a single product (name, price, availability, image).
ads_catalog_product_create
Create a product in a catalog.
ads_catalog_update_product
Update a product's fields (name, price, availability, brand, and so on).
ads_catalog_delete_product
Delete a product from a catalog.
ads_catalog_get_product_product_sets
List the product sets a given product belongs to.
ads_catalog_search_product
Search a catalog with a structured filter rule and preview matching products.
ads_catalog_create_product_set
Create a dynamic product set from a filter rule.
ads_catalog_update_product_set
Update a product set's name, filter, retailer ID, visibility, or parent.
ads_catalog_get_product_sets
List product sets in a catalog.
ads_catalog_get_product_set_details
Get details for a single product set, including its filter rule and match count.
ads_catalog_get_product_set_products
List products in a product set, with optional attribute filters.
ads_catalog_product_set_delete
Delete a product set and its filter rule. Products themselves are not deleted; only the set that groups them.
ads_catalog_create_product_feed
Register a new product feed on a catalog (optionally scheduled to fetch from a URL).
ads_catalog_update_product_feed
Update a feed's name, currency defaults, parsing options, or schedules.
ads_catalog_get_product_feed_details
Get feed configuration — URL, schedule, format, and status.
ads_catalog_create_product_feed_upload_session
Start a new upload session for a feed (used for chunked uploads).
ads_catalog_get_product_feed_upload_sessions
List upload sessions for a feed, including status and error counts.
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.
ads_catalog_create_feed_rule
Create a supplementary rule that maps or transforms an attribute on a feed.
ads_catalog_get_feed_rules
List the supplementary rules applied to a feed.
ads_catalog_product_feed_delete_rule
Delete a transformation rule from a product feed. The feed and its products are not affected.
ads_catalog_event_source_get
List the event sources (pixels, apps, or offline conversion data sets) connected to a catalog.
ads_catalog_event_source_get_catalogs
Get the catalogs connected to a given event source (pixel, app, or offline conversion data set).
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.
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.
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.
ads_catalog_event_source_disconnect
Disconnect an event source from a catalog, so its signals are no longer matched against catalog products.
ads_get_datasets
List datasets (pixels or applications) on a business or ad account.
ads_get_dataset_details
Get metadata and configuration for a dataset, including Conversions API setup.
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.
ads_get_dataset_quality
Report Event Match Quality (EMQ) scores, per-match-key coverage, and data freshness by channel.
ads_pixel_event_read
List event rules on a pixel, or fetch a single rule by ID.
ads_pixel_event_create
Create a new event rule on a pixel (starts inactive).
ads_pixel_event_update
Activate or deactivate an existing event rule.
ads_pixel_event_delete
Delete an event rule.
ads_pixel_parameter_read
List parameters on a pixel, or fetch a single parameter by ID.
ads_pixel_parameter_create
Create a new parameter extractor.
ads_pixel_parameter_update
Update an existing parameter.
ads_pixel_parameter_delete
Delete a parameter.
ads_get_customconversions
List custom conversions defined on an ad account.
ads_get_errors
Return delivery-blocking errors for campaigns, ad sets, ads, or an ad account.
ads_get_help_article
Search Meta Business Help Center for articles about advertising concepts, policies, or troubleshooting guidance.
ads_account_get_activity_logs
Retrieve activity log entries for an ad account, optionally scoped by object, time window, event category, or user.
ads_experiment_list_tests
List studies on an ad account, optionally scoped to a specific ad entity or study type.
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.
ads_experiment_abtest_create_test
Create a new A/B test by defining test cells.
ads_experiment_abtest_get_test
Retrieve details, status, and results of an existing A/B test.
ads_experiment_abtest_update_test
Edit or cancel an existing A/B test.
ads_experiment_lift_create_test
Create a new conversion lift study on an ad account.
ads_experiment_lift_get_test
Retrieve details, status, and results of an existing lift study.
BEFORE YOU INSTALL
What to know first
Tools you get
91 tools named in the project's documentation.
Requires
- an MCP client that can reach a remote endpoint
- Meta account OAuth with fine-grained per-tool scopes, revocable at any time in Meta account settings
INSTALLATION
Connect your client
Add the endpoint to your client, then approve the OAuth consent screen.
Server setup
ENDPOINT URL
https://mcp.facebook.com/adsRequirements
- Meta account OAuth with fine-grained per-tool scopes, revocable at any time in Meta account settings
