What you can read and write on Apple Ads
| Area | Read | Write |
|---|---|---|
| Campaigns and ad groups | Campaigns and ad groups, org-level find queries | Create, update, delete; age, gender, device and daypart targeting |
| Ads and creatives | Ads, creatives, rejection reasons, product pages | Create ads and creatives from default or custom product pages |
| Keywords | Targeting keywords, campaign and ad group negatives | Create, update and delete, including bulk creates |
| Budgets | Budget orders, shared budgets | Create and update budget orders and shared budgets |
| Reporting | Campaign, ad group, keyword, search term and ad reports; impression share | n/a |
| Recommendations | Daily budget and target CPA recommendations, keyword suggestions, search term popularity | Apply or dismiss recommendations |
| Apps, geos and account | App search and eligibility, geolocations, user access, change details | Location groups |
Ways to run Apple Ads from an AI assistant
| Option | What you get | Trade-off |
|---|---|---|
| Official Apple Ads MCP | None found | n/a |
| Your own API integration | Full control of Apple's APIs | You manage API credentials, token refresh and request formats yourself |
| Whathead | 172 actions, previewed writes, create-rule lookups | Paid plan; Apple Ads is MCP-only in Whathead |
Apple rules the assistant works within
Apple enforces placement rules that trip up generic tools. apple_ads_describe_create_rules returns them before a build, so the assistant plans around them:
- Search Results campaigns use Apple's default ad; you cannot create manual ads there.
- Today Tab and product page placements need an ad built on a custom product page. Today Tab is iPhone only.
- Custom product pages are made in App Store Connect. The MCP reads them and builds creatives on them, but cannot create them.
- Apple Ads is not in the visual builder, cross-platform transfer or the Anomaly Engine.
Set up the Apple Ads MCP
Connect Apple Ads in Whathead
Create API credentials for a user in your Apple Ads account, then add them on the Integrations page and sync your orgs.
Add Whathead to your assistant
In Claude or ChatGPT, add a custom connector with https://www.whathead.com/mcp and approve the sign-in. In Cursor, use the same URL with a bearer token from the Whathead MCP page.
Read the rules first
Ask the assistant to run apple_ads_describe_create_rules before the first build, so placements and creatives line up.
Apple Ads prompts to try
Show spend, installs and cost per install by campaign for org 2258 over the last 14 days.
Pull the search term report for the Brand campaign and list terms with taps but no installs.
Add those terms as exact-match negatives to the ad group.
Add these 40 keywords as broad match with a $1.20 max bid.
Show impression share for our top 10 keywords last week.
Which daily budget recommendations does Apple have for us, and what would they change?
Create a paused Search Tab campaign in the UAE with a $50 daily budget.
Build a Today Tab ad on our Summer custom product page.
Safety and plan limits
Apple Ads writes default to a dry run. The 18 actions Whathead marks destructive, such as deletes, also need confirmed: true.
Apple Ads usage is billed with everything else on the plan: MCP Actions $39/month for 1,500 reads and 100 writes, Operator Bundle $65 for 4,000 and 250, Agency $249 for 15,000 and 750. Start with a 14-day trial.
Frequently asked questions
Is there an official Apple Ads MCP?
We found none as of 18 November 2026. Whathead calls Apple's Campaign Management API and Platform API with your Apple Ads credentials and exposes them to MCP clients.
Is this the same as an Apple Search Ads MCP?
Yes. Apple Search Ads is now called Apple Ads, and the same API covers Search Results, Search Tab, Today Tab and product page placements.
Can it create custom product pages?
No. Custom product pages are created in App Store Connect. Once they exist, the assistant can read them and build creatives and ads on them.
Can it handle large keyword uploads?
Yes. Targeting and negative keywords support bulk create and update calls, so a list of keywords goes in one previewed request.
Run it from one workspace
Every plan starts with a 14-day free trial. Only successful live work is metered.