openai-ads-mcp MCP Server

Trakkr tracks the full AI-visibility funnel, organic and paid. This is the open-source paid-side companion.

Local serverstdio

What is the openai-ads-mcp Server?

openai-ads-mcp is an MCP project maintained in the trakkr-aisearch/openai-ads-mcp repository. The maintainer describes its purpose as “Trakkr tracks the full AI-visibility funnel, organic and paid. This is the open-source paid-side companion”. Read the project documentation for the complete scope.

Installation

The documented pypi package is openai-ads-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares OPENAI_ADS_API_KEY, OPENAI_ADS_MCP_READONLY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
GroupTools
Accountget_account
Campaignslist_campaigns, get_campaign, create_campaign, update_campaign, set_campaign_state
AdGroupslist_ad_groups, get_ad_group, create_ad_group, update_ad_group, set_ad_group_state
Adslist_ads, get_ad, upload_creative, create_ad, update_ad, set_ad_state
Insightsget_insights
Audienceslist_audiences, get_audience, search_geo, manage_audience
Conversionsmanage_conversions, send_conversions
Helpersbuild_campaign, draft_context_hints, bulk_ab_test_hints
get_accountGets the ad account and confirms the API key works.
get_insightsReads account, campaign, ad group, or ad insights with fields, filters, sort, segments, and cursor pagination.
create_campaignCreates a paused campaign with a guarded lifetime budget, including conversion-optimized campaigns with one event setting.
upload_creativeUploads an image URL or local image file and returns file_id.
create_adCreates a paused ad. chat_card requires target_url and file_id.
build_campaignCreates one paused campaign, one paused ad group, and paused ads in a guarded workflow.
draft_context_hintsDeterministically drafts API-shaped context_hints with no hidden LLM call.
send_conversionsSends conversion events to https://bzr.openai.com/v1/events?pid=... after local validation, with optional validate_only. Supports obref and mobile app…

How to install the openai-ads-mcp Server

{
  "mcpServers": {
    "openai-ads": {
      "command": "uvx",
      "args": [
        "openai-ads-mcp"
      ],
      "env": {
        "OPENAI_ADS_API_KEY": "YOUR_OPENAI_ADS_API_KEY",
        "OPENAI_ADS_MCP_READONLY": "1"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
OPENAI_ADS_API_KEYDeclared in the maintainer’s client configuration.Yes
OPENAI_ADS_MCP_READONLYDeclared in the maintainer’s client configuration.Check documentation