Skip to main content
Glama
trakkr-aisearch

OpenAI Ads MCP

by trakkr-aisearch
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PORTNoHTTP port for HTTP mode. Default 8080.8080
OPENAI_ADS_API_KEYYesRequired bearer key for https://api.ads.openai.com/v1.
OPENAI_ADS_API_BASE_URLNoOptional HTTPS override for tests or proxies.
OPENAI_ADS_MCP_READONLYNoSet to '1' or 'true' to register read tools only.
OPENAI_ADS_MCP_HTTP_PATHNoMCP path for HTTP mode. Default '/mcp'./mcp
OPENAI_ADS_MCP_HTTP_PORTNoAlternative to PORT for HTTP port. Default 8080.8080
OPENAI_ADS_MCP_HTTP_TOKENNoOptional bearer token required by hosted clients for HTTP mode.
OPENAI_ADS_MCP_HEALTH_PATHNoHealth path for HTTP mode. Default '/healthz'./healthz
OPENAI_ADS_BUDGET_CEILING_USDNoOptional budget guard. Default 100.100
OPENAI_ADS_MCP_HTTP_CORS_ORIGINNoOptional CORS origin for HTTP mode. Default '*'.*
OPENAI_ADS_MCP_HTTP_ALLOW_WRITESNoSet to '1' to expose write tools over HTTP.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_accountA

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.

list_campaignsA

List campaigns in the authenticated ad account with cursor pagination.

get_campaignB

Get one campaign by id.

list_ad_groupsB

List ad groups, optionally filtered to a campaign.

get_ad_groupB

Get one ad group by id.

list_adsC

List ads in an ad group.

get_adA

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

get_insightsA

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

list_audiencesC

List custom audiences for the authenticated ad account.

get_audienceB

Get one custom audience by id.

search_geoA

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

draft_context_hintsC

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

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription
Trakkr AI visibility briefingA short paste-ready briefing on connecting ChatGPT ad placements with organic AI visibility tracking.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/trakkr-aisearch/openai-ads-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server