Is there an MCP server for Apple Ads?

Yes. Agent Planners runs a hosted MCP server at https://www.agentplanners.com/api/mcp that gives Claude, ChatGPT, Codex and other MCP clients 12 Apple Ads read tools and 14 write tools. Sign in with OAuth or an API key. Writes follow your approval settings; changes you can't take back wait for a person unless an admin exempts a key.

MCP

Apple Ads MCP server: campaigns, keywords and reports in Claude, Codex or Cursor

TL;DR

Apple Ads reaches Claude, Codex or Cursor through the Agent Planners MCP endpoint with 12 reads and 14 writes: ad accounts, campaigns, ad groups, keywords, ads, App Store reports and account health, with creates always paused and delivery, budgets and deletes held for a person.

What this setup adds

Calling Apple's API yourselfAgent Planners MCP
Sign-inYour own JWT client secret, token exchange and renewalA key pair made once on the Apple Ads card; tokens are renewed on our server
Apple Ads toolsWrite each request12 reads and 14 writes, described for the model
ChangesWhatever you sendCreated paused; turning delivery on, budget and bid changes and deletes held for a person
Other platformsApple Ads onlyEvery platform the workspace connected, on one endpoint

How to configure it

  1. 1Connect Apple Ads on its card on Integrations (generate a key pair, add the public key to your Apple Ads API user, paste the Client ID, Team ID and Key ID).
  2. 2Create a key in API & MCP: tools:read for reading, add tools:write for changes. To keep a key to Apple Ads, choose Only these platforms → Apple Ads.
  3. 3Add the server to your client with one of the snippets below, run describe_permissions, then apple_ads__list_ad_accounts.
bash
# Claude Code
claude mcp add --transport http agent-planners https://www.agentplanners.com/api/mcp \
  --header "Authorization: Bearer $AGENTPLANNERS_API_KEY"

# Codex (signs in with OAuth in the browser)
codex mcp add agent-planners --url https://www.agentplanners.com/api/mcp

# Cursor (~/.cursor/mcp.json)
{ "mcpServers": { "agent-planners": { "url": "https://www.agentplanners.com/api/mcp", "headers": { "Authorization": "Bearer ${env:AGENTPLANNERS_API_KEY}" } } } }
Every client's setup, including OAuth sign-in without a key: MCP setup guide.

The Apple Ads tools

