Apple Ads MCP server: campaigns, keywords and reports in Claude, Codex or Cursor
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 yourself | Agent Planners MCP | |
|---|---|---|
| Sign-in | Your own JWT client secret, token exchange and renewal | A key pair made once on the Apple Ads card; tokens are renewed on our server |
| Apple Ads tools | Write each request | 12 reads and 14 writes, described for the model |
| Changes | Whatever you send | Created paused; turning delivery on, budget and bid changes and deletes held for a person |
| Other platforms | Apple Ads only | Every platform the workspace connected, on one endpoint |
How to configure it
- 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).
- 2Create a key in API & MCP:
tools:readfor reading, addtools:writefor changes. To keep a key to Apple Ads, choose Only these platforms → Apple Ads. - 3Add the server to your client with one of the snippets below, run
describe_permissions, thenapple_ads__list_ad_accounts.
# 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}" } } } }The Apple Ads tools
| Tool | Kind | What it does |
|---|---|---|
apple_ads__list_ad_accounts | Read | The 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_account | Read | The 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_campaigns | Read | Campaigns (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_campaign | Read | ONE campaign (GET /v1/campaigns/{id}). |
apple_ads__list_ad_groups | Read | Ad 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_group | Read | ONE ad group (GET /v1/adgroups/{id}). |
apple_ads__list_keywords | Read | Targeting 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_keywords | Read | Negative 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_ads | Read | Ads (POST /v1/ads/query): id, name, adGroupId, creativeId, status, systemStatus with reasons (AD_APPROVAL_PENDING, AD_APPROVAL_REJECTED, PRODUCT_PAGE_HIDDEN …), displayStatus. |
apple_ads__report | Read | App 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_health | Read | Account 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__get | Read | ANY 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_campaign | Write | Create 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_campaign | Write | Change a campaign (PUT /v1/campaigns/{id}, partial): { accountId?, campaignId, name?, dailyBudget? (MAJOR), startTime?, endTime?, countries? (replaces the list), dryRun? }. |
apple_ads__set_campaign_status | Write — always a person | Pause or enable ONE campaign: { accountId?, campaignId, status: ENABLED | PAUSED, dryRun? }. ★ ENABLED (spend can start) is PERSON-GATED on every lane. |
apple_ads__create_ad_group | Write | Create 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_group | Write | Change an ad group (PUT /v1/adgroups/{id}): { accountId?, adGroupId, name?, bid? (MAJOR), searchMatch?, startTime?, endTime?, dryRun? }. |
apple_ads__set_ad_group_status | Write — always a person | Pause 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_keywords | Write | Add 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_keywords | Write | Change keywords' bid / status (POST /v1/keywords/bulk-update): { accountId?, keywords: [{ id, bid? (MAJOR), status? }] (≤ 500), dryRun? }. |
apple_ads__add_negative_keywords | Write | Add 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_keywords | Write | Delete 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_keywords | Write | Delete 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_campaign | Write — always a person | Delete a campaign (DELETE /v1/campaigns/{id} — Apple soft-deletes it and the API cannot bring it back): { accountId?, campaignId, dryRun? }. |
apple_ads__delete_ad_group | Write — always a person | Delete 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__mutate | Write | Any 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.
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.