# Meta Ads

> Every Meta Ads tool the MCP server exposes, with its parameters. 39 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 | 39, 10 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` | Pause, resume and change budgets on Meta campaigns, ad sets and ads. Only reachable on a paid plan. | 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 (10)

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_create_campaign`](https://www.getmcpads.com/docs/sources/meta-ads/tools/meta_create_campaign) | Create a Meta campaign. | 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_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_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 |

## Read tools (29)

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_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_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 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. | Read | On demand |
| [`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) | Enrich Facebook Page posts and Instagram organic media with media URLs, permalinks, counts, attachments, and optional read-only 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_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_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`.