OpenAI Ads MCP tools reference

List every OpenAI Ads account linked to your Bluegrass workspace, with its status and whether an API key is connected, so you know what you can act on.

Pull the name, currency, timezone and connection state for any one of your connected ChatGPT Ads accounts.

Test the stored API key for an account and confirm Bluegrass can reach OpenAI Ads before you run anything against it.

Browse the analytics reports you've already built in Bluegrass, ready to run by name from Claude or ChatGPT.

Retrieve one saved report and its full definition: the metrics, filters and breakdown it runs.

Run a saved report and get the rows back, spend, clicks, CTR, CPC and conversions, sliced the way you asked for any date range or campaign.

See every campaign in an account from Bluegrass's synced view, with status, budget and structure at a glance.

Open one campaign to see its ad groups, attached audiences and dayparting schedule in one place.

Pull the freshest campaigns and ad groups from your ChatGPT Ads account so reports and dayparting run on current data.

Attach a custom audience to a campaign as an include or exclude, so your bids reach the right people and skip the rest.

Assign a dayparting schedule to a campaign, or clear it, so its bids follow the hours that actually convert.

See the day-and-hour bid schedules set up on an account, ready to apply to campaigns.

Open one dayparting schedule and its full 7-day by 24-hour grid of bid multipliers.

Get the 'now serving' board: what every scheduled campaign is doing this hour, and exactly what enforcement would change.

Apply the current dayparting plan, preview it as a dry run first or write the live bid adjustments to OpenAI Ads.

Begin enforcing a schedule: Bluegrass snapshots your baseline bids and starts adjusting them by the hour.

Stop enforcing a schedule and revert every ad group to its baseline bid, with the grid unlocked for editing.

Set the baseline bid an ad group returns to, the reference point your dayparting multipliers move around.

Set a bid multiplier on an ad group so you pay more for the audiences that convert and pull back on the rest.

List the custom audiences Bluegrass manages for an account, with their size and status.

Open one custom audience and its current version: how it was built and how many people it holds.

Page through the members of an audience's current version to check what's actually been matched.

Create a custom audience from a list of emails or phone numbers, ready to target or suppress on OpenAI Ads.

Retire a custom audience you no longer need, keeping your list tidy without losing the history.

Pull every campaign straight from the OpenAI Ads API, exactly as the platform returns it.

Create a brand-new ChatGPT Ads campaign, its name, objective, budget and bidding, from a single chat instruction.

Read one campaign's full configuration directly from OpenAI Ads.

Change a campaign's budget, targeting, status and other settings through the live API.

Set a campaign live so it starts serving ads in ChatGPT.

Pause a campaign instantly, for example to stop an underperformer the moment your assistant spots it.

Archive a campaign you're done with to keep the account focused on what's active.

See all the ad groups inside a campaign, straight from the API.

Add a new ad group to a campaign, with its own targeting and bid.

Read one ad group's configuration from OpenAI Ads.

Update an ad group's bid, targeting or settings live.

Activate an ad group so its ads start serving.

Pause a single ad group without touching the rest of the campaign.

Retire an ad group you no longer run.

See every ad in an ad group, as returned by the API.

Create a new ad, headline, copy and creative, so your assistant can draft fresh variations and put them live to test.

Read one ad's content and settings from OpenAI Ads.

Edit an existing ad's copy or creative, handy for seasonal refreshes and quick tweaks.

Set an ad live so it enters rotation.

Pause a tired or low-performing ad while you test something new.

Retire an ad you're finished with.

Pull account-wide metrics from OpenAI Ads, broken down by hour, day or month.

Get spend, clicks, CTR and more for a campaign, aggregated however you need.

Drill into a single ad group's metrics over any time range.

See how an individual ad is performing, down to the hour, perfect for spotting fatigue.

Read every custom audience on the account directly from OpenAI Ads.

Create a custom audience through the native API for full control over its definition.

Read one custom audience's details from the platform.

Create a custom audience from an uploaded file and kick off matching, the Customer Match upload path.

Retire a custom audience on the account.

Create a conversion pixel so OpenAI Ads can measure what happens after a click.

Generate a Conversions API key to send server-side conversions back to OpenAI Ads.

Set up a conversion event so the right actions count as conversions.

List the conversion events configured on the account.

Pull attributed conversion totals to see which campaigns are actually driving results.

Read the ad account's core metadata: name, currency, timezone and status.

Update the ad account's brand metadata used across your ads.

Bring the whole ad account live.

Pause the entire ad account so every campaign stops serving at once.

Search DMA and region codes to target the right locations in OpenAI Ads.

Upload an image and get a file id to use as ad creative.