SearchAds MCP Server

SearchAds Manager includes a macOS-only local MCP server that runs inside the app and reuses the Apple Search Ads credentials already configured in your account settings.

What it does

• Discover owned apps and supported countries before you create campaigns.
• Pull campaign, ad group, and keyword reports without building custom API scripts.
• Create, update, and delete campaigns, ad groups, and keywords from Codex through a local, authenticated endpoint.
• Keep the connection local to your Mac while the app is running.

Runtime model

1. The server binds only to 127.0.0.1.
2. The server is available only while the macOS app is running.
3. Access is protected with a generated token stored in app settings.
4. The MCP endpoint is /mcp.
5. A health endpoint is available at /health.

Settings in SearchAds Manager

The macOS Settings screen includes a Codex MCP Server card with:

1. An enable toggle
2. A configurable TCP port
3. A generated access token
4. The full authenticated MCP URL
5. A ready-to-run Codex command
6. Status feedback for the local listener

Available MCP tools

Discovery and metadata

• list_apps
• list_supported_countries

Reporting

• get_campaign_report
• get_adgroup_report
• get_keyword_report

Campaign management

• list_campaigns
• create_campaigns
• update_campaigns
• delete_campaigns

Ad group management

• list_adgroups
• add_adgroups
• update_adgroups
• delete_adgroups

Keyword management

• list_keywords
• add_keywords
• update_keywords
• delete_keywords

Typical workflow

1. Call list_apps to find the adam_id for the app you want to promote.
2. Call list_supported_countries to confirm valid country or region codes.
3. Inspect current performance with get_campaign_report, get_adgroup_report, or get_keyword_report.
4. Review current state with list_campaigns, list_adgroups, and list_keywords.
5. Apply small, explicit write batches so errors are easier to understand and revert if needed.

Next step

To add the server to Codex and run a disposable smoke test, open Connect SearchAds Manager to Codex.