Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"apple-ads": {
"env": {
"ASA_KEY_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"ASA_TEAM_ID": "SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"ASA_CLIENT_ID": "SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"ASA_PRIVATE_KEY_PATH": "/Users/yourname/apple-ads-key-pkcs8.pem"
},
"args": [
"-y",
"apple-ads-mcp"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
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.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y 'apple-ads-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked apple-ads-mcp against OSV.dev.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in marketing
DataForSEO API modelcontextprotocol server
MCP server for the PostFast API — schedule and manage social media posts via AI tools
Claude Code plugin: 115 commands, 25 agents, 64 scripts, 67 MCP servers, 143 reference files. Eval/QA layer (hallucination detection, claim verification, A+ through F grading). Multilingual (Sarvam AI, DeepL, Google Cloud Translation). Full execution with approval workflow.
A free SEO research tool using Model Context Protocol (MCP) powered by Ahrefs data. Get backlink analysis, keyword research, traffic estimation, and more — directly in your AI-powered IDE.
MCP Security Weekly
Get CVE alerts and security updates for io.github.Happygallo/apple-ads and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
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.
| Feature | Description |
|---|---|
| Campaign management | Create, update, pause, and delete campaigns and ad groups |
| Keyword optimization | Add/remove targeting and negative keywords, update bids |
| Performance reporting | Campaign, ad group, keyword, ad, and geo reports with date presets |
| Search term analysis | See actual search queries triggering your ads |
| Creative management | Manage ads, creatives, and product pages |
| Budget control | Create and manage budget orders, analyze utilization |
| Impression share | Generate and retrieve impression share reports |
| Multi-org support | Switch between organizations at runtime |
Done by the account admin at searchads.apple.com.
The API user must be a different Apple ID from the admin. If you're the admin, use a second Apple ID.
Done by the invited user.
SEARCHADS.SEARCHADS.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)Print your public key:
cat ~/apple-ads-key-publi
... [View full README on GitHub](https://github.com/Happygallo/apple-ads-mcp#readme)