Skip to main content
Glama
Apple Ads MCP Server

Apple Ads MCP Server

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
APPLE_ADS_HOSTNoBind address for HTTP transports127.0.0.1
APPLE_ADS_PORTNoPort for HTTP transports8000
APPLE_ADS_KEY_IDYeskeyId from Apple Ads Account Settings > API
APPLE_ADS_DRY_RUNNoSet to true to preview and log writes without sending them
APPLE_ADS_TEAM_IDYesteamId from Apple Ads Account Settings > API
APPLE_ADS_TIMEOUTNoRequest timeout in seconds30
APPLE_ADS_AUDIT_LOGNoAudit log path~/.apple-ads-mcp/logs/audit.jsonl
APPLE_ADS_CLIENT_IDYesclientId from Apple Ads Account Settings > API
APPLE_ADS_LOG_LEVELNoLog level
APPLE_ADS_PAGE_SIZENo/query page size, from 1 to 1000100
APPLE_ADS_READ_ONLYNoSet to true to register only read-only tools plus the meta tools
APPLE_ADS_TRANSPORTNoTransport mode: stdio (default), streamable-http, or ssestdio
APPLE_ADS_TOOL_GROUPSNoComma-separated tool groups to register; default is all. Valid groups include accounts, apps, geo, campaigns, adgroups, keywords, ads, budget_orders, reports, recommendations, maps, change_history, advanced
APPLE_ADS_ALLOW_REMOTENoSet to true to let HTTP transports bind to a non-loopback host
APPLE_ADS_AD_ACCOUNT_IDNoDefault ad account ID, sent as X-AP-Context: adAccountId=…; any tool can override it with ad_account_id
APPLE_ADS_MAX_INCREASE_PCTNoBudget and bid rises above this percentage need confirm='APPLY'20
APPLE_ADS_PRIVATE_KEY_PATHNoPath to the private key from `apple-ads-mcp keygen`. Can be left out if the key is at ~/.apple-ads-mcp/secrets/private-key.pem
APPLE_ADS_AUDIT_RETENTION_DAYSNoAudit entries older than this many days are deleted at startup30

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

NameDescription

No tools

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources