Meta Ads integration: operations for AI agents
Meta Ads connects to Type.com as an integration. This page lists the 88 operations documented for Claude and Codex in Type.com: 52 read, 26 write, 10 destructive.
About Meta Ads
Analyze and manage Meta advertising through Meta's official hosted MCP server
How to connect Meta Ads to Type.com
- Connect
- Sign in with the provider (OAuth)
- Access
- Organization connection: one shared account for the workspace.
To add the connection, follow the steps in Space connections.
Documented operations
88 operations. Your connection's permissions determine which operations are available.
88 operations listed.
- Read
ads experiment list tests
List studies on an ad account, optionally scoped to a specific ad entity or study type.
- Read
ads experiment check eligibility
Check whether an ad account or set of entities is eligible for A/B testing before you try to create one.
- Read
ads experiment abtest get test
Retrieve details, status, and results of an existing A/B test.
- Read
ads experiment lift get test
Retrieve details, status, and results of an existing lift study.
- Read
ads account get activity logs
Retrieve activity log entries for an ad account, optionally scoped by object, time window, event category, or user.
- Read
ads get ad accounts
List the ad accounts the user has access to (name, status, currency, timezone).
- Read
ads get ad account pages
List Facebook Pages that have been used for ads on a specific ad account.
- Read
ads get pages for business
List Facebook Pages owned by a business.
- Read
ads get user pages
List all Facebook Pages the user can use for advertising, across their businesses.
- Read
ads get field context
Look up metadata for ad fields (type, filterability, enum values, supported entity levels) before calling ads_get_ad_entities.
- Read
ads get creatives
List ad creatives in an ad account.
- Read
ads get creative ads
List the ads that use a specific creative.
- Read
ads get ad images
List ad images uploaded to an ad account.
- Read
ads get ad videos
List ad videos uploaded to an ad account.
- Read
ads get ad preview
Render a preview of an ad or creative in a specific placement (Feed, Story, Reels, and so on).
- Read
ads get ad entities
Search and retrieve campaigns, ad sets, and ads (also the primary reporting tool — see Comprehensive reporting).
- Read
ads library search
Search the public Meta Ad Library for competitive research and creative inspiration.
- Read
ads get ig accounts
List Instagram Business or Creator Accounts linked to an ad account.
- Read
ads get ig media
List recent media (posts, reels, stories) on an Instagram Business or Creator Account, filtered to boost-eligible items.
- Read
ads get ad account custom audiences
List custom audiences on an ad account (optionally filtered by subtype).
- Read
ads get custom audience
Get details for a single custom audience (size, status, subtype).
- Read
ads get custom audience adsets
List the ad sets currently targeting a given custom audience.
- Read
ads catalog list catalogs
List accessible catalogs, list catalogs for a business or ad account, or retrieve one catalog with its counts.
- Read
ads catalog list dpa eligible catalogs
Find and rank catalogs eligible for dynamic ads or Advantage+ catalog ads for an ad account, and return a recommended catalog when available. Supports optional landing-page URL, pixel, Page, and ad-format context, plus optional catalog health signals.
- Read
ads catalog get diagnostics
List issues on a catalog (errors, warnings, opportunities) that may affect ad delivery.
- Read
ads catalog get dynamic ads health
Check whether a catalog (or product set) is healthy enough to serve Advantage+ catalog ads.
- Read
ads catalog get data sources
List all data sources associated with a catalog (feed URLs, uploads, API sources).
- Read
ads catalog list products
List products in a catalog or product set, search with a structured filter, or retrieve one product.
- Read
ads catalog get suggested filter
Convert a natural-language product selection, such as “red dresses under $50 that are in stock,” into a catalog-specific product-set filter. Use the returned filter to list matching products or create or update a product set. This tool only generates the filter; it does not retrieve products or modify the catalog.
- Read
ads catalog list product sets
List product sets in a catalog, retrieve one product set, or list sets that contain a product.
- Read
ads catalog list product feeds
List feeds in a catalog or retrieve one feed with its configuration, schedule, and status.
- Read
ads catalog get product feed upload sessions
List upload sessions for a feed, including status and error counts.
- Read
ads catalog get feed rules
List the supplementary rules applied to a feed.
- Read
ads catalog event source get
List the event sources (pixels, apps, or offline conversion data sets) connected to a catalog.
- Read
ads catalog event source get catalogs
Get the catalogs connected to a given event source (pixel, app, or offline conversion data set).
- Read
ads catalog event source get health
Report the match rate and setup issues for a catalog’s connected event sources, including 28-day historical match rate stats.
- Read
ads catalog event source get recommendations
Recommend event sources to connect to a catalog with weak or missing signal coverage, based on which sources’ conversion events best match the catalog’s products.
- Read
ads get opportunity score
Return the ad account’s optimization score (0–100) along with actionable recommendations for improving performance.
- Read
ads insights advertiser context
Summarize business context and marketing funnel to help pick the right optimization goal.
- Read
ads insights anomaly signal
Detect unusual patterns or deviations in ad performance that warrant investigation.
- Read
ads insights auction ranking benchmarks
Show which ads performed best in the auction and where bid or ad-quality investment would help.
- Read
ads insights industry benchmark
Compare ad set performance against benchmarks from similar advertisers.
- Read
ads insights performance trend
Track how key performance metrics (CPC, CPM, cost per result, ROAS, CTR, conversion rate) change over time.
- Read
ads get errors
Return delivery-blocking errors for campaigns, ad sets, ads, or an ad account.
- Read
ads get help article
Search Meta Business Help Center for articles about advertising concepts, policies, or troubleshooting guidance.
- Read
ads get datasets
List datasets (pixels or applications) on a business or ad account.
- Read
ads get dataset details
Get metadata and configuration for a dataset, including Conversions API setup.
- Read
ads get dataset stats
Report event volume received by a dataset over a configurable window (up to 28 days), with optional breakdown by device or event source.
- Read
ads get dataset quality
Report Event Match Quality (EMQ) scores, per-match-key coverage, and data freshness by channel.
- Read
ads pixel event read
List event rules on a pixel, or fetch a single rule by ID.
- Read
ads pixel parameter read
List parameters on a pixel, or fetch a single parameter by ID.
- Read
ads get customconversions
List custom conversions defined on an ad account.
- Write
ads experiment abtest create test
Create a new A/B test by defining test cells.
- Write
ads experiment lift create test
Create a new conversion lift study on an ad account.
- Write
ads create campaign
Create a new ad campaign (paused).
- Write
ads create ad set
Create an ad set with targeting, budget, and optimization goal under a campaign (paused).
- Write
ads create ad
Create an ad with a creative under an ad set (paused).
- Write
ads update entity
Update fields on an existing campaign, ad set, or ad.
- Write
ads activate entity
Change a paused campaign, ad set, or ad to active — starts spending budget.
- Write
ads create creative
Create a single-image link ad creative. Also supports placement customization or multi-media optimization using images, videos, or both (limited availability).
- Write
ads boost ig post
Turn an existing organic Instagram post into a boosted ad.
- Write
ads create custom audience
Create a new custom audience (customer file, website, lookalike, app, engagement, or offline conversion).
- Write
ads update custom audience
Update the name, description, rule, or labels on an existing custom audience.
- Write
ads catalog create
Create a new product catalog and optionally upload initial product data via a feed URL, inline items, or file upload.
- Write
ads catalog update catalog
Update settings on an existing catalog (for example, rename it).
- Write
ads catalog product create
Create a product in a catalog.
- Write
ads catalog update product
Update a product’s fields (name, price, availability, brand, and so on).
- Write
ads catalog create product set
Create a dynamic product set from a filter rule.
- Write
ads catalog update product set
Update a product set’s name, filter, or retailer ID.
- Write
ads catalog create product feed
Register a new product feed on a catalog (optionally scheduled to fetch from a URL).
- Write
ads catalog update product feed
Update a feed’s name, currency defaults, parsing options, or schedules.
- Write
ads catalog create product feed upload session
Start a new upload session for a feed (used for chunked uploads).
- Write
ads catalog create feed rule
Create a supplementary rule that maps or transforms an attribute on a feed.
- Write
ads catalog event source connect
Connect an event source (pixel, app, or offline conversion data set) to a catalog so its signals can be matched against catalog products for dynamic ads and Advantage+ catalog ads.
- Write
ads pixel event create
Create a new event rule on a pixel (starts inactive).
- Write
ads pixel event update
Activate or deactivate an existing event rule.
- Write
ads pixel parameter create
Create a new parameter extractor.
- Write
ads pixel parameter update
Update an existing parameter.
- Destructive
ads experiment abtest update test
Edit or cancel an existing A/B test.
- Destructive
ads update custom audience users
Add or remove users on a customer list audience by uploading hashed personal data.
- Destructive
ads delete custom audience
Delete a custom audience.
- Destructive
ads catalog delete product
Delete a product from a catalog.
- Destructive
ads catalog product set delete
Delete a product set and its filter rule. Products themselves are not deleted; only the set that groups them.
- Destructive
ads catalog product feed delete
Delete a product feed and its schedule. Products ingested by the feed are also removed asynchronously; products also supplied by another data source are kept.
- Destructive
ads catalog product feed delete rule
Delete a transformation rule from a product feed. The feed and its products are not affected.
- Destructive
ads catalog event source disconnect
Disconnect an event source from a catalog, so its signals are no longer matched against catalog products.
- Destructive
ads pixel event delete
Delete an event rule.
- Destructive
ads pixel parameter delete
Delete a parameter.
No operations match.
Get started
- Open Space settings → Connections and search for Meta Ads.
- Connect your account and add the connection to the Space.
- Ask for what you need in any thread in that Space.
See How connections work for access and permissions, or browse all integrations.