Apple Ads MCP
apple-search-ads-mcp
Ein Model Context Protocol (MCP) Server, der die vollständige Apple Search Ads (jetzt Apple Ads) Campaign Management API v5 kapselt. 74 typisierte Tools, 1:1-Abbildung auf jeden dokumentierten v5-Endpunkt — Kampagnen, Anzeigengruppen, Anzeigen, Creatives, benutzerdefinierte Produktseiten, Keywords, negative Keywords, Berichte, Impression-Share-Berichte, Budgetaufträge, ACLs, Geo-/App-Suche, App-Metadaten, Audits von Ablehnungsgründen — plus ein Raw-Passthrough für zukünftige Endpunkte.
API-Lebenszyklus: Apple Ads (Search Ads) v5 ist die aktuelle Produktions-API. v5 wird am 26. Januar 2027 zugunsten der neuen "Apple Ads Platform API", die im Sommer 2026 erscheint, eingestellt. Dieser Server zielt auf v5.0 → v5.5 ab.
Schnellinstallation
git clone https://github.com/AppVisionOS/apple-search-ads-mcp.git
cd apple-search-ads-mcp
npm install
npm run buildDann mit einer Zeile bei Claude Code registrieren:
claude mcp add apple-search-ads --scope user \
-e ASA_CLIENT_ID=SEARCHADS.xxxx \
-e ASA_TEAM_ID=SEARCHADS.xxxx \
-e ASA_KEY_ID=xxxx \
-e ASA_PRIVATE_KEY_PATH=/absolute/path/to/asa-private.p8 \
-e ASA_ORG_ID=1234567 \
-- node $(pwd)/dist/index.jsRelated MCP server: aapl-ads-mcp
Einrichtung
1. API-Zugangsdaten abrufen
Die Apple Ads-Benutzeroberfläche teilt die Zugangsdaten auf zwei Bildschirme auf. Der Tab API in den Kontoeinstellungen verwaltet nur den Zugriff für Drittanbieter; für Ihren eigenen programmatischen Zugriff führt der Weg zuerst über die Benutzerverwaltung.
a) API-Benutzer einladen
Unter app-ads.apple.com → Kontoeinstellungen → Benutzerverwaltung → Benutzer einladen:
E-Mail: Jede Adresse, die Sie kontrollieren (kann Ihre eigene sein; Apple erfordert eine separate Apple ID für den API-Benutzer)
Rolle: Wählen Sie eine mit API-Berechtigungen (z. B. API Account Manager)
Senden Sie die Einladung und akzeptieren Sie diese dann im Posteingang des eingeladenen Benutzers
b) Schlüsselpaar lokal generieren
Während die Einladung bearbeitet wird, generieren Sie ein ES256-Schlüsselpaar auf Ihrem Rechner. Stellen Sie sicher, dass es PKCS#8 ist — Apples .p8-Beispiele und die ältere openssl ecparam-Ausgabe sind kein PKCS#8 und jose kann diese nicht laden.
# CORRECT — produces PKCS#8 (-----BEGIN PRIVATE KEY-----)
openssl genpkey -algorithm EC -pkeyopt ec_paramgen_curve:P-256 -out asa-private.p8
openssl ec -in asa-private.p8 -pubout -out asa-public.pem
# If you already produced traditional EC (-----BEGIN EC PRIVATE KEY-----), convert it:
# openssl pkcs8 -topk8 -nocrypt -in asa-private.p8 -out asa-private-pkcs8.p8Bewahren Sie asa-private.p8 an einem sicheren Ort auf (z. B. ~/.apple-search-ads/, chmod 600). Sie fügen nur die öffentliche Hälfte bei Apple ein.
c) API-Client generieren
Melden Sie sich ab und als eingeladener API-Benutzer (nicht als Admin-Konto) wieder an. Gehen Sie zu Kontoeinstellungen → API. Sie sehen einen Bildschirm Client-Zugangsdaten mit einem Textfeld für den öffentlichen Schlüssel — dies erscheint nur für Benutzer, die die API-Rolle innehaben.
Fügen Sie den Inhalt von
asa-public.pemein (mit den Markierungen-----BEGIN PUBLIC KEY-----/-----END PUBLIC KEY-----).Klicken Sie auf API-Client generieren.
Kopieren Sie die drei Werte, die Apple Ihnen anzeigt: Client ID, Team ID, Key ID — diese erscheinen später nicht mehr.
2. Installation
npm install
npm run build3. Konfiguration
Kopieren Sie .env.example nach .env und füllen Sie es aus, oder übergeben Sie Umgebungsvariablen über Ihren MCP-Client.
ASA_CLIENT_ID=SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
ASA_TEAM_ID=SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
ASA_KEY_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
ASA_PRIVATE_KEY_PATH=/absolute/path/to/private-key.p8
ASA_ORG_ID=1234567 # optional default; can be overridden per callASA_PRIVATE_KEY (PEM-Inhalt inline, mit \n-Escapes, falls über JSON injiziert) wird als Alternative zu ASA_PRIVATE_KEY_PATH unterstützt.
4. In Ihren MCP-Client einbinden
{
"mcpServers": {
"apple-search-ads": {
"command": "node",
"args": ["/absolute/path/to/apple-search-ads-mcp/dist/index.js"],
"env": {
"ASA_CLIENT_ID": "SEARCHADS.xxxx...",
"ASA_TEAM_ID": "SEARCHADS.xxxx...",
"ASA_KEY_ID": "xxxx...",
"ASA_PRIVATE_KEY_PATH": "/absolute/path/to/private-key.p8",
"ASA_ORG_ID": "1234567"
}
}
}
}Authentifizierung
Der Server handhabt den OAuth 2.0 Client-Credentials-Flow mit einer ES256 JWT-Client-Assertion:
Signieren Sie ein JWT mit Ihrem privaten
.p8-Schlüssel (Header:kid=Key ID,alg=ES256; Payload:iss=Team ID,sub=Client ID,aud=https://appleid.apple.com).Senden Sie es per POST an
https://appleid.apple.com/auth/oauth2/tokenmitgrant_type=client_credentialsundscope=searchadsorg.Verwenden Sie das zurückgegebene 1-Stunden-Zugriffstoken mit
Authorization: Bearer …undX-AP-Context: orgId=…bei jedem API-Aufruf.
Das Token wird im Speicher bis ca. 30 s vor Ablauf zwischengespeichert, sodass Sie eine Assertion signieren und ein Token pro Stunde austauschen. Bei 401 erzwingt der Server eine Aktualisierung und versucht es einmal erneut. Bei 429/5xx wird das Tempo gedrosselt (unter Beachtung von Retry-After), bis zu 3 Mal.
Tool-Inventar (74 Tools)
Konto & Zugriff (2)
org_acls, me_user — ohne Organisationskontext aufrufen, um herauszufinden, was Ihr Token tun kann.
Entdeckung (3)
search_apps, search_geo, geo_lookup
App-Metadaten (6)
apps_get, apps_locale_details, apps_eligibilities_find, apps_assets_find, creative_app_preview_devices, countries_or_regions_list
Benutzerdefinierte Produktseiten (3)
cpp_list, cpp_get, cpp_locale_details
Kampagnen (6)
campaigns_create, campaigns_get, campaigns_list, campaigns_find, campaigns_update, campaigns_delete
Anzeigengruppen (7)
adgroups_create, adgroups_get, adgroups_list, adgroups_find_in_campaign, adgroups_find_org_wide, adgroups_update, adgroups_delete
Creatives (4)
creatives_create, creatives_list, creatives_get, creatives_find — Creatives kapseln eine Referenz auf eine benutzerdefinierte Produktseite, eine Standard-Produktseite oder ein Creative-Set. Anzeigen werden über creativeId an Creatives gebunden.
Anzeigen (7)
ads_create, ads_get, ads_list, ads_find_in_campaign, ads_find_org_wide, ads_update, ads_delete
Targeting-Keywords (7)
targeting_keywords_create, targeting_keywords_get, targeting_keywords_list, targeting_keywords_find, targeting_keywords_update, targeting_keywords_delete (Bulk), targeting_keywords_delete_single
Negative Keywords — Anzeigengruppen-Bereich (6)
adgroup_negative_keywords_create, adgroup_negative_keywords_get, adgroup_negative_keywords_list, adgroup_negative_keywords_find, adgroup_negative_keywords_update, adgroup_negative_keywords_delete
Negative Keywords — Kampagnen-Bereich (6)
campaign_negative_keywords_create, campaign_negative_keywords_get, campaign_negative_keywords_list, campaign_negative_keywords_find, campaign_negative_keywords_update, campaign_negative_keywords_delete
Berichte (7)
Tool | Endpunkt |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Alle akzeptieren startTime, endTime, optional granularity (HOURLY/DAILY/WEEKLY/MONTHLY), optional groupBy (adminArea / ageRange / countryCode / countryOrRegion / deviceClass / gender / locality), selector, returnRowTotals, returnGrandTotals, returnRecordsWithNoMetrics, timeZone (UTC | ORTZ).
Impression-Share-Berichte (3) — asynchron
custom_reports_create → gibt reportId zurück. Mit custom_reports_get abfragen, bis state=COMPLETED. Mit custom_reports_list auflisten.
Budgetaufträge (4) — nur LOC-Konten
budget_orders_create, budget_orders_get, budget_orders_list, budget_orders_update. v5 hat kein Löschen für Budgetaufträge.
Audit von Ablehnungsgründen (2)
product_page_reasons_find, product_page_reasons_get — schreibgeschützte Überprüfung, warum Apples Prüfer Creatives abgelehnt haben.
Notausgang (1)
apple_search_ads_request — jeden Pfad mit jeder Methode aufrufen. Authentifizierung und Organisationskontext werden weiterhin für Sie gehandhabt.
Selektoren
*_find-Tools akzeptieren Apples Selektor-Grammatik:
{
"conditions": [
{ "field": "status", "operator": "EQUALS", "values": ["ENABLED"] },
{ "field": "countriesOrRegions", "operator": "CONTAINS_ANY", "values": ["US", "GB"] }
],
"fields": ["id", "name", "status"],
"orderBy": [{ "field": "name", "sortOrder": "ASCENDING" }],
"pagination": { "limit": 100, "offset": 0 }
}Operatoren: EQUALS, NOT_EQUALS, CONTAINS, STARTS_WITH, ENDS_WITH, GREATER_THAN, LESS_THAN, IN, NOT_IN, CONTAINS_ALL, CONTAINS_ANY, BETWEEN. values ist immer ein Array.
End-to-End-Beispiel
Ein Workflow, den Sie vollständig über Claude steuern können:
org_acls→ dieorgIdauswählen.search_appsfür Ihre App → dieadamIdabrufen.campaigns_createmit dieser adamId, Tagesbudget, US-Targeting,adChannelType=SEARCH,supplySources=["APPSTORE_SEARCH_RESULTS"],billingEvent=TAPS.adgroups_createinnerhalb der Kampagne mitdefaultBidAmount={amount:"1.00",currency:"USD"}undpricingModel=CPC.targeting_keywords_createmit einer Reihe von{text, matchType, bidAmount}-Zeilen.cpp_list→ eine productPageId auswählen →creatives_createmittype=CUSTOM_PRODUCT_PAGE, um eine creativeId zu erstellen →ads_create, um sie an die Anzeigengruppe zu binden.Warten Sie ein paar Tage.
reports_campaignsfür die Top-Level-Daten, dannreports_search_terms_in_campaign, um neue Keywords / negative Keywords zu sammeln.custom_reports_createfür Impression-Share / Share-of-Voice bei Ihren Top-Suchanfragen.
Bekannte Hinweise (v5-Besonderheiten)
Kein Legacy-Creative-Set CRUD. Apple hat es in v5 entfernt; erstellen Sie stattdessen eine
creatives-Zeile und referenzieren Sie diese vonads.creativeId.Kein App-Kategorien-Endpunkt. Verwenden Sie
apps_getund lesen SieprimaryGenre/secondaryGenre.Kein Geo-Targeting nach Postleitzahlen. Geo-Entitäten in v5 sind nur Country / AdminArea / Locality.
Keine organisationsweite Suche nach Keywords oder Suche nach Keywords auf Anzeigengruppenebene. Apple begrenzt die Suche nach Targeting-Keywords auf Kampagnenebene (
/campaigns/{id}/adgroups/targetingkeywords/find) und fasst sie über Anzeigengruppen hinweg zusammen; filtern Sie nachadGroupIdim Selektor, um die Suche einzugrenzen.Kein DELETE bei Budgetaufträgen. Aktualisieren Sie diese, löschen Sie sie nicht.
Zielgruppen, Prognosen, Conversion-Events sind NICHT in v5 enthalten — diese befinden sich in separaten Apple-APIs (AdServices Attribution etc.).
Lokale Entwicklung
npm run dev # tsc --watch
npm run typecheck # one-shot type check
npm run build # compile to dist/Verwenden Sie apple_search_ads_request, um jeden Endpunkt direkt zu debuggen — es gibt den Raw-Envelope zurück, sodass Sie die genaue Antwortform sehen können, die Apple zurückgegeben hat.
Available Tools
74 toolsadgroup_negative_keywords_createC
Bulk-create negative keywords on an ad group.
Inputs: campaignId (required), adGroupId (required), keywords (required), orgId.
adgroup_negative_keywords_deleteB
Bulk-delete ad-group-level negative keywords by ID.
Inputs: campaignId (required), adGroupId (required), keywordIds (required), orgId.
adgroup_negative_keywords_findB
Find ad-group-level negative keywords across all ad groups in a campaign with a selector.
Inputs: campaignId (required), selector (required), orgId.
adgroup_negative_keywords_getB
Fetch a single ad-group-level negative keyword by ID.
Inputs: campaignId (required), adGroupId (required), keywordId (required), orgId.
adgroup_negative_keywords_listB
List ad-group-level negative keywords (paginated).
Inputs: campaignId (required), adGroupId (required), limit, offset, +1 more.
adgroup_negative_keywords_updateC
Bulk-update ad-group-level negative keywords. Each entry must include id.
Inputs: campaignId (required), adGroupId (required), keywords (required), orgId.
adgroups_createB
Create an ad group within a campaign. Bid + targeting live here, not on the campaign.
Inputs: campaignId (required), name (required), startTime (required), defaultBidAmount (required), +9 more.
adgroups_deleteC
Delete an ad group.
Inputs: campaignId (required), adGroupId (required), orgId.
adgroups_find_in_campaignA
Find ad groups within a single campaign using a selector.
Inputs: campaignId (required), selector (required), orgId.
adgroups_find_org_wideA
Find ad groups across the entire org with a selector.
Inputs: selector (required), orgId.
adgroups_getC
Fetch a single ad group.
Inputs: campaignId (required), adGroupId (required), orgId.
adgroups_listC
List all ad groups in a campaign (paginated).
Inputs: campaignId (required), limit, offset, orgId.
adgroups_updateC
Update an ad group. Pass only the fields you want to change.
Inputs: campaignId (required), adGroupId (required), adGroup (required), orgId.
ads_createB
Create an ad inside an ad group. Ads bind a Creative (creativeId) to the ad group; the creative itself can wrap a Custom Product Page, Default Product Page, or Creative Set reference.
Inputs: campaignId (required), adGroupId (required), ad (required), orgId.
ads_deleteC
Delete an ad.
Inputs: campaignId (required), adGroupId (required), adId (required), orgId.
ads_find_in_campaignA
Find ads across all ad groups in a campaign with a selector.
Inputs: campaignId (required), selector (required), orgId.
ads_find_org_wideB
Find ads across the entire org with a selector.
Inputs: selector (required), orgId.
ads_getC
Fetch a single ad by ID.
Inputs: campaignId (required), adGroupId (required), adId (required), orgId.
ads_listB
List all ads in an ad group.
Inputs: campaignId (required), adGroupId (required), limit, offset, +1 more.
ads_updateB
Update an ad — typically status, name, or repointing to a different creativeId.
Inputs: campaignId (required), adGroupId (required), adId (required), ad (required), +1 more.
apple_search_ads_requestA
Escape hatch: call any Apple Search Ads endpoint by method + path. Authentication and org context are handled for you. Use only if no dedicated tool covers the endpoint you need.
Inputs: method (required), path (required), query, body, +2 more.
apps_assets_findB
Find App Store screenshots / app-preview assets for an app — returns assetGenIds you can use to author creatives or audit rejected assets.
Inputs: adamId (required), selector (required), orgId.
apps_eligibilities_findA
Find app-eligibility records by selector (filterable by supplySource, countryOrRegion, deviceClass, state).
Inputs: adamId (required), selector (required), orgId.
apps_getC
Fetch App Store metadata for an app: appName, developerName, primaryGenre, secondaryGenre, iconPictureUrl, availableStorefronts, deviceClasses, etc.
Inputs: adamId (required), orgId.
apps_locale_detailsB
Get localized default product-page details for an app (subtitle, short description, screenshots, app preview) per locale.
Inputs: adamId (required), orgId.
budget_orders_createB
Create a budget order (LOC accounts only). Wraps Apple's {bo, orgIds} envelope.
Inputs: name (required), budget (required), startDate (required), endDate (required), +8 more.
budget_orders_getB
Fetch a single budget order by ID.
Inputs: budgetOrderId (required), orgId.
budget_orders_listB
List all budget orders in the org (paginated).
Inputs: limit, offset, orgId.
budget_orders_updateC
Update a budget order. Most fields are editable post-creation; status is read-only. v5 has no delete endpoint for budget orders.
Inputs: budgetOrderId (required), bo (required), orgIds, orgId.
campaign_negative_keywords_createB
Bulk-create campaign-level negative keywords (apply across all ad groups).
Inputs: campaignId (required), keywords (required), orgId.
campaign_negative_keywords_deleteC
Bulk-delete campaign-level negative keywords by ID.
Inputs: campaignId (required), keywordIds (required), orgId.
campaign_negative_keywords_findB
Find campaign-level negative keywords within a single campaign with a selector.
Inputs: campaignId (required), selector (required), orgId.
campaign_negative_keywords_getB
Fetch a single campaign-level negative keyword by ID.
Inputs: campaignId (required), keywordId (required), orgId.
campaign_negative_keywords_listC
List campaign-level negative keywords (paginated).
Inputs: campaignId (required), limit, offset, orgId.
campaign_negative_keywords_updateC
Bulk-update campaign-level negative keywords.
Inputs: campaignId (required), keywords (required), orgId.
campaigns_createB
Create a new campaign. The minimum useful body specifies adamId, name, countriesOrRegions, adChannelType, supplySources, billingEvent, and a budget.
Inputs: name (required), adamId (required), countriesOrRegions (required), adChannelType (required), +14 more.
campaigns_deleteB
Permanently delete a campaign. Cannot be undone.
Inputs: campaignId (required), orgId.
campaigns_findA
Search campaigns with a selector — supports conditions (EQUALS/IN/CONTAINS/...), orderBy, and pagination.
Inputs: selector (required), orgId.
campaigns_getB
Fetch a single campaign by ID.
Inputs: campaignId (required), orgId.
campaigns_listA
List all campaigns in the org (paginated). For richer filtering use campaigns_find.
Inputs: limit, offset, orgId.
campaigns_updateA
Update a campaign. Pass only the fields you want to change. Use clearGeoTargetingOnCountryOrRegionChange=true if you change countriesOrRegions.
Inputs: campaignId (required), campaign (required), clearGeoTargetingOnCountryOrRegionChange, orgId.
countries_or_regions_listA
List supported countries / regions with their default and supported product-page languages.
Inputs: orgId.
cpp_getB
Fetch a single Custom Product Page by ID.
Inputs: adamId (required), productPageId (required), orgId.
cpp_listC
List Custom Product Pages for an app.
Inputs: adamId (required), orgId.
cpp_locale_detailsB
List the locales available for a Custom Product Page (with localized assets per locale).
Inputs: adamId (required), productPageId (required), orgId.
creative_app_preview_devicesA
List supported app-preview device-size mappings (e.g. IPHONE_61, IPAD_129). Used when authoring creatives or interpreting screenshot/preview metadata.
Inputs: orgId.
creatives_createC
Create a creative (a reference to a default product page, custom product page, or creative set). Ads bind to creatives via creativeId.
Inputs: name (required), adamId (required), type (required), productPageId, +2 more.
creatives_findC
Find creatives across the org with a selector.
Inputs: selector (required), orgId.
creatives_getB
Fetch a single creative by ID.
Inputs: creativeId (required), orgId.
creatives_listB
List all creatives in the org (paginated).
Inputs: limit, offset, orgId.
custom_reports_createB
Create an Impression Share (Share of Voice) report — async. Returns a reportId you poll with custom_reports_get until state=COMPLETED.
Inputs: name (required), startTime (required), endTime (required), granularity, +3 more.
custom_reports_getA
Fetch a single Impression Share report — poll until state=COMPLETED to read rows (rank, impressionShare, lowImpressionShare, highImpressionShare, searchPopularity).
Inputs: reportId (required), orgId.
custom_reports_listB
List all Impression Share reports created in the org.
Inputs: limit, offset, orgId.
geo_lookupA
Resolve geos by raw IDs. Each request item is { id: 'CountryCode|adminArea|locality', entity: 'Country|AdminArea|Locality' }. Useful when a report returns geo IDs you want named.
Inputs: requests (required), orgId.
me_userA
Return information about the calling API user (userId, parentOrgId).
Inputs: no named parameters.
org_aclsA
List all org-level ACLs (orgs your API user can access, with orgName / currency / paymentModel / roleNames). Use this to discover the orgId for ASA_ORG_ID. Does not require X-AP-Context.
Inputs: no named parameters.
product_page_reasons_findB
Find ad-creative rejection reasons (filterable by adamId, productPageId, assetGenId, countryOrRegion, languageCode, supplySource, reasonLevel). Use this to audit why a creative was rejected by Apple's review team.
Inputs: selector (required), orgId.
product_page_reasons_getB
Fetch a single rejection reason by ID.
Inputs: productPageReasonId (required), orgId.
reports_adgroupsC
Ad-group-level report within a single campaign.
Inputs: campaignId (required), startTime (required), endTime (required), granularity, +7 more.
reports_ads_in_campaignB
Ad-level performance (per Custom Product Page / creative variation) rolled up across the campaign.
Inputs: campaignId (required), startTime (required), endTime (required), granularity, +7 more.
reports_campaignsA
Campaign-level performance report. Returns rows with impressions, taps, installs, spend, CPT/CPM/CPI, conversion rate, etc. Pass groupBy to pivot by country, device, age, gender.
Inputs: startTime (required), endTime (required), granularity, timeZone, +6 more.
reports_keywords_in_adgroupC
Keyword report scoped to a single ad group.
Inputs: campaignId (required), adGroupId (required), startTime (required), endTime (required), +8 more.
reports_keywords_in_campaignC
Keyword report rolled up across all ad groups in one campaign.
Inputs: campaignId (required), startTime (required), endTime (required), granularity, +7 more.
reports_search_terms_in_adgroupC
Search-terms report scoped to a single ad group.
Inputs: campaignId (required), adGroupId (required), startTime (required), endTime (required), +8 more.
reports_search_terms_in_campaignB
Search-terms report rolled up across all ad groups in a campaign. Reveals what users actually typed — harvest new keywords or negatives from here.
Inputs: campaignId (required), startTime (required), endTime (required), granularity, +7 more.
search_appsA
Search the App Store for apps to target / advertise. Returns adamId, name, developerName, and country availability. You need adamId to create campaigns.
Inputs: query (required), returnOwnedApps, limit, offset, +1 more.
search_geoB
Search geo entities by name (Country / AdminArea / Locality). Pass countrycode (lowercase, Apple's quirk) to scope an admin-area or locality search to one country.
Inputs: query (required), entity (required), countrycode, limit, +2 more.
targeting_keywords_createB
Bulk-create targeting (positive) keywords on an ad group. Pass up to 1000 per call.
Inputs: campaignId (required), adGroupId (required), keywords (required), orgId.
targeting_keywords_deleteC
Bulk-delete targeting keywords by ID.
Inputs: campaignId (required), adGroupId (required), keywordIds (required), orgId.
targeting_keywords_delete_singleB
Delete a single targeting keyword by ID (uses Apple's REST DELETE variant).
Inputs: campaignId (required), adGroupId (required), keywordId (required), orgId.
targeting_keywords_findA
Find targeting keywords across all ad groups in a campaign with a selector. Apple does not expose a per-ad-group find — filter by adGroupId in the selector if needed.
Inputs: campaignId (required), selector (required), orgId.
targeting_keywords_getC
Fetch a single targeting keyword by ID.
Inputs: campaignId (required), adGroupId (required), keywordId (required), orgId.
targeting_keywords_listB
List targeting keywords on an ad group (paginated).
Inputs: campaignId (required), adGroupId (required), limit, offset, +1 more.
targeting_keywords_updateB
Bulk-update targeting keywords (status, bid, text, matchType). Each entry must include id.
Inputs: campaignId (required), adGroupId (required), keywords (required), orgId.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 74 tools
Each tool targets a distinct resource and action, with clear prefixes like adgroups_, campaigns_, targeting_keywords_, etc., so there is no ambiguity between tools.
All tool names follow a consistent snake_case verb_noun pattern (e.g., adgroups_create, campaigns_list, custom_reports_create), with very few deviations like delete_single, which is still clear.
With 74 tools, the count is high but appropriate for the comprehensive Apple Search Ads API covering many resources and operations. Each tool serves a specific purpose, though the number exceeds typical well-scoped servers.
The tool set covers all major workflows: CRUD for campaigns, ad groups, ads, keywords, negatives, creatives, budget orders; reporting; app and geo search; org management. The escape hatch handles any missing endpoints, ensuring no dead ends.
Maintenance
Related MCP Connectors
Google Ads MCP server — manage campaigns, keywords, and metrics.
Meta Ads MCP server: run Facebook and Instagram campaigns, ad sets, ads and reports from AI.
Google Ads MCP server: run Search, Display, Demand Gen and PMax campaigns from AI.
Marketo MCP server for AI. 130 tools to operate Marketo from Claude, Cursor, or ChatGPT.
Related MCP Servers
- AlicenseBqualityCmaintenanceMCP server for Meta Marketing API v25.0 — 123 tools for Facebook & Instagram ad campaign management134397 npm94MIT
- AlicenseAqualityDmaintenanceApple Search Ads API v5 (read-only). Campaigns, ad groups, keywords, performance reports.91MIT
- AlicenseBqualityDmaintenanceTyped MCP server for OpenAI Ads and ChatGPT Ads via the Advertiser API. Supports account, campaign, ad group, ad, creative, audience, insight, and conversion tools with readonly mode and guarded writes.124MIT
- AlicenseAqualityDmaintenanceMCP server that wraps the Meta Marketing API (Graph API v25.0) as semantic tools for LLM agents.181MIT