Meta Ads MCP API reference
Every Meta Ads tool the MCP server exposes, with its parameters. 59 tools, 190 metrics and 143 dimensions, on a dedicated endpoint.
76 rows
Facebook and Instagram delivery, creatives, audiences, lift studies, catalogue joins.
To connect another identity without replacing your existing access, open this source in the dashboard and choose Add another account. Select accounts from the combined list and save. See account scoping for selection, plan limits and reconnection.
Connection
- Platform id
meta_ads- Tool prefix
meta_- Account parameter
adAccountId- Dedicated endpoint
- https:/
/ mcp. getmcpads. com/ meta-ads/ mcp - Access
- Available for authorized, selected accounts.
- Tools
- 59, 23 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 | 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_ | 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 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_ | Read insights for your Instagram professional account and media. | No |
catalog_ | Read product catalogs and create or update products and product sets. Writes require a paid plan and explicit confirmation. | Yes |
CataloguesLink to this section
Write tools (23)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 or update up to 50 catalog products by retailer_id. | Write | On demand |
meta_create_ad | Create a PAUSED ad using an existing ad set and creative from the selected account. | Write | On demand |
meta_ | Create an ad creative from an existing post or an explicit object_story_spec and optional asset_feed_spec. | Write | On demand |
meta_ | Create a PAUSED Meta ad set with explicit targeting, optimization, placements, attribution, bidding and schedule. | Write | On demand |
meta_ | Create a PAUSED Meta campaign with either ad set budgets (omit campaign budget), a daily campaign budget, or a lifetime campaign budget. | Write | On demand |
meta_ | Create a website, engagement, customer-list container or lookalike audience. | Write | On demand |
meta_ | Create a filtered product set in a catalog owned by the same Business as the selected ad account. | Write | On demand |
meta_ | Duplicate a known-good ad set within the selected account, preserving complex native configuration. | 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_ | Replace an ad’s creative with another existing creative from the same account. | Write | On demand |
meta_ | Pause or reactivate a Meta ad. | Write | On demand |
meta_ | Change an ad set daily or lifetime budget after checking its parent budget and existing schedule. | Write | On demand |
meta_ | Update targeting, optimization, placements, attribution, bidding, budget or schedule. | Write | On demand |
meta_ | Change start and/or end time using ISO 8601 with an explicit offset. | Write | On demand |
meta_ | Pause or reactivate a Meta ad set. | Write | On demand |
meta_ | Change an existing campaign-owned budget after verifying currency and ownership. | Write | On demand |
meta_ | Pause or reactivate a Meta campaign. | Write | On demand |
meta_ | Update an existing custom audience name, description, retention or complete rule. | Write | On demand |
meta_ | Replace a product set filter or rename it. | Write | On demand |
meta_ | Upload an image into the selected ad account using base64 bytes (up to 5 MiB decoded). | Write | On demand |
meta_ | Import a video from a publicly reachable HTTPS URL or base64 MP4 bytes (up to 5 MiB decoded). | Write | On demand |
Read tools (36)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 | Inspect token identity, validity, expiry and scopes using server app credentials. | 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_ | Read an existing ad set, its parent campaign budget/objective and account currency before preparing an edit. | 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 the completion and per-item errors for a catalog batch handle. | Read | On demand |
meta_ | Read Product Catalogs and Product Items when catalog access is available. | Read | On demand |
meta_ | 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 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_ | Meta performance. | Read | Announced |
meta_ | List Instagram accounts linked to accessible Pages, Business Manager assets, or an ad account when permissions allow. | Read | On demand |
meta_ | Read Facebook Page posts and Instagram media with URLs, native periods and optional insights. | Read | On demand |
meta_ | Read published Facebook Page posts using a Page token resolved from the connected user. | 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_ | Check video processing and membership in the selected account library. | Read | On demand |
meta_ | Resolve fresh download URLs (source) and thumbnails for specific ad videos. | Read | On demand |
meta_ | Read-only connection diagnostic: inspects token identity and granted permissions, and lists accessible selected ad accounts. | Read | Announced |
meta_ | Read a specific acknowledged Launcher entity in its ad account for reconciliation. | Read | On demand |
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_ | 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 the ad account video library (/advideos): title, duration, processing status, and publicly served thumbnails (preferred and largest sizes). | 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:/ |