Skip to content
MCP server

Apple Ads MCP

Local Go MCP server for researching and operating Apple Ads App Store campaigns

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, Linux, CLI
Runs
Locally
Version
0.3.8
Listing updated
today

Similar MCP servers

About Apple Ads MCP

Apple Ads MCP is an open-source MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.

Writes are the sensitive part of ad management, and this server is built around that. It starts read-only; a change only goes through when the Apple API user has a write role, the server runs with --allow-writes, the profile enables writes, a preview tool has validated the payload, and an unexpired single-use receipt is applied against unchanged inventory. Receipts expire after ten minutes, and the README says there is no background scheduler, so spend is never changed on its own.

It targets Apple Ads Platform API v1 and covers four placements: Search Results, Search Tab, Today Tab and Product Pages. Tools span account health, app eligibility, campaign and keyword inventory, keyword and target-CPA research, typed reports, bulk keyword edits, shared budgets and named local optimization policies with 28-day baselines. It has no raw-request tool and does not support the legacy Campaign Management API v5.

Credentials stay on the local machine and every account call names an explicit profile and ad account. It is independent open-source software and not affiliated with Apple.

Install

Run in a terminal

claude mcp add apple-ads-mcp --env APPLE_ADS_MCP_CONFIG='<APPLE_ADS_MCP_CONFIG>' -- docker run -i --rm -e APPLE_ADS_MCP_CONFIG ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.8

Add to claude_desktop_config.json

{
  "mcpServers": {
    "apple-ads-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "APPLE_ADS_MCP_CONFIG",
        "ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.8"
      ],
      "env": {
        "APPLE_ADS_MCP_CONFIG": "<APPLE_ADS_MCP_CONFIG>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "apple-ads-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "APPLE_ADS_MCP_CONFIG",
        "ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.8"
      ],
      "env": {
        "APPLE_ADS_MCP_CONFIG": "<APPLE_ADS_MCP_CONFIG>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "apple-ads-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "APPLE_ADS_MCP_CONFIG",
        "ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.8"
      ],
      "env": {
        "APPLE_ADS_MCP_CONFIG": "<APPLE_ADS_MCP_CONFIG>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "apple-ads-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "APPLE_ADS_MCP_CONFIG",
        "ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.8"
      ],
      "env": {
        "APPLE_ADS_MCP_CONFIG": "<APPLE_ADS_MCP_CONFIG>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "apple-ads-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "APPLE_ADS_MCP_CONFIG",
        "ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.8"
      ],
      "env": {
        "APPLE_ADS_MCP_CONFIG": "<APPLE_ADS_MCP_CONFIG>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • APPLE_ADS_MCP_CONFIGPath to a mounted Apple Ads MCP accounts configuration file.Required

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

server_info
Reports the server's version and capabilities.
account_health
Checks readiness and health for a named profile, ad account and app.
apps_eligibility
Reports whether an app is eligible to advertise.
campaigns_query
Lists campaigns for an ad account.
keywords_query
Lists targeting keywords.
operations_apply
Applies a previewed change using its receipt.
operations_verify
Verifies the outcome of an applied change.

What it does

Receipt-gated writes
Every mutation needs a preview and a short-lived single-use receipt before it applies.
Read-only by default
Sessions can audit and plan without any ability to change spend.
Keyword research
Provides keyword, phrase and category suggestions, search popularity and impression share.
Typed reports
Campaign, ad-group, ad, keyword and search-term reports with bounded pagination.
Optimization policies
Named local policies and 28-day baselines drive plans that are verified item by item.
Local credentials
Private keys stay on the user's machine and are referenced by path.

Good for

  • Audit the structure of an Apple Ads account without changing it
  • Find keyword opportunities and separate Apple data from model inference
  • Bulk-create negative keywords with a previewed, verified change
  • Check which apps and placements an ad account is eligible for

Pricing

Open source

Open-source; needs an Apple Ads API account.

Apple Ads MCP FAQ

How do I install it?

The README gives a Homebrew install, brew install zelentsov-dev/tap/apple-ads-mcp, and an OCI image is also listed in the registry entry.

Can it change my campaigns by accident?

Writes require several gates, including the --allow-writes flag, a write-enabled profile and a fresh receipt.

Does it run optimization automatically?

No. The README says it has no scheduler and never changes spend in the background.

Is it made by Apple?

No. It is independent and states it is not affiliated with or endorsed by Apple.

Is Apple Ads MCP free?

Yes. Apple Ads MCP is open source, so you can use and self-host it for free.

How do I add Apple Ads MCP to Claude Code?

Run this command in your terminal: claude mcp add apple-ads-mcp --env APPLE_ADS_MCP_CONFIG='<APPLE_ADS_MCP_CONFIG>' -- docker run -i --rm -e APPLE_ADS_MCP_CONFIG ghcr.io/zelentsov-dev/apple-ads-mcp:v0.3.8

What are the best alternatives to Apple Ads MCP?

The closest alternatives to Apple Ads MCP are Google Ads + Meta Ads + SEO/GEO MCP, Calven, Customer Io, Google_search_console and Ads AI Creator MCP.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers