Apple Ads
Read Apple Ads search campaigns and preview changes before they apply
- Pricing
- Freemium
- Platforms
- API, CLI
- Runs
- Locally
- Version
- 1.0.2
- Listing updated
- 2 days ago
About Apple Ads
Apple Ads is a freemium MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.
Apple Ads was formerly Apple Search Ads, and this server targets App Store search campaigns. Get MCP Ads offers it hosted, signing in with Apple, and also as an npm package that connects with your own Apple API credentials. Because the registry shows environment variables, an ad account ID allowlist is required even for reads, and writes stay off unless APPLE_ADS_ENABLE_WRITES is true.
The registry lists 9 read tools and 11 write tools; the hosted catalogue lists 19, 11 of them writes. Reads cover campaigns, ad groups, keywords, search terms and reports by day, week or month with 9 metrics and 8 dimensions. Writes change status, budgets and bids, each after a preview, and new items are created paused.
The pricing page lists Free on 1 ad account with 200 requests a month, Pro at $39 a month and Team at $99.
Install
Run in a terminal
claude mcp add apple-ads --env APPLE_ADS_CLIENT_ID='<APPLE_ADS_CLIENT_ID>' --env APPLE_ADS_TEAM_ID='<APPLE_ADS_TEAM_ID>' --env APPLE_ADS_KEY_ID='<APPLE_ADS_KEY_ID>' --env APPLE_ADS_PRIVATE_KEY='<APPLE_ADS_PRIVATE_KEY>' --env APPLE_ADS_AD_ACCOUNT_IDS='<APPLE_ADS_AD_ACCOUNT_IDS>' -- npx -y @getmcpads/apple-ads-mcp-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"apple-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/apple-ads-mcp-server"
],
"env": {
"APPLE_ADS_CLIENT_ID": "<APPLE_ADS_CLIENT_ID>",
"APPLE_ADS_TEAM_ID": "<APPLE_ADS_TEAM_ID>",
"APPLE_ADS_KEY_ID": "<APPLE_ADS_KEY_ID>",
"APPLE_ADS_PRIVATE_KEY": "<APPLE_ADS_PRIVATE_KEY>",
"APPLE_ADS_AD_ACCOUNT_IDS": "<APPLE_ADS_AD_ACCOUNT_IDS>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"apple-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/apple-ads-mcp-server"
],
"env": {
"APPLE_ADS_CLIENT_ID": "<APPLE_ADS_CLIENT_ID>",
"APPLE_ADS_TEAM_ID": "<APPLE_ADS_TEAM_ID>",
"APPLE_ADS_KEY_ID": "<APPLE_ADS_KEY_ID>",
"APPLE_ADS_PRIVATE_KEY": "<APPLE_ADS_PRIVATE_KEY>",
"APPLE_ADS_AD_ACCOUNT_IDS": "<APPLE_ADS_AD_ACCOUNT_IDS>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"apple-ads": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@getmcpads/apple-ads-mcp-server"
],
"env": {
"APPLE_ADS_CLIENT_ID": "<APPLE_ADS_CLIENT_ID>",
"APPLE_ADS_TEAM_ID": "<APPLE_ADS_TEAM_ID>",
"APPLE_ADS_KEY_ID": "<APPLE_ADS_KEY_ID>",
"APPLE_ADS_PRIVATE_KEY": "<APPLE_ADS_PRIVATE_KEY>",
"APPLE_ADS_AD_ACCOUNT_IDS": "<APPLE_ADS_AD_ACCOUNT_IDS>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"apple-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/apple-ads-mcp-server"
],
"env": {
"APPLE_ADS_CLIENT_ID": "<APPLE_ADS_CLIENT_ID>",
"APPLE_ADS_TEAM_ID": "<APPLE_ADS_TEAM_ID>",
"APPLE_ADS_KEY_ID": "<APPLE_ADS_KEY_ID>",
"APPLE_ADS_PRIVATE_KEY": "<APPLE_ADS_PRIVATE_KEY>",
"APPLE_ADS_AD_ACCOUNT_IDS": "<APPLE_ADS_AD_ACCOUNT_IDS>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"apple-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/apple-ads-mcp-server"
],
"env": {
"APPLE_ADS_CLIENT_ID": "<APPLE_ADS_CLIENT_ID>",
"APPLE_ADS_TEAM_ID": "<APPLE_ADS_TEAM_ID>",
"APPLE_ADS_KEY_ID": "<APPLE_ADS_KEY_ID>",
"APPLE_ADS_PRIVATE_KEY": "<APPLE_ADS_PRIVATE_KEY>",
"APPLE_ADS_AD_ACCOUNT_IDS": "<APPLE_ADS_AD_ACCOUNT_IDS>"
}
}
}
}Configuration
APPLE_ADS_CLIENT_IDclientId shown in Apple Ads under Account Settings > API.RequiredAPPLE_ADS_TEAM_IDteamId shown in Apple Ads under Account Settings > API.RequiredAPPLE_ADS_KEY_IDkeyId shown in Apple Ads under Account Settings > API.RequiredAPPLE_ADS_PRIVATE_KEYEC P-256 private key in PEM text. Set this or APPLE_ADS_PRIVATE_KEY_PATH. Keep it secret.APPLE_ADS_PRIVATE_KEY_PATHAbsolute path to the private key PEM file, instead of APPLE_ADS_PRIVATE_KEY.APPLE_ADS_AD_ACCOUNT_IDSComma-separated allowed ad account IDs. Required even for reads.RequiredAPPLE_ADS_ENABLE_WRITEStrue enables write tools. Defaults to false.
Tools this server provides (9)
Taken from the project documentation; the running server may differ.
- apple_ads_get_campaigns
- Reads campaigns.
- apple_ads_get_report
- Reads performance reports.
- apple_ads_get_app_eligibility
- Checks app eligibility by country.
- apple_ads_get_keywords
- Reads keywords.
- apple_ads_update_keyword
- Updates a keyword bid after a preview.
- apple_ads_update_campaign
- Updates a campaign.
- apple_ads_create_campaign
- Creates a paused campaign.
- apple_ads_create_adgroup
- Creates an ad group.
- apple_ads_create_keyword
- Creates a keyword.
What it does
- Search term reports
- Shows spend, taps and installs to find terms that cost without converting.
- Campaign reports
- By day, week or month.
- App eligibility
- Checks whether an app can run in a country.
- Preview-first writes
- Bids, budgets and status changes wait for confirmation.
- Paused creation
- New campaigns and keywords start paused.
- Account allowlist
- Restricts the server to named ad accounts.
Good for
- Find wasteful search terms
- Report spend by week for US campaigns
- Check app eligibility before a country launch
- Raise a keyword bid
- Pause a campaign and cut its budget
Pricing
Freemium, from $39 a month
Free on 1 ad account; Pro $39/month, Team $99/month
Prices change. Check getmcpads.com before you buy.
Apple Ads FAQ
Can it change my campaigns?
Yes, with writes enabled, but each change stops at a preview until you confirm.
What does it cost?
Free on 1 ad account; Pro is $39 a month and Team $99.
Do I need API keys?
The hosted version signs in with Apple; the npm package needs Apple Ads API credentials.
Does it need an account allowlist?
Yes, APPLE_ADS_AD_ACCOUNT_IDS is required even for reads.
Is Apple Ads free?
Apple Ads has a free plan, with paid plans for more usage or features. Paid plans start at $39 a month.
How do I add Apple Ads to Claude Code?
Run this command in your terminal: claude mcp add apple-ads --env APPLE_ADS_CLIENT_ID='<APPLE_ADS_CLIENT_ID>' --env APPLE_ADS_TEAM_ID='<APPLE_ADS_TEAM_ID>' --env APPLE_ADS_KEY_ID='<APPLE_ADS_KEY_ID>' --env APPLE_ADS_PRIVATE_KEY='<APPLE_ADS_PRIVATE_KEY>' --env APPLE_ADS_AD_ACCOUNT_IDS='<APPLE_ADS_AD_ACCOUNT_IDS>' -- npx -y @getmcpads/apple-ads-mcp-server
What are the best alternatives to Apple Ads?
The closest alternatives to Apple Ads are Google Ads + Meta Ads + SEO/GEO MCP, Calven, MCP, Red Center Studio free tools and ASOScan.
Alternatives to Apple Ads

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat
- 8 tools
- Remote
- Freemium
- 8.1K GitHub stars
- Marketing and SEO

Calven
MCP serverProduct marketing context from Calven delivered into Claude, ChatGPT and other AI tools
Not checked yet- Remote
- Free trial
- 3 GitHub stars
- Marketing and SEO

MCP
MCP serverMCP server for planning, scheduling and measuring social and ad campaigns with approvals
- Remote
- Freemium
- Marketing and SEO

Red Center Studio free tools
MCP serverFree website checks for AI readiness, DNS dependencies, domain health and Bubble errors
- 5 tools
- Remote
- Free
- Marketing and SEO

ASOScan
MCP serverASO data for your own iOS and Android apps: rankings, keywords, reviews, scores
- Remote
- Free trial
- Marketing and SEO

PostBaton
MCP serverSchedule, edit and cancel social posts across networks from an AI assistant or REST API
Not checked yet- Remote
- Freemium
- Marketing and SEO