Skip to content
Get MCP AdsGet MCP Ads, home
Start free

MCP server

ChatGPT Ads MCP Server

Campaigns, ad groups, ads and image creatives, native performance, conversion tracking, product feeds, existing audiences and delivery diagnostics. Saved business reviews and reporting exports.
https://mcp.getmcpads.com/openai-ads/mcp
Start free

This endpoint serves ChatGPT Ads on its own. One shared URL reaches every platform you connect.

Connect with the Ads Management API key from Ads Manager Settings, then select the verified advertising account. Native account permissions and feature eligibility apply.

55
Tools
25
That write
11
Metrics
9
Dimensions

Ask it

What you can ask it.

Real questions, with the tools each one resolves to. Every tool named below is in the catalogue on this page.

3 questions

One exchange

You type the sentence into your assistant. ChatGPT Ads answers through the tools named here, and nothing else is called.

Every question, every platform

Claude

“Show ChatGPT Ads campaign performance and explain why an ad is not serving.”

Resolves to4 tools
  • openai_ads_get_account
  • openai_ads_get_campaigns
  • openai_ads_get_insights
  • openai_ads_get_ad

Reads the selected account's native report and delivery issues, preserving currency, timezone, attribution and pagination.

2 more

Prepare a ChatGPT Ads campaign and image ad, keeping everything paused.

Checks the account's goals and campaign settings, previews each change, then creates only after confirmation and verifies the campaign, group and ad.

openai_ads_get_write_contextopenai_ads_get_write_schemaopenai_ads_create_campaignopenai_ads_create_ad_groupopenai_ads_create_ad

Show the images behind my ChatGPT Ads and import this new creative.

Reads ad names and image assets from the native gallery, then previews a PNG, JPEG or WebP upload before confirmation.

openai_ads_list_ad_creativesopenai_ads_upload_imageopenai_ads_upload_image_url

The ledger

Every ChatGPT Ads tool, as the gateway ships it.

Each description is the one the tool reports to your assistant during discovery, which is what it reads before deciding to call it.

25 write

What it can change: Create paused campaigns, ad groups and image ads; edit budgets, bids, targeting, schedules and creative content. Upload images, pause or archive entities, and prepare bulk changes. Activation is a separate confirmed action. Every write previews before confirmation and requires a paid plan. Every write previews first.

