Servers Playground How we check Add a server Log in

OpenAI Ads MCP

Working · 877 ms

io.github.trakkr-aisearch/openai-ads-mcpv0.1.7

OpenAI Ads MCP for ChatGPT Ads campaigns, creatives, audiences, insights, and conversions.

Marketing & SEO

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://openai-ads-mcp.trakkr.ai/mcp

X-OpenAI-Ads-API-Key (optional)

OpenAI Ads API key from Ads Manager. Required only for Ads API tool calls; discovery, initialize, and tools/list work without it.

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

draft_context_hints Read-only

Draft deterministic context_hints for an ad group from product, audience, intent, and keywords.

productstring, required

intentstring

audiencestring

keywordsstring

OpenAI Ads MCP MCP server | mcptry

Tools (13)

draft_context_hints

Draft deterministic context_hints for an ad group from product, audience, intent, and keywords.

read-only

Argument	Type	Description
intent	string
product*	string
audience	string
keywords	any

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "product"
  ],
  "properties": {
    "intent": {
      "type": "string"
    },
    "product": {
      "type": "string"
    },
    "audience": {
      "type": "string"
    },
    "keywords": {}
  },
  "additionalProperties": false
}

get_account

Get the authenticated OpenAI Ads account. Use this first to verify that OPENAI_ADS_API_KEY works and to read account id, name, timezone, currency, and settings.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {},
  "additionalProperties": false
}

get_ad

Get one ad by id, including review_status and creative metadata.

read-only

Argument	Type	Description
ad_id*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "ad_id"
  ],
  "properties": {
    "ad_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

get_ad_group

Get one ad group by id.

read-only

Argument	Type	Description
ad_group_id*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "ad_group_id"
  ],
  "properties": {
    "ad_group_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

get_audience

Get one custom audience by id.

read-only

Argument	Type	Description
audience_id*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "audience_id"
  ],
  "properties": {
    "audience_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

get_campaign

Get one campaign by id.

read-only

Argument	Type	Description
campaign_id*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaign_id"
  ],
  "properties": {
    "campaign_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

get_insights

Get performance insights for account, campaign, ad group, or ad scope. Supports fields, filters, sort, product/country/device segments, time ranges, and cursor pagination.

read-only

Argument	Type	Description
sort	any
after	string
limit	integer
scope*	string
before	string
fields	any
filters	any
includes	any
segments	any
entity_id	string
time_range	any

list_ad_groups

List ad groups for a campaign.

read-only

Argument	Type	Description
after	string
limit	integer
order	string
before	string
campaign_id*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "campaign_id"
  ],
  "properties": {
    "after": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 20
    },
    "order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc"
    },
    "before": {
      "type": "string"
    },
    "campaign_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

list_ads

List ads in an ad group.

read-only

Argument	Type	Description
after	string
limit	integer
order	string
before	string
ad_group_id*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "ad_group_id"
  ],
  "properties": {
    "after": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 20
    },
    "order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc"
    },
    "before": {
      "type": "string"
    },
    "ad_group_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

list_audiences

List custom audiences for the authenticated ad account.

read-only

Argument	Type	Description
after	string
limit	integer
order	string
before	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "after": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 20
    },
    "order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc"
    },
    "before": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

list_campaigns

List campaigns in the authenticated ad account with cursor pagination.

read-only

Argument	Type	Description
after	string
limit	integer
order	string
before	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "after": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "default": 20
    },
    "order": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "default": "desc"
    },
    "before": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

manage_conversions

Manage conversion pixels, API keys, event settings, and conversion reporting.

read-only

Argument	Type	Description
name	string
after	string
limit	integer
order	string
action*	string
before	string
entity_ids	any
event_type	string
source_ids	any
client_type	string
time_ranges	any

search_geo

Search geo targets for targeting.locations.include and return ids usable in campaign targeting.

read-only

Argument	Type	Description
query*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string"
    }
  },
  "additionalProperties": false
}