MCP server

Meta AdsMCP Server

Facebook and Instagram delivery, creatives, audiences, lift studies, catalogue joins.

https://mcp.getmcpads.com/meta-ads/mcp

Start free

This endpoint serves Meta Ads on its own. One shared URL reaches every platform you connect.

39
Tools: 10
That write: 190
Metrics: 143
Dimensions

What you can ask it.

Real questions, with the tools each one resolves to. Every tool named below is in the catalogue on this page.

6 questions

Why has this Meta ad set stopped spending its budget?

Reads Meta's own delivery diagnostics for the ad set, then the audience size, the schedule and the recent insights, and names the constraint rather than guessing at it.

meta_get_delivery_diagnosticsmeta_get_adsetsmeta_get_insights

Did our brand lift study actually prove anything?

Pulls the study, its results and the confidence intervals, then reads them back in plain language, including when the answer is that the test was underpowered.

meta_get_ad_studiesmeta_get_study_resultsmeta_interpret_experiment_results

Spend, CPA and ROAS by campaign across all four platforms, last 7 days against the 7 before.

One request, four APIs. Each platform's insights tool plans its own query, then the assistant lines the rows up in a single table.

meta_get_insightsgoogle_ads_get_insightstiktok_get_insightspinterest_run_report

Which Meta creatives carried last week, and which ones should we retire?

Reads ad-level insights against the creative behind each ad, so the table names the asset and the hook rather than an ad ID.

meta_get_creativesmeta_get_insightsmeta_get_ads

Which catalogue products are our Meta ads actually selling?

Joins product-level insights to the catalogue, so the report names the product, its brand and its custom labels instead of returning item IDs.

meta_join_product_insightsmeta_get_catalog_productsmeta_get_insights

Pause every Meta ad set above 60 EUR CPA over the last 14 days.

Reads the insights first, then returns the exact list of ad sets it would pause and stops. It only applies the change when you confirm.

meta_get_insightsmeta_get_adsetsmeta_update_adset_status

Every question, across every platform

The work it does every week.

Audits, weekly reports and the rest of the recurring jobs that call a Meta Ads tool. Each one is written against the shipped gateway, so following it works.

Every Meta Ads tool, as the gateway ships it.

Each description is the one the tool reports to your assistant during discovery, which is what it reads before deciding to call it.

10 write

What it can change: Pause or resume a campaign, ad set or single ad. Rename any of the three. Change an ad set or campaign budget, and an ad set schedule. Create a campaign, always paused. Every write previews first.

39 tools

meta_health_check
Agent-ready read-only health check: validates token metadata, lists accessible ad accounts, and warns about missing read scopes without exposing the access token.
meta_get_business_assets
Discover accessible Meta Business assets read-only: businesses, pages, Instagram accounts, pixels, and datasets when permissions allow.
meta_get_pages
List accessible Facebook Pages with id, name, category, tasks, picture, and linked Instagram account references when available.
meta_get_instagram_accounts
List Instagram accounts linked to accessible Pages, Business Manager assets, or an ad account when permissions allow.
meta_get_pixels
List pixels and datasets from an ad account or Business Manager when accessible, returning actionable warnings for permission-limited edges.
meta_get_ad_activity
Read ad account activity logs from /{ad_account_id}/activities with object, event, actor, timestamp, and extra_data fields.
meta_get_delivery_diagnostics
Aggregate read-only delivery diagnostics across campaigns, ad sets, and ads using status/effective_status/issues_info where available plus simple delivery insights.
meta_get_creative_assets
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.
meta_get_audience_details
Read detailed custom, saved, and lookalike audiences with pagination and rich fields where permissions allow.
meta_get_catalog_products
Read Product Catalogs and Product Items when catalog access is available.
meta_join_product_insights
Query product-breakdown insights and enrich rows with Product Catalog metadata when catalog access is available.
meta_get_brand_safety_controls
Read brand safety, suitability, placement, and context-control signals from ad account/ad set targeting and optional block-list edges.
meta_interpret_experiment_results
Read and interpret A/B test or conversion lift study results with confidence guardrails, cells, objectives, and optional cell entities.
meta_get_organic_content_enrichment
Enrich Facebook Page posts and Instagram organic media with media URLs, permalinks, counts, attachments, and optional read-only insights.
meta_list_ad_accounts
List all Meta ad accounts accessible with the current token.
meta_get_account_details
Get detailed information for a specific Meta ad account: name, currency, timezone, spend cap, status, business info.
meta_get_campaigns
List campaigns for a Meta ad account. Returns campaign ID, name, status, objective, budget, and bid strategy.
meta_get_adsets
List ad sets for a Meta ad account, optionally filtered by campaign.
meta_get_ads
List ads for a Meta ad account, optionally filtered by ad set.
meta_get_insights
Query Meta Ads performance insights. Supports 170+ metrics, 43+ breakdowns with intelligent query planning. Use meta://metrics resource to see available metrics. Use.
meta_get_campaign_structure
Get hierarchical campaign structure: campaigns -> ad sets -> ads.
meta_get_creatives
Get ad creative content: text, images, videos, links, call-to-action.
meta_get_audiences
List custom, saved, and lookalike audiences for a Meta ad account.
meta_get_ad_studies
List conversion lift studies and A/B tests (Ad Studies) for an ad account.
meta_get_study_results
Get detailed results for a conversion lift or A/B test study.
meta_validate_query
Validate a metric/breakdown combination BEFORE executing.
meta_get_page_posts
Get recent posts from a connected Facebook/Instagram page.
meta_debug_token
Check the current access token validity, expiration, and granted scopes.
meta_search_entities
Search campaigns, ad sets, or ads by name within an ad account.
meta_update_campaign_statuswrite
Pause or reactivate a Meta campaign.
meta_update_adset_statuswrite
Pause or reactivate a Meta ad set.
meta_update_ad_statuswrite
Pause or reactivate a single Meta ad.
meta_update_adset_budgetwrite
Change an ad set's daily or lifetime budget, in the account currency.
meta_create_campaignwrite
Create a Meta campaign. Always created PAUSED, with no option to create it active.
meta_rename_adwrite
Rename a Meta ad. The name is the only thing that changes.
meta_rename_adsetwrite
Rename a Meta ad set. The name is the only thing that changes.
meta_rename_campaignwrite
Rename a Meta campaign. The name is the only thing that changes.
meta_update_adset_schedulewrite
Change the start or end time of a Meta ad set.
meta_update_campaign_budgetwrite
Change the budget of a Meta campaign that holds its budget at campaign level (Advantage campaign budget).

What you can measure, and how you can cut it.

The full catalogues live in the reference, where every entry carries the API field it maps to and the constraints that come with it. Here is their shape.

Metrics

190

5 families

Conversion87
Video32
Cost27
Delivery27
Engagement17

All 190 metrics

Dimensions

143

15 families

All 143 dimensions

Everything else about it.

The reference, the catalogues, and how to put Meta Ads in front of your assistant.

The other five servers