io.github.Happygallo/apple-ads is an MCP server that manage Apple Search Ads campaigns, keywords, budgets, and reports via API v5. Its tool list has not been published yet over stdio, sse and http, requires no API key, and scores 53/100 on MCPpedia's security, maintenance and efficiency rubric.
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
B2B lead generation and company search through Generect Live API for sales prospecting.
Google Search Console MCP Server for Claude, Cursor, Windsurf and other MCP Clients
一键同步文章到多个内容平台,支持今日头条、WordPress、知乎、简书、掘金、CSDN、typecho各大平台,一次发布,多平台同步发布。解放个人生产力
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)