# Meta Ads

> Every Meta Ads tool the MCP server exposes, with its parameters. 57 tools, 190 metrics and 143 dimensions, on a dedicated endpoint.

[Documentation](https://www.getmcpads.com/docs) / [Sources](https://www.getmcpads.com/docs/sources)

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

Connection

|  |  |
| --- | --- |
| Platform id | `meta_ads` |
| Tool prefix | `meta_` |
| Account parameter | `adAccountId` |
| Dedicated endpoint | https://mcp.getmcpads.com/meta-ads/mcp |
| Tools | 57, 23 of which write |
| Metrics | 190 |
| Dimensions | 143 |

## Scope requested

| Scope | Grants | Allows writes |
| --- | --- | --- |
| `ads_read` | Read Meta campaigns, insights, creatives and audiences. | No |
| `ads_management` | Create and manage Meta campaigns, ad sets, ads, creatives and audiences, including budgets and status. Writes require a paid plan and explicit confirmation. | Yes |
| `business_management` | Access Business Manager assets, including owned and shared ad accounts, Pages and catalogs. This permission also permits Business Manager changes. | Yes |
| `pages_show_list` | List the Facebook Pages you manage and discover linked Instagram professional accounts. | No |
| `pages_read_engagement` | Read Page posts, media and engagement metadata used by your ads and content reports. | No |
| `pages_manage_ads` | Create and manage ads associated with your Facebook Pages. | Yes |
| `read_insights` | Read insights for Facebook Page content you can access. | No |
| `instagram_basic` | Read your linked Instagram professional account profile and media. | No |
| `instagram_manage_insights` | Read insights for your Instagram professional account and media. | No |
| `catalog_management` | Read product catalogs and create or update products and product sets. Writes require a paid plan and explicit confirmation. | Yes |

> **Note** What the gateway can change here: 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.

## Catalogues

- [Metrics](https://www.getmcpads.com/docs/sources/meta-ads/metrics): 190 metrics, with the field name each one maps to.
- [Dimensions](https://www.getmcpads.com/docs/sources/meta-ads/dimensions): 143 dimensions, with their constraints.

## Write tools (23)

Absent from the tool list on the Free plan. Each one previews by default and needs a second call with `confirm: true`.

| Tool | What it does | Kind | Discovery |
| --- | --- | --- | --- |
| [`meta_batch_catalog_items`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_batch_catalog_items) | Create or update up to 50 catalog products by retailer_id. | Write | On demand |
| [`meta_create_ad`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_create_ad) | Create a PAUSED ad using an existing ad set and creative from the selected account. | Write | On demand |
| [`meta_create_adcreative`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_create_adcreative) | Create an ad creative from an existing post or an explicit object_story_spec and optional asset_feed_spec. | Write | On demand |
| [`meta_create_adset`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_create_adset) | Create a PAUSED Meta ad set with explicit targeting, optimization, placements, attribution, bidding and schedule. | Write | On demand |
| [`meta_create_campaign`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_create_campaign) | Create a Meta campaign. | Write | On demand |
| [`meta_create_custom_audience`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_create_custom_audience) | Create a website, engagement, customer-list container or lookalike audience. | Write | On demand |
| [`meta_create_product_set`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_create_product_set) | Create a filtered product set in a catalog owned by the same Business as the selected ad account. | Write | On demand |
| [`meta_duplicate_adset`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_duplicate_adset) | Duplicate a known-good ad set within the selected account, preserving complex native configuration. | Write | On demand |
| [`meta_rename_ad`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_rename_ad) | Rename a Meta ad. | Write | On demand |
| [`meta_rename_adset`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_rename_adset) | Rename a Meta ad set. | Write | On demand |
| [`meta_rename_campaign`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_rename_campaign) | Rename a Meta campaign. | Write | On demand |
| [`meta_update_ad_creative`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_update_ad_creative) | Replace an ad’s creative with another existing creative from the same account. | Write | On demand |
| [`meta_update_ad_status`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_update_ad_status) | Pause or reactivate a Meta ad. | Write | On demand |
| [`meta_update_adset_budget`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_update_adset_budget) | Change the daily or lifetime budget of a Meta ad set. | Write | On demand |
| [`meta_update_adset_configuration`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_update_adset_configuration) | Update targeting, optimization, placements, attribution, bidding, budget or schedule. | Write | On demand |
| [`meta_update_adset_schedule`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_update_adset_schedule) | Change the start or end time of a Meta ad set. | Write | On demand |
| [`meta_update_adset_status`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_update_adset_status) | Pause or reactivate a Meta ad set. | Write | On demand |
| [`meta_update_campaign_budget`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_update_campaign_budget) | Change the budget of a Meta campaign that holds its budget at campaign level (Advantage campaign budget). | Write | On demand |
| [`meta_update_campaign_status`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_update_campaign_status) | Pause or reactivate a Meta campaign. | Write | On demand |
| [`meta_update_custom_audience`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_update_custom_audience) | Update an existing custom audience name, description, retention or complete rule. | Write | On demand |
| [`meta_update_product_set`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_update_product_set) | Replace a product set filter or rename it. | Write | On demand |
| [`meta_upload_ad_image`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_upload_ad_image) | Upload an image into the selected ad account using base64 bytes (up to 5 MiB decoded). | Write | On demand |
| [`meta_upload_ad_video`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_upload_ad_video) | Import a video from a publicly reachable HTTPS URL or base64 MP4 bytes (up to 5 MiB decoded). | Write | On demand |

## Read tools (34)

Tools marked *Announced* appear in your client's tool list. The rest are reachable through `search_tools` and `run_tool`, which run the same checks.

| Tool | What it does | Kind | Discovery |
| --- | --- | --- | --- |
| [`meta_debug_token`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_debug_token) | Check the current access token validity, expiration, and granted scopes. | Read | On demand |
| [`meta_get_account_details`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_get_account_details) | Get detailed information for a specific Meta ad account: name, currency, timezone, spend cap, status, business info. | Read | On demand |
| [`meta_get_ad_activity`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_get_ad_activity) | Read ad account activity logs from /{ad_account_id}/activities with object, event, actor, timestamp, and extra_data fields. | Read | On demand |
| [`meta_get_ad_studies`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_get_ad_studies) | List conversion lift studies and A/B tests (Ad Studies) for an ad account. | Read | On demand |
| [`meta_get_ads`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_get_ads) | List ads for a Meta ad account, optionally filtered by ad set. | Read | On demand |
| [`meta_get_adset_configuration`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_get_adset_configuration) | Read an existing ad set, its parent campaign budget/objective and account currency before preparing an edit. | Read | On demand |
| [`meta_get_adsets`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_get_adsets) | List ad sets for a Meta ad account, optionally filtered by campaign. | Read | On demand |
| [`meta_get_audience_details`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_get_audience_details) | Read detailed custom, saved, and lookalike audiences with pagination and rich fields where permissions allow. | Read | On demand |
| [`meta_get_audiences`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_get_audiences) | List custom, saved, and lookalike audiences for a Meta ad account. | Read | On demand |
| [`meta_get_brand_safety_controls`](https://www.getmcpads.com/docs/sources/meta-ads/tools/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. | Read | On demand |
| [`meta_get_business_assets`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_get_business_assets) | Discover accessible Meta Business assets read-only: businesses, pages, Instagram accounts, pixels, and datasets when permissions allow. | Read | On demand |
| [`meta_get_campaign_structure`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_get_campaign_structure) | Get hierarchical campaign structure: campaigns -> ad sets -> ads. | Read | On demand |
| [`meta_get_campaigns`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_get_campaigns) | List campaigns for a Meta ad account. | Read | Announced |
| [`meta_get_catalog_batch_status`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_get_catalog_batch_status) | Read the completion and per-item errors for a catalog batch handle. | Read | On demand |
| [`meta_get_catalog_products`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_get_catalog_products) | Read Product Catalogs and Product Items when catalog access is available. | Read | On demand |
| [`meta_get_creative_assets`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_get_creative_assets) | Return ad-linked creative media with actual ad names, collection covers, all carousel/flexible components, resolved image hashes and video URLs. | Read | Announced |
| [`meta_get_creatives`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_get_creatives) | Get ad creative content: text, images, videos, links, call-to-action. | Read | On demand |
| [`meta_get_delivery_diagnostics`](https://www.getmcpads.com/docs/sources/meta-ads/tools/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. | Read | Announced |
| [`meta_get_insights`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_get_insights) | Query Meta Ads performance insights. | Read | Announced |
| [`meta_get_instagram_accounts`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_get_instagram_accounts) | List Instagram accounts linked to accessible Pages, Business Manager assets, or an ad account when permissions allow. | Read | On demand |
| [`meta_get_organic_content_enrichment`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_get_organic_content_enrichment) | Read Facebook Page posts and Instagram media with URLs, native periods and optional insights. | Read | On demand |
| [`meta_get_page_posts`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_get_page_posts) | Get recent posts from a connected Facebook/Instagram page. | Read | On demand |
| [`meta_get_pages`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_get_pages) | List accessible Facebook Pages with id, name, category, tasks, picture, and linked Instagram account references when available. | Read | On demand |
| [`meta_get_pixels`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_get_pixels) | List pixels and datasets from an ad account or Business Manager when accessible, returning actionable warnings for permission-limited edges. | Read | On demand |
| [`meta_get_study_results`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_get_study_results) | Get detailed results for a conversion lift or A/B test study. | Read | On demand |
| [`meta_get_video_sources`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_get_video_sources) | Resolve fresh download URLs (source) and thumbnails for specific ad videos. | Read | On demand |
| [`meta_health_check`](https://www.getmcpads.com/docs/sources/meta-ads/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. | Read | Announced |
| [`meta_interpret_experiment_results`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_interpret_experiment_results) | Read and interpret A/B test or conversion lift study results with confidence guardrails, cells, objectives, and optional cell entities. | Read | On demand |
| [`meta_join_product_insights`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_join_product_insights) | Query product-breakdown insights and enrich rows with Product Catalog metadata when catalog access is available. | Read | On demand |
| [`meta_list_ad_accounts`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_list_ad_accounts) | List all Meta ad accounts accessible with the current token. | Read | Announced |
| [`meta_list_ad_images`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_list_ad_images) | List the ad account image library (/adimages): hash, name, dimensions, status, a permanent publicly served display URL (permalink_url), short-lived CDN URLs, and optionally the creatives using each image. | Read | Announced |
| [`meta_list_ad_videos`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_list_ad_videos) | List the ad account video library (/advideos): title, duration, processing status, and publicly served thumbnails (preferred and largest sizes). | Read | Announced |
| [`meta_search_entities`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_search_entities) | Search campaigns, ad sets, or ads by name within an ad account. | Read | On demand |
| [`meta_validate_query`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_validate_query) | Validate a metric/breakdown combination BEFORE executing. | Read | On demand |

## MCP resources

Read these with `resources/read` for machine readable metadata about the source.

| Name | URI |
| --- | --- |
| meta-metrics | `meta://metrics` |
| meta-breakdowns | `meta://breakdowns` |
| meta-compatibility | `meta://compatibility` |
| meta-manifest | `meta://manifest` |
| meta-recipes | `meta://recipes` |
| meta-p2-readonly | `meta://p2-readonly` |
| meta-app-review | `meta://app-review` |

---

This page as HTML: https://www.getmcpads.com/docs/sources/meta-ads
Every page under /docs is available as Markdown: append `.md`, or send `Accept: text/markdown`.