Apple Ads

Apple Ads MCP

MCP server for the Apple Search Ads API v5 .

Connect it to any MCP-compatible AI client and manage your campaigns, keywords, budgets, and reporting through natural language.

Quick Start • Tools • Resources • Prompts • Clients

---

Ask your AI things like:

*"How did my campaigns perform last week?"*

*"Pause the brand campaign and increase the budget on discovery to $500."*

*"What search terms are triggering my ads? Add the best ones as exact-match keywords."*

Supports 54 tools, 3 resources, and 6 prompts — campaigns, ad groups, keywords, creatives, budgets, search terms, geo targeting, impression share, and performance reports.

Features at a glance

---

Quick Start

1. Get your Apple credentials (~10 min, one-time)
2. Generate your key pair (2 commands)
3. Add to your MCP client
4. Start chatting

---

Setup

Step 1 — Invite an API user

Done by the account admin at searchads.apple.com.

1. Go to Settings → User Management → Invite User
2. Enter the email of the person who will use the API
3. Set the role:

• API Account Manager — full read/write access
• API Account Read Only — view-only access

1. Send the invitation

The API user must be a different Apple ID from the admin. If you're the admin, use a second Apple ID.

Step 2 — Accept and copy your credentials

Done by the invited user.

1. Accept the email invitation and sign in to searchads.apple.com
2. Go to Settings → API tab
3. Copy and save these three values:

• clientId — starts with SEARCHADS.
• teamId — starts with SEARCHADS.
• keyId — a UUID

Step 3 — Generate your key pair

Open Terminal and run:

openssl ecparam -genkey -name prime256v1 -noout -out ~/apple-ads-key.pem && \

openssl pkcs8 -topk8 -nocrypt -in ~/apple-ads-key.pem -out ~/apple-ads-key-pkcs8.pem

Then generate the public key:

openssl ec -in ~/apple-ads-key-pkcs8.pem -pubout -out ~/apple-ads-key-public.pem

This creates:

• `~/apple-ads-key-pkcs8.pem` — private key (keep this safe, used in your config)
• `~/apple-ads-key-public.pem` — public key (upload to Apple next)

Step 4 — Upload public key to Apple

Print your public key:

cat ~/apple-ads-key-public.pem

Copy the entire output (including the BEGIN / END lines), then:

1. Go to Settings → API tab on searchads.apple.com
2. Paste into the Public Key field
3. Save

Step 5 — Add to your MCP client

Pick your client below and fill in your clientId, teamId, and keyId from Step 2, and the full path to your private key from Step 3.

Multiple orgs? Omit ASA_ORG_ID and use list_organizations / switch_organization at runtime. Or set it in env to pick a default.

---

Clients

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{

"mcpServers": { "apple-ads": { "command": "npx", "args": ["-y", "apple-ads-mcp"], "env": { "ASA_CLIENT_ID": "SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "ASA_TEAM_ID": "SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "ASA_KEY_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "ASA_PRIVATE_KEY_PATH": "/Users/yourname/apple-ads-key-pkcs8.pem" } } } }

Restart Claude Desktop after saving.

Claude Code

claude mcp add apple-ads \

-e ASA_CLIENT_ID=SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \ -e ASA_TEAM_ID=SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \ -e ASA_KEY_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \ -e ASA_PRIVATE_KEY_PATH=/Users/yourname/apple-ads-key-pkcs8.pem \ -- npx -y apple-ads-mcp

Cursor

Add to .cursor/mcp.json:

{

"mcpServers": { "apple-ads": { "command": "npx", "args": ["-y", "apple-ads-mcp"], "env": { "ASA_CLIENT_ID": "SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "ASA_TEAM_ID": "SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "ASA_KEY_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "ASA_PRIVATE_KEY_PATH": "/Users/yourname/apple-ads-key-pkcs8.pem" } } } }

VS Code

Add to your settings.json:

{

"mcp": { "servers": { "apple-ads": { "command": "npx", "args": ["-y", "apple-ads-mcp"], "env": { "ASA_CLIENT_ID": "SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "ASA_TEAM_ID": "SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "ASA_KEY_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "ASA_PRIVATE_KEY_PATH": "/Users/yourname/apple-ads-key-pkcs8.pem" } } } } }

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{

"mcpServers": { "apple-ads": { "command": "npx", "args": ["-y", "apple-ads-mcp"], "env": { "ASA_CLIENT_ID": "SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "ASA_TEAM_ID": "SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "ASA_KEY_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "ASA_PRIVATE_KEY_PATH": "/Users/yourname/apple-ads-key-pkcs8.pem" } } } }

Other MCP clients

This server uses STDIO transport. Any MCP-compatible client can connect by running:

npx -y apple-ads-mcp

Set these environment variables:

Inline key (no file)

Replace ASA_PRIVATE_KEY_PATH with ASA_PRIVATE_KEY and paste the PEM content with \n for line breaks:

"ASA_PRIVATE_KEY": "[PopNx MCP ตัดค่าที่หน้าตาเหมือนกุญแจออก]"

---

Tools

All 54 tools

---

Resources

The server exposes 3 resources:

---

Prompts

6 built-in workflow prompts to guide common tasks:

---

Troubleshooting

"pkcs8 must be PKCS#8 formatted string"

Your key is in the wrong format. Re-run the `openssl