ToolKindWhat it does
apple_ads__list_ad_accountsReadThe Apple Ads ad accounts this API user reaches (GET /v1/acls) with its roles on each, and each account's currency, time zone, payment model, product features (APPSTORE_APP_MANUAL = App Store, BUSINESS_BRAND_MANUAL = …
apple_ads__get_ad_accountReadThe selected ad account (GET /v1/ad-accounts/{id}): name, org, time zone, currency, payment model, systemStatus (ACTIVE | INACTIVE) with the blocking reasons (e.g.
apple_ads__list_campaignsReadCampaigns (POST /v1/campaigns/query, paged): id, name, status (ENABLED | PAUSED), systemStatus / displayStatus and their reasons, promotedObjectType (APPSTORE_APP | BUSINESS_BRAND) / promotedObjectId (an app's adamId)…
apple_ads__get_campaignReadONE campaign (GET /v1/campaigns/{id}).
apple_ads__list_ad_groupsReadAd groups (POST /v1/adgroups/query): id, name, campaignId, status, pricingModel (CPT | CPM | CPA), bidStrategy (with its bid, MAJOR), Search Match (automatedKeywordsOptIn), targeting, start / end.
apple_ads__get_ad_groupReadONE ad group (GET /v1/adgroups/{id}).
apple_ads__list_keywordsReadTargeting keywords (POST /v1/keywords/query — Apple REQUIRES a campaignId or adGroupId filter): id, text, matchType (EXACT | BROAD | PHRASE | CATEGORY), status, bid (MAJOR; empty = the ad group's bid).
apple_ads__list_negative_keywordsReadNegative keywords (POST /v1/negative-keywords/query — Apple REQUIRES an adGroupId filter): id, text, matchType, status, campaignId / adGroupId (campaign-level ones have no ad group).
apple_ads__list_adsReadAds (POST /v1/ads/query): id, name, adGroupId, creativeId, status, systemStatus with reasons (AD_APPROVAL_PENDING, AD_APPROVAL_REJECTED, PRODUCT_PAGE_HIDDEN …), displayStatus.
apple_ads__reportReadApp Store performance (POST /v1/reports/apps/{campaigns|adgroups|ads|keywords|searchterms}/query): level? (campaigns default | adgroups | ads | keywords | searchterms — every level but campaigns needs campaignId), sta…
apple_ads__get_account_healthReadAccount health in one read: the ad account's systemStatus and its reasons (no payment method, no delegation …), campaigns not running and why, ads awaiting or failing review.
apple_ads__getReadANY Apple Ads Platform API READ on the selected ad account: method GET with a path (campaigns/{id}, adgroups/{id}, keywords/{id}, ads/{id}, creatives/{id}, product-pages …) or method POST with a …/query path and the A…
apple_ads__create_campaignWriteCreate an App Store campaign — ALWAYS PAUSED (POST /v1/campaigns): { accountId?, name (≤ 200), adamId (the app's App Store id; the account needs that app's content provider delegated), dailyBudget (MAJOR, required), c…
apple_ads__update_campaignWriteChange a campaign (PUT /v1/campaigns/{id}, partial): { accountId?, campaignId, name?, dailyBudget? (MAJOR), startTime?, endTime?, countries? (replaces the list), dryRun? }.
apple_ads__set_campaign_statusWrite — always a personPause or enable ONE campaign: { accountId?, campaignId, status: ENABLED | PAUSED, dryRun? }. ★ ENABLED (spend can start) is PERSON-GATED on every lane.
apple_ads__create_ad_groupWriteCreate an ad group — ALWAYS PAUSED (POST /v1/adgroups): { accountId?, campaignId, name, bid (MAJOR default CPT bid), searchMatch? (Search Match, default false), pricingModel? (CPT default), deviceClass? (["IPHONE","IP…
apple_ads__update_ad_groupWriteChange an ad group (PUT /v1/adgroups/{id}): { accountId?, adGroupId, name?, bid? (MAJOR), searchMatch?, startTime?, endTime?, dryRun? }.
apple_ads__set_ad_group_statusWrite — always a personPause or enable ONE ad group: { accountId?, adGroupId, status: ENABLED | PAUSED, dryRun? }. ★ ENABLED is PERSON-GATED on every lane. dryRun:true checks the write here and returns the exact body — nothing is sent (the …
apple_ads__add_targeting_keywordsWriteAdd keywords to an ad group (POST /v1/keywords/bulk-create, partial success reported per item) — created PAUSED unless status ENABLED (a PERSON approves that): { accountId?, adGroupId, keywords: [{ text, matchType? (E…
apple_ads__update_keywordsWriteChange keywords' bid / status (POST /v1/keywords/bulk-update): { accountId?, keywords: [{ id, bid? (MAJOR), status? }] (≤ 500), dryRun? }.
apple_ads__add_negative_keywordsWriteAdd negative keywords (POST /v1/negative-keywords/bulk-create) at the campaign level (campaignId) or one ad group (adGroupId — exactly one of the two): { accountId?, campaignId? | adGroupId?, keywords: [{ text, matchT…
apple_ads__delete_keywordsWriteDelete targeting keywords (POST /v1/keywords/bulk-delete — they stop serving at once; re-adding makes a new keyword): { accountId?, ids, dryRun? }. dryRun:true checks the write here and returns the exact body — nothin…
apple_ads__delete_negative_keywordsWriteDelete negative keywords (POST /v1/negative-keywords/bulk-delete): { accountId?, ids, dryRun? }. dryRun:true checks the write here and returns the exact body — nothing is sent (the Platform API has no validate-only mo…
apple_ads__delete_campaignWrite — always a personDelete a campaign (DELETE /v1/campaigns/{id} — Apple soft-deletes it and the API cannot bring it back): { accountId?, campaignId, dryRun? }.
apple_ads__delete_ad_groupWrite — always a personDelete an ad group (DELETE /v1/adgroups/{id}, soft-delete): { accountId?, adGroupId, dryRun? }. dryRun:true checks the write here and returns the exact body — nothing is sent (the Platform API has no validate-only mode).
apple_ads__mutateWriteAny other Apple Ads Platform API write on the selected ad account in Apple's own format: { accountId?, method: POST | PUT | DELETE, path (campaigns/{id}, adgroups/{id}, ads, ads/{id}, keywords/bulk-update, negative-ke…

What waits for a person, whatever the key allows

A tools:write key's ordinary Apple Ads writes — a paused campaign, keywords, a negative keyword — either run inside the workspace's guardrails or queue for an admin, depending on how the key was minted. These are held for a person on every key mode:

  • Turning delivery on (status ENABLED on a campaign, ad group or keyword).
  • A budget or bid-strategy change, and an ad group's bid change.
  • Deleting a campaign or ad group, and any delete through the gateway.
Refused outright: money in micros, another ad account, account administration. Apple Ads setup guide · Apple Ads platform page · Apple Ads MCP server

Frequently asked questions

How do I connect Claude to Apple Ads?
Connect Apple Ads on its card on Integrations, create an Agent Planners key in API & MCP, add the MCP server to Claude, and call apple_ads__list_ad_accounts.
Can an MCP client turn an Apple Ads campaign on?
It can ask; a person approves it every time. Turning delivery on is held for a person on every key mode.

About this platform

Put a human-approved agent on your ad ops

Start free — 2,500 credits a month, no credit card. Reads run at once; by default every write waits for your approval.

Related reading