Apple Ads

What apple-ads MCP server does

The apple-ads MCP server connects an MCP-compatible AI client to Apple Search Ads API v5. It supports account and organization operations, campaign and ad group management, keyword targeting, ads, creatives, product pages, budget orders, geographic targeting, search-term analysis, impression-share reports, and performance reporting.

The server provides 54 tools, three resources, and six prompts according to the project documentation. Supported reporting scopes include campaigns, ad groups, keywords, ads, and geographic performance, with date presets available for reports. Requests can be phrased conversationally, such as asking for recent campaign performance or changing a campaign budget.

How it works

The server uses STDIO transport, so the MCP client starts the package as a local process. It communicates with Apple Search Ads using credentials issued from the Apple Ads account and a PKCS#8 private key. The API user must be invited by an account administrator and can have either full read/write access or read-only access.

Organizations can be listed and selected while the server is running. Setting an organization ID in the environment selects a default; omitting it allows the client to use the organization-management tools to switch context.

Setup and configuration

Install and run the package with:

npx -y apple-ads-mcp

Before connecting a client, an Apple Ads administrator must invite an API user through User Management. The invited user then copies the clientId, teamId, and keyId values from the API settings. The project instructions also require generating an elliptic-curve key pair with OpenSSL and uploading the public key to Apple.

Configure these environment variables in the MCP client:

• ASA_CLIENT_ID: Apple Ads client ID.
• ASA_TEAM_ID: Apple Ads team ID.
• ASA_KEY_ID: Apple Ads key ID.
• ASA_PRIVATE_KEY_PATH: Absolute path to the PKCS#8 private key.
• ASA_ORG_ID: Optional default organization ID.

The private key can instead be supplied inline through ASA_PRIVATE_KEY, using escaped newline characters in the PEM value. The configuration examples cover Claude Desktop, Claude Code, Cursor, VS Code, Windsurf, and other STDIO-compatible clients.

Tools and capabilities

The apple-ads MCP server includes tools for:

• Listing, creating, updating, pausing, and deleting campaigns and ad groups.
• Adding or removing targeting and negative keywords and changing bids.
• Listing, creating, updating, and deleting ads, plus checking ad reports and rejection reasons.
• Managing creatives, product pages, budget orders, and budget utilization.
• Finding eligible apps, assets, geolocations, and geographic targeting options.
• Examining actual search queries that led to ad taps.
• Retrieving campaign, ad group, keyword, ad, geo, and impression-share reports.

Limitations and notes

Access depends on Apple Ads API permissions. An API Account Manager can perform read/write operations, while an API Account Read Only user is limited to viewing data. The API user must be different from the administrator’s Apple ID. The documentation describes Apple credentials and key setup but does not state service pricing or a separate hosted deployment option.