Skip to content
MCP server

Apple Ads

Read Apple Ads search campaigns and preview changes before they apply

Runs locallyStatus and history
Install
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-server

Add 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.Required
  • APPLE_ADS_TEAM_IDteamId shown in Apple Ads under Account Settings > API.Required
  • APPLE_ADS_KEY_IDkeyId shown in Apple Ads under Account Settings > API.Required
  • APPLE_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.Required
  • APPLE_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

  1. Hosted 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
  2. Calven

    MCP server

    Product marketing context from Calven delivered into Claude, ChatGPT and other AI tools

    Not checked yet
    • Remote
    • Free trial
    • 3 GitHub stars
    • Marketing and SEO
  3. MCP

    MCP server

    MCP server for planning, scheduling and measuring social and ad campaigns with approvals

    • Remote
    • Freemium
    • Marketing and SEO
  4. Free website checks for AI readiness, DNS dependencies, domain health and Bubble errors

    • 5 tools
    • Remote
    • Free
    • Marketing and SEO
  5. ASOScan

    MCP server

    ASO data for your own iOS and Android apps: rankings, keywords, reviews, scores

    • Remote
    • Free trial
    • Marketing and SEO
  6. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO