Meta Ads MCP API reference
Every Meta Ads tool the MCP server exposes, with its parameters. 57 tools, 190 metrics and 143 dimensions, on a dedicated endpoint.
74 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
- 57, 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 Meta campaign. | 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 the daily or lifetime budget of a Meta ad set. | Write | On demand |
meta_ | Update targeting, optimization, placements, attribution, bidding, budget or schedule. | 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 |
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 (34)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_ | 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_ | 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_ | Read Facebook Page posts and Instagram media with URLs, native periods and optional 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_ | Resolve fresh download URLs (source) and thumbnails for specific ad videos. | 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_ | 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:/ |