Meta Ads MCP API reference
Every Meta Ads tool the MCP server exposes, with its parameters. 39 tools, 190 metrics and 143 dimensions, on a dedicated endpoint.
48 rows
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 requestedLink to this section
| 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 |
CataloguesLink to this section
Write tools (10)Link to this section
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 a Meta campaign. | Write | On demand |
meta_rename_ad | Rename a Meta ad. | Write | On demand |
meta_ | Rename a Meta ad set. | Write | On demand |
meta_ | Rename a Meta campaign. | Write | On demand |
meta_ | Pause or reactivate a Meta ad. | Write | On demand |
meta_ | Change the daily or lifetime budget of a Meta ad set. | Write | On demand |
meta_ | Change the start or end time of a Meta ad set. | Write | On demand |
meta_ | Pause or reactivate a Meta ad set. | Write | On demand |
meta_ | Change the budget of a Meta campaign that holds its budget at campaign level (Advantage campaign budget). | Write | On demand |
meta_ | Pause or reactivate a Meta campaign. | Write | On demand |
Read tools (29)Link to this section
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 | Check the current access token validity, expiration, and granted scopes. | Read | On demand |
meta_ | Get detailed information for a specific Meta ad account: name, currency, timezone, spend cap, status, business info. | Read | On demand |
meta_ | Read ad account activity logs from /{ad_account_id}/activities with object, event, actor, timestamp, and extra_data fields. | Read | On demand |
meta_ | List conversion lift studies and A/B tests (Ad Studies) for an ad account. | Read | On demand |
meta_get_ads | List ads for a Meta ad account, optionally filtered by ad set. | Read | On demand |
meta_get_adsets | List ad sets for a Meta ad account, optionally filtered by campaign. | Read | On demand |
meta_ | Read detailed custom, saved, and lookalike audiences with pagination and rich fields where permissions allow. | Read | On demand |
meta_ | List custom, saved, and lookalike audiences for a Meta ad account. | Read | On demand |
meta_ | Read brand safety, suitability, placement, and context-control signals from ad account/ad set targeting and optional block-list edges. | Read | On demand |
meta_ | Discover accessible Meta Business assets read-only: businesses, pages, Instagram accounts, pixels, and datasets when permissions allow. | Read | On demand |
meta_ | Get hierarchical campaign structure: campaigns -> ad sets -> ads. | Read | On demand |
meta_ | List campaigns for a Meta ad account. | Read | Announced |
meta_ | Read Product Catalogs and Product Items when catalog access is available. | Read | On demand |
meta_ | 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 ad creative content: text, images, videos, links, call-to-action. | Read | On demand |
meta_ | 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_ | Query Meta Ads performance insights. | Read | Announced |
meta_ | List Instagram accounts linked to accessible Pages, Business Manager assets, or an ad account when permissions allow. | Read | On demand |
meta_ | Enrich Facebook Page posts and Instagram organic media with media URLs, permalinks, counts, attachments, and optional read-only insights. | Read | On demand |
meta_ | Get recent posts from a connected Facebook/Instagram page. | Read | On demand |
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 | 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 detailed results for a conversion lift or A/B test study. | Read | On demand |
meta_ | 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_ | Read and interpret A/B test or conversion lift study results with confidence guardrails, cells, objectives, and optional cell entities. | Read | On demand |
meta_ | Query product-breakdown insights and enrich rows with Product Catalog metadata when catalog access is available. | Read | On demand |
meta_ | List all Meta ad accounts accessible with the current token. | Read | Announced |
meta_ | Search campaigns, ad sets, or ads by name within an ad account. | Read | On demand |
meta_ | Validate a metric/breakdown combination BEFORE executing. | Read | On demand |
MCP resourcesLink to this section
Read these with resources/read for machine readable metadata about the source.
| Name | URI |
|---|---|
| meta-metrics | meta://metrics |
| meta-breakdowns | meta:/ |
| meta-compatibility | meta:/ |
| meta-manifest | meta://manifest |
| meta-recipes | meta://recipes |
| meta-p2-readonly | meta:/ |
| meta-app-review | meta:/ |