![\"npm](\"https://img.shields.io/npm/v/apple-ads-mcp.svg\")
\n ![\"MCP](\"https://img.shields.io/badge/MCP-compatible-blue\"){kind=icon}
\n ![\"TypeScript\"](\"https://img.shields.io/badge/TypeScript-5.x-blue?logo=typescript&logoColor=white\"){kind=icon}
\n ![\"License\"](\"https://img.shields.io/npm/l/apple-ads-mcp.svg\")
\n\n
\n \n \n
\n MCP server for the Apple Search Ads API v5.
\n Connect it to any MCP-compatible AI client and manage your campaigns, keywords, budgets, and reporting through natural language.\n
\n Quick Start •\n Tools •\n Resources •\n Prompts •\n Clients\n
\n\n---\n\n**Ask your AI things like:**\n\n> *\"How did my campaigns perform last week?\"*\n> *\"Pause the brand campaign and increase the budget on discovery to $500.\"*\n> *\"What search terms are triggering my ads? Add the best ones as exact-match keywords.\"*\n\nSupports 54 tools, 3 resources, and 6 prompts — campaigns, ad groups, keywords, creatives, budgets, search terms, geo targeting, impression share, and performance reports.\n\n### Features at a glance\n\n| Feature | Description |\n|---|---|\n| **Campaign management** | Create, update, pause, and delete campaigns and ad groups |\n| **Keyword optimization** | Add/remove targeting and negative keywords, update bids |\n| **Performance reporting** | Campaign, ad group, keyword, ad, and geo reports with date presets |\n| **Search term analysis** | See actual search queries triggering your ads |\n| **Creative management** | Manage ads, creatives, and product pages |\n| **Budget control** | Create and manage budget orders, analyze utilization |\n| **Impression share** | Generate and retrieve impression share reports |\n| **Multi-org support** | Switch between organizations at runtime |\n\n---\n\n## Quick Start\n\n1. [Get your Apple credentials](#step-1--invite-an-api-user) (~10 min, one-time)\n2. [Generate your key pair](#step-3--generate-your-key-pair) (2 commands)\n3. [Add to your MCP client](#step-5--add-to-your-mcp-client)\n4. Start chatting\n\n---\n\n## Setup\n\n### Step 1 — Invite an API user\n\n> Done by the **account admin** at [searchads.apple.com](https://searchads.apple.com).\n\n1. Go to **Settings** → **User Management** → **Invite User**\n2. Enter the email of the person who will use the API\n3. Set the role:\n - **API Account Manager** — full read/write access\n - **API Account Read Only** — view-only access\n4. Send the invitation\n\n> The API user must be a **different Apple ID** from the admin. If you're the admin, use a second Apple ID.\n\n### Step 2 — Accept and copy your credentials\n\n> Done by the **invited user**.\n\n1. Accept the email invitation and sign in to [searchads.apple.com](https://searchads.apple.com)\n2. Go to **Settings** → **API** tab\n3. Copy and save these three values:\n - **clientId** — starts with `SEARCHADS.`\n - **teamId** — starts with `SEARCHADS.`\n - **keyId** — a UUID\n\n### Step 3 — Generate your key pair\n\nOpen Terminal and run:\n\n```bash\nopenssl ecparam -genkey -name prime256v1 -noout -out ~/apple-ads-key.pem && \\\nopenssl pkcs8 -topk8 -nocrypt -in ~/apple-ads-key.pem -out ~/apple-ads-key-pkcs8.pem\n```\n\nThen generate the public key:\n\n```bash\nopenssl ec -in ~/apple-ads-key-pkcs8.pem -pubout -out ~/apple-ads-key-public.pem\n```\n\nThis creates:\n- **`~/apple-ads-key-pkcs8.pem`** — private key (keep this safe, used in your config)\n- **`~/apple-ads-key-public.pem`** — public key (upload to Apple next)\n\n### Step 4 — Upload public key to Apple\n\nPrint your public key:\n\n```bash\ncat ~/apple-ads-key-public.pem\n```\n\nCopy the entire output (including the `BEGIN` / `END` lines), then:\n\n1. Go to **Settings** → **API** tab on [searchads.apple.com](https://searchads.apple.com)\n2. Paste into the **Public Key** field\n3. **Save**\n\n### Step 5 — Add to your MCP client\n\nPick 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.\n\n> **Multiple orgs?** Omit `ASA_ORG_ID` and use `list_organizations` / `switch_organization` at runtime. Or set it in `env` to pick a default.\n\n---\n\n## Clients\n\n