OpenAI Ads MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| OPENAI_ADS_HOME | No | Per-user data folder. Also read for `.env`. | ~/.openai-ads-mcp |
| OPENAI_ADS_HOST | No | Bind address for HTTP transports. | 127.0.0.1 |
| OPENAI_ADS_PORT | No | Port for HTTP transports. | 8000 |
| OPENAI_ADS_API_KEY | No | Ads API key. Required if no key file is available. Prefer `openai-ads-mcp auth`, which writes the key file. This is an Ads API key, not an OpenAI platform key. | |
| OPENAI_ADS_DRY_RUN | No | Set to `true` to log writes without sending them. | false |
| OPENAI_ADS_MAX_BID | No | Optional bid cap in the account currency; higher values need `confirm='APPLY'`. | |
| OPENAI_ADS_TIMEOUT | No | Request timeout. | |
| OPENAI_ADS_KEY_FILE | No | Path to the key file written by `auth`. Alternative to OPENAI_ADS_API_KEY. | ~/.openai-ads-mcp/secrets/openai-ads-key.json |
| OPENAI_ADS_AUDIT_LOG | No | Audit log path. | ~/.openai-ads-mcp/logs/audit.jsonl |
| OPENAI_ADS_LOG_LEVEL | No | Log level. | |
| OPENAI_ADS_PAGE_SIZE | No | List page size (1-500). | |
| OPENAI_ADS_READ_ONLY | No | Set to `true` to register only read-only tools. | false |
| OPENAI_ADS_TRANSPORT | No | Transport mode: `stdio`, `streamable-http`, or `sse` (deprecated). | stdio |
| OPENAI_ADS_UPLOAD_DIR | No | Folder that local images and customer lists may be uploaded from. | |
| OPENAI_ADS_TOOL_GROUPS | No | Comma-separated groups to register (default all): account, spend_limits, campaigns, ad_groups, ads, status, files, audiences, conversions, reporting, feeds, bulk, leads, request. The meta tools are always on. | |
| OPENAI_ADS_ALLOW_REMOTE | No | Set to `true` to let HTTP transports bind to a non-loopback host. There is no built-in auth: only use behind your own. | false |
| OPENAI_ADS_AD_ACCOUNT_ID | No | Account to act on, for partner keys that reach several accounts. | |
| OPENAI_ADS_BULK_THRESHOLD | No | Items per call before `confirm='APPLY'` is needed. | 10 |
| OPENAI_ADS_MAX_DAILY_BUDGET | No | Optional cap in the account currency; higher values need `confirm='APPLY'`. | |
| OPENAI_ADS_MAX_INCREASE_PCT | No | Budget, bid and limit rise allowed without `confirm='APPLY'`. | 20 |
| OPENAI_ADS_MAX_LIFETIME_BUDGET | No | Optional lifetime budget cap in the account currency; higher values need `confirm='APPLY'`. | |
| OPENAI_ADS_AUDIT_RETENTION_DAYS | No | Days to keep audit log entries. `0` keeps them. | 30 |
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
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues