aapl-ads-mcp
An MCP server that connects Claude (and any MCP-compatible client) to Apple Search Ads API v5.
What is this
MCP (Model Context Protocol) is an open standard that lets AI assistants call external tools. This server implements the MCP stdio transport and exposes 9 read-only tools that query your Apple Search Ads account — campaigns, ad groups, keywords, and performance reports.
You install it once, point Claude Desktop at it, and then ask questions in plain English: "Which keywords drove the most installs last month?" or "Show me campaigns with zero impressions this week."
Why
The official ASA dashboards are good for humans but not for ad-hoc analysis or automated reporting. Existing MCP alternatives are either SaaS (you hand over your keys) or unmaintained. This is a self-hosted, open-source option you control.
Features
- list_orgs — verify authentication, list accessible organizations
- list_campaigns — enumerate campaigns, optionally filter by status
- list_ad_groups — ad groups for a given campaign
- list_keywords — targeting keywords with bid amounts and match type
- get_campaign_report — impressions, taps, installs, spend, CPI, TTR by campaign
- get_ad_group_report — same metrics broken down by ad group
- get_keyword_report — per-keyword performance with weekly/daily/monthly granularity
- get_search_terms_report — the real search queries that triggered your ads (most useful for discovery)