55 tools

  • openai_ads_activate_adwrite

    Preview and confirm the native ChatGPT Ads activate ad contract. Saved approval, stable requestId and exact native state are required. Creates are always paused; activation is separately gated. No automatic write retry. Budgets and bids use integer account-currency micros. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_activate_ad_groupwrite

    Preview and confirm the native ChatGPT Ads activate ad group contract. Saved approval, stable requestId and exact native state are required. Creates are always paused; activation is separately gated. No automatic write retry. Budgets and bids use integer account-currency micros. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_activate_campaignwrite

    Preview and confirm the native ChatGPT Ads activate campaign contract. Saved approval, stable requestId and exact native state are required. Creates are always paused; activation is separately gated. No automatic write retry. Budgets and bids use integer account-currency micros. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_archive_adwrite

    Preview and confirm the native ChatGPT Ads archive ad contract. Saved approval, stable requestId and exact native state are required. Creates are always paused; activation is separately gated. No automatic write retry. Budgets and bids use integer account-currency micros. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_archive_ad_groupwrite

    Preview and confirm the native ChatGPT Ads archive ad group contract. Saved approval, stable requestId and exact native state are required. Creates are always paused; activation is separately gated. No automatic write retry. Budgets and bids use integer account-currency micros. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_archive_campaignwrite

    Preview and confirm the native ChatGPT Ads archive campaign contract. Saved approval, stable requestId and exact native state are required. Creates are always paused; activation is separately gated. No automatic write retry. Budgets and bids use integer account-currency micros. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_archive_feedwrite

    Preview and confirm the native ChatGPT Ads archive feed contract. Saved approval, stable requestId and exact native state are required. Creates are always paused; activation is separately gated. No automatic write retry. Budgets and bids use integer account-currency micros. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_create_adwrite

    Preview and confirm the native ChatGPT Ads create ad contract. Saved approval, stable requestId and exact native state are required. Creates are always paused; activation is separately gated. No automatic write retry. Budgets and bids use integer account-currency micros. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_create_ad_groupwrite

    Preview and confirm the native ChatGPT Ads create ad group contract. Saved approval, stable requestId and exact native state are required. Creates are always paused; activation is separately gated. No automatic write retry. Budgets and bids use integer account-currency micros. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_create_ad_previewwrite

    Preview and confirm the native ChatGPT Ads create ad preview contract. Saved approval, stable requestId and exact native state are required. Creates are always paused; activation is separately gated. No automatic write retry. Budgets and bids use integer account-currency micros. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_create_campaignwrite

    Preview and confirm the native ChatGPT Ads create campaign contract. Saved approval, stable requestId and exact native state are required. Creates are always paused; activation is separately gated. No automatic write retry. Budgets and bids use integer account-currency micros. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_create_conversion_pixelwrite

    Preview and confirm the native ChatGPT Ads create conversion pixel contract. Saved approval, stable requestId and exact native state are required. Creates are always paused; activation is separately gated. No automatic write retry. Budgets and bids use integer account-currency micros. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_create_conversion_settingwrite

    Preview and confirm the native ChatGPT Ads create conversion setting contract. Saved approval, stable requestId and exact native state are required. Creates are always paused; activation is separately gated. No automatic write retry. Budgets and bids use integer account-currency micros. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_create_feedwrite

    Preview and confirm the native ChatGPT Ads create feed contract. Saved approval, stable requestId and exact native state are required. Creates are always paused; activation is separately gated. No automatic write retry. Budgets and bids use integer account-currency micros. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_get_account

    Read the selected ChatGPT Ads account's name, currency, timezone and review status. This is an Ads Management key, separate from OpenAI Platform API keys.

  • openai_ads_get_ad

    Read one ChatGPT Ads ad, creative and review status within a selected account. No ad preview or mutation is requested.

  • openai_ads_get_ad_group

    Read one ChatGPT Ads ad group, including its native bidding, context hints and configuration, without changing delivery.

  • openai_ads_get_ad_groups

    List one page of ChatGPT Ads ad groups for a campaign. Native ad group IDs are adgrp_ identifiers; preserve has_more and last_id.

  • openai_ads_get_ads

    List one page of ads and native creative metadata for a ChatGPT Ads ad group. Preserve the provider's review status and pagination.

  • openai_ads_get_audience_operation

    Read the native ChatGPT Ads get audience operation contract. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_get_audience_operations

    Read the native ChatGPT Ads get audience operations contract. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_get_audit_logs

    Read the native ChatGPT Ads get audit logs contract. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_get_bulk_job

    Read one limited-preview native bulk job. Only completed/partially_failed/failed are terminal. A completed job still requires every operation result and native entity readback.

  • openai_ads_get_bulk_job_operations

    Read one page of native bulk outcomes (created/updated/validated/failed/skipped). Follow the last operation_id as after only when has_more. Partial failure never rolls back earlier operations; do not resubmit an uncertain job.

  • openai_ads_get_campaign

    Read one campaign and its native status, budget, schedule and targeting in a selected ChatGPT Ads account.

  • openai_ads_get_campaigns

    List one page of campaigns in a selected ChatGPT Ads account. Follow last_id only when has_more is true; budget amounts use micros.

  • openai_ads_get_conversion_events

    Read the native ChatGPT Ads get conversion events contract. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_get_conversion_insights

    Read the native ChatGPT Ads get conversion insights contract. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_get_conversion_pixels

    Read the native ChatGPT Ads get conversion pixels contract. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_get_conversion_settings

    Read the native ChatGPT Ads get conversion settings contract. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_get_custom_audience

    Read the native ChatGPT Ads get custom audience contract. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_get_custom_audiences

    Read the native ChatGPT Ads get custom audiences contract. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_get_feed_products

    Read the native ChatGPT Ads get feed products contract. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_get_feed_settings

    Read the native ChatGPT Ads get feed settings contract. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_get_feed_uploads

    Read the native ChatGPT Ads get feed uploads contract. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_get_feeds

    Read the native ChatGPT Ads get feeds contract. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_get_insights

    Read ChatGPT Ads delivery, finalized cost and attributed conversions by account, campaign, ad group or ad. Inclusive local dates; native CTR/CVR are fractions; money uses major account currency units. Paginated automatically without retries; truncated output is explicit. Default attribution is 30-day click / 1-day view, ad-event time.

  • openai_ads_get_landing_page_crawl

    Read the native ChatGPT Ads get landing page crawl contract. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_get_mutation

    Read a durable approval or mutation receipt for the selected account, actor, workspace and connection. UNKNOWN or APPLYING must never be resubmitted.

  • openai_ads_get_spend_limits

    Read the native ChatGPT Ads get spend limits contract. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_get_write_context

    Read the selected account, conversion goals and feed inventory before a campaign proposal. Describes native campaign/bid combinations and missing prerequisites without granting eligibility or creating data.

  • openai_ads_get_write_schema

    Read pinned official native request definitions, paths and parameters. Lists actual supported operations and exclusions; schema support does not imply account eligibility.

  • openai_ads_list_ad_creatives

    Show ChatGPT Ads chat-card images, ad names and destinations in the selected account's gallery. One page of up to 20; missing image URLs are read from the exact ad ID. Follow nextCursor when hasMore. Media URLs expire; failed media reads are explicit.

  • openai_ads_pause_adwrite

    Preview and confirm the native ChatGPT Ads pause ad contract. Saved approval, stable requestId and exact native state are required. Creates are always paused; activation is separately gated. No automatic write retry. Budgets and bids use integer account-currency micros. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_pause_ad_groupwrite

    Preview and confirm the native ChatGPT Ads pause ad group contract. Saved approval, stable requestId and exact native state are required. Creates are always paused; activation is separately gated. No automatic write retry. Budgets and bids use integer account-currency micros. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_pause_campaignwrite

    Preview and confirm the native ChatGPT Ads pause campaign contract. Saved approval, stable requestId and exact native state are required. Creates are always paused; activation is separately gated. No automatic write retry. Budgets and bids use integer account-currency micros. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_search_locations

    Read the native ChatGPT Ads search locations contract. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_submit_bulk_jobwrite

    Preview and confirm one limited-preview bulk job with up to 1000 operations. Saved approval and stable request/operation keys are required. Defaults to native validation-only; acceptance is not operation completion. Read job status and every outcome, then reconcile native entities. No automatic write retry.

  • openai_ads_update_adwrite

    Preview and confirm the native ChatGPT Ads update ad contract. Saved approval, stable requestId and exact native state are required. Creates are always paused; activation is separately gated. No automatic write retry. Budgets and bids use integer account-currency micros. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_update_ad_groupwrite

    Preview and confirm the native ChatGPT Ads update ad group contract. Saved approval, stable requestId and exact native state are required. Creates are always paused; activation is separately gated. No automatic write retry. Budgets and bids use integer account-currency micros. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_update_campaignwrite

    Preview and confirm the native ChatGPT Ads update campaign contract. Saved approval, stable requestId and exact native state are required. Creates are always paused; activation is separately gated. No automatic write retry. Budgets and bids use integer account-currency micros. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_update_feed_productswrite

    Preview and confirm the native ChatGPT Ads update feed products contract. Saved approval, stable requestId and exact native state are required. Creates are always paused; activation is separately gated. No automatic write retry. Budgets and bids use integer account-currency micros. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_update_feed_settingswrite

    Preview and confirm the native ChatGPT Ads update feed settings contract. Saved approval, stable requestId and exact native state are required. Creates are always paused; activation is separately gated. No automatic write retry. Budgets and bids use integer account-currency micros. Use openai_ads_get_write_schema for nested fields and native eligibility.

  • openai_ads_upload_imagewrite

    Upload verified PNG/JPEG/WebP bytes to the selected ChatGPT Ads account after saved preview and confirmation. Minimum 640 × 640, maximum 5 MiB. Returns native file_id for a chat_card. Never changes the account favicon.

  • openai_ads_upload_image_urlwrite

    Import a public HTTPS image through the documented JSON upload endpoint after saved preview and confirmation. Returns native file_id. The native provider validates the image; account branding is untouched.

Catalogues

What you can measure, and how you can cut it.

The full catalogues live in the reference, where every entry carries the API field it maps to and the constraints that come with it. Here is their shape.

Metrics

11

Other
11

All 11 metrics

Dimensions

9

Other
9

All 9 dimensions

Reference

Everything else about it.

The reference, the catalogues, and how to put ChatGPT Ads in front of your assistant.

The other 15 servers