Skip to content
Changelog

Report a bug

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 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.

Get started

  1. Open Space settings → Connections and search for Meta Ads.
  2. Connect your account and add the connection to the Space.
  3. Ask for what you need in any thread in that Space.

See How connections work for access and permissions, or browse all integrations.