Name: Apple Ads MCP Server
Author: Gumloop

Manage App Store and Apple Maps advertising with the Apple Ads Platform API: ad accounts, apps, campaigns, ad groups, keywords, ads, creatives, budget orders, reports, insights, recommendations and change history

Apple Ads guMCP Server

Get the user ID and organization ID behind the connected Apple Ads credential

get_me

List the ad accounts the connected credential can access, with the roles held on each

list_ad_accounts

Single JSON object with key `items` (list of records)

Get an ad account's details, including currency, time zone, payment model, product features and delegations

get_ad_account

Create an ad account under the organization for App Store or Apple Maps advertising

create_ad_account

Rename an ad account or replace its delegations

update_ad_account

Get an organization's name, currency, time zone, payment model and system status

get_org

List the brands or content providers in the organization that can be delegated to an ad account

list_advertiser_resources

Search the App Store catalog by app or developer name, or list the apps your organization owns, to find an app's Adam ID

search_apps

Single JSON object with keys `items` (list of records) and `next_cursor`, which you pass back as cursor to fetch the next batch (null when no more).

Get an app's App Store details, including genre, supported devices and the countries or regions it is available in

get_app

Check which App Store placements, countries or regions and device classes an app is eligible to advertise in

check_app_eligibility

List the countries or regions Apple Ads serves in and the ad languages supported in each

list_supported_languages

List why Apple rejected product page creatives for an app

list_app_rejection_reasons

Get one product page creative rejection reason by ID

get_app_rejection_reason

List an app's custom product pages from App Store Connect, to use in CUSTOM_PRODUCT_PAGE creatives

list_product_pages

get_product_page

List the localized name, subtitle, promotional text and assets of a custom product page

list_product_page_locale_details

List the localized name, subtitle, promotional text and assets of an app's default product page

list_app_locale_details

List campaigns in an ad account, optionally filtered by name, status, promoted app or brand

list_campaigns

Get a campaign's settings, budget, targeting, bid strategy and delivery status

get_campaign

Create an App Store or Apple Maps campaign with a daily budget, placements, countries and bid strategy

create_campaign

Update a campaign's name, status, budget, schedule, placements, countries or bid strategy; only the fields you pass change

update_campaign

set_campaign_status

Delete a campaign and everything under it (ad groups, keywords, ads); this cannot be undone

delete_campaign

Get why a legacy app campaign's delivery is limited, per country or region

get_campaign_limited_status_reasons

JSON object mapping each country or region code to its limiting reasons

List ad groups in an ad account or campaign, optionally filtered by name or status

list_ad_groups

Get an ad group's targeting, bid strategy, schedule and delivery status

get_ad_group

Create an ad group in a campaign with its bid strategy, schedule and targeting

create_ad_group

Update an ad group's name, status, schedule, Search Match, bid strategy or targeting; only the fields you pass change

update_ad_group

set_ad_group_status

Delete an ad group and its ads, keywords and negative keywords; this cannot be undone

delete_ad_group

Search countries, states, cities or postal codes by name to get the IDs used in ad group geo targeting

search_geo_locations

Look up geo targeting places by ID or legacy ID (e.g. 'US|CA|San Francisco') with their eligibility

lookup_geo_locations

List keywords in an ad group or campaign, optionally filtered by text, match type or status

list_keywords

Get a keyword's text, match type, bid and delivery status

get_keyword

Add one keyword to an ad group with an optional bid; use bulk_create_keywords for several

create_keyword

update_keyword

Delete a keyword; pause it instead if you may want it back

delete_keyword

Add many keywords in one call, to one ad group or across several

bulk_create_keywords

Single JSON object with key `items`, one result per input item with correlationId, success and the entity or error details

Change bids or statuses on many keywords in one call

bulk_update_keywords

bulk_delete_keywords

set_keywords_status

Set the same bid on a set of keywords by ID

set_keyword_bids

List negative keywords of an ad group, or the campaign-level or ad-group-level negatives of a campaign

list_negative_keywords

Get a negative keyword and whether it applies to a campaign or an ad group

get_negative_keyword

Exclude a search term for a whole campaign or a single ad group

create_negative_keyword

update_negative_keyword

Delete a negative keyword so its search term can trigger ads again

delete_negative_keyword

Exclude many search terms in one call, at campaign or ad group level

bulk_create_negative_keywords

Pause or re-enable many negative keywords in one call

bulk_update_negative_keywords

Delete many negative keywords in one call

bulk_delete_negative_keywords

List ads in an ad account, campaign or ad group

list_ads

Get an ad with its delivery status and the reasons it is not running

get_ad

Create an ad that serves a creative in an ad group; only one ad per ad group can be enabled

create_ad

update_ad

set_ad_status

Delete an ad; the creative stays available for other ads

delete_ad

List creatives in an ad account, optionally filtered by name, type or review status

list_creatives

Get a creative with its destination, review status and eligibility

get_creative

Create a creative from an app's default or custom product page, or from Apple Maps brand assets

create_creative

Rename a creative or change its Apple Maps creative content, which sends it back to review

update_creative

Delete a creative; ads using it stop serving and this cannot be undone

delete_creative

List image assets of a brand or app with their eligibility status

list_assets

Get an asset's details and processing or eligibility status

get_asset

Upload a PNG, JPG or HEIC image from Gumloop file storage as an Apple Maps brand asset

upload_asset

delete_asset

List the Apple Maps brands the ad account can promote, with their eligibility

list_brands

Get an Apple Maps brand's name, markets, categories and eligibility

get_brand

List Apple Maps business categories, whose qualified IDs (e.g. 'dining.restaurant') are used as CATEGORY keywords

list_business_categories

Get an Apple Maps business category by ID

get_business_category

List why Apple rejected a brand's Apple Maps creatives or assets

list_brand_rejection_reasons

List a brand's business locations, optionally filtered by name, status or address

list_locations

Get a business location's address, coordinates, categories and status

get_location

List location groups used to target Apple Maps ad groups at a set of business locations

list_location_groups

Get a location group's membership, rules, system status and eligibility

get_location_group

Create a STATIC location group from location IDs or a DYNAMIC one from rules

create_location_group

Rename a location group or replace its location IDs or rules

update_location_group

Delete a location group; ad groups targeting it lose that constraint immediately

delete_location_group

List budget orders (shared spend caps for monthly-invoiced accounts), optionally by name, status or ad account

list_budget_orders

Get a budget order's amount, schedule, assigned ad accounts and status

get_budget_order

Create a budget order that caps total spend across the campaigns assigned to it

create_budget_order

Update a budget order's name, amount, schedule, ad accounts or invoice details; only the fields you pass change

update_budget_order

Delete a budget order that has not started and has no campaigns assigned

delete_budget_order

Get a compact spend, impressions, taps and installs summary per campaign for a range of UTC days, sorted by spend; defaults to the last 7 complete days

get_performance_summary

Single JSON object with `start_date`, `end_date`, `time_zone` (always UTC), `currency`, `items` (one compact row per campaign with id, name, status and the main metrics), `grand_total` and `next_cursor` (null when no more).

Get campaign performance metrics for a date range, optionally split by device, demographics or location

get_campaign_report

Single JSON object with `items` (one row per entity with metadata, totalMetrics and, when a granularity is set, granularMetrics), `grand_total` when requested, and `next_cursor` to pass back as cursor (null when no more).

Get ad group performance metrics in a campaign for a date range

get_ad_group_report

Get ad performance metrics in a campaign for a date range (daily or coarser)

get_ad_report

Get keyword performance metrics in a campaign for a date range, including Apple's bid recommendation per keyword

get_keyword_report

Get the search terms that triggered your ads in a campaign, with their metrics and matched keyword, for a date range

get_search_term_report

Get your app's share of App Store search impressions per search term and country, with its rank and the term's popularity

get_impression_share

Get the most popular App Store search terms for a genre and country, ranked by search volume

get_search_term_popularity

List Apple's daily budget increase recommendations for an app or brand's campaigns, with historical and expected metrics

list_daily_budget_recommendations

Apply daily budget recommendations, raising each campaign's daily budget to the suggested or given amount

apply_daily_budget_recommendations

Single JSON object with key `items`, one history record per recommendation with its new state and the applied value

Dismiss daily budget recommendations without changing any budget

dismiss_daily_budget_recommendations

List Apple's target CPA recommendations for an app's Maximize Conversions campaigns

list_target_cpa_recommendations

Apply target CPA recommendations, setting each campaign's target CPA to the suggested or given value

apply_target_cpa_recommendations

Dismiss target CPA recommendations without changing any bid strategy

dismiss_target_cpa_recommendations

Get keyword ideas for an app with popularity scores, optionally seeded by terms and scoped to countries

get_keyword_suggestions

Discover popular search phrases for an app or brand, or look up the popularity of specific phrases

get_phrase_suggestions

Discover popular categories for an app or brand, or look up the popularity of specific category names

get_category_suggestions

Get the suggested target CPA for a new Maximize Conversions campaign for an app, based on its recent cost per install

get_target_cpa_suggestion

JSON object with the suggested target CPA, the countries or regions it covers and the app category

Apple Ads

MCP server URL

Works with

Tools 102