Skip to main content
Glama
Apple Ads MCP

Apple Ads MCP

by AppVisionOS

apple-search-ads-mcp

CI npm version npm downloads License: MIT Node MCP Glama MCP server

Apple Search Ads (現 Apple Ads) Campaign Management API v5を完全にラップするModel Context Protocol (MCP) サーバーです。74種類の型付きツールを備え、キャンペーン、広告グループ、広告、クリエイティブ、カスタムプロダクトページ、キーワード、除外キーワード、レポート、インプレッションシェアレポート、予算オーダー、ACL、地域/アプリ検索、アプリメタデータ、審査不合格理由の監査など、文書化されたすべてのv5エンドポイントと1:1で対応しています。さらに、将来のエンドポイントにも対応可能なRawパススルー機能も備えています。

APIライフサイクル: Apple Ads (Search Ads) v5は現在のプロダクションAPIです。v5は2027年1月26日に終了し、2026年夏に登場する新しい「Apple Ads Platform API」に移行します。このサーバーはv5.0からv5.5を対象としています。

クイックインストール

git clone https://github.com/AppVisionOS/apple-search-ads-mcp.git
cd apple-search-ads-mcp
npm install
npm run build

次に、Claude Codeに1行で登録します:

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.js

Related MCP server: aapl-ads-mcp

セットアップ

1. API認証情報の取得

Apple AdsのUIでは、認証情報は2つの画面に分かれています。アカウント設定内のAPIタブはサードパーティサービスプロバイダーのアクセス管理のみを行います。独自のプログラムによるアクセスの場合は、まずユーザー管理からフローを進める必要があります。

a) APIユーザーの招待

app-ads.apple.com → アカウント設定 → ユーザー管理 → ユーザーを招待:

  • メールアドレス: 管理可能なアドレス(自身のアドレスでも可。AppleはAPIユーザー用に別のApple IDを要求します)

  • ロール: API権限を持つもの(例: APIアカウントマネージャー)

  • 招待を送信し、招待された受信トレイから承諾します

b) ローカルでのキーペア生成

招待が処理されている間に、マシン上でES256キーペアを生成します。必ずPKCS#8形式にしてください。Appleの.p8の例や古いopenssl ecparamの出力はPKCS#8ではなく、joseでは読み込めません。

# 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.p8

asa-private.p8は安全な場所(例: ~/.apple-search-ads/, chmod 600)に保管してください。Appleには公開鍵のみを貼り付けます。

c) APIクライアントの生成

サインアウトし、招待されたAPIユーザーとして(管理者アカウントではなく)再度サインインします。アカウント設定 → APIに移動します。公開鍵のテキストエリアがあるクライアント認証情報画面が表示されます。これはAPIロールを持つユーザーにのみ表示されます。

  1. asa-public.pemの内容(-----BEGIN PUBLIC KEY----- / -----END PUBLIC KEY-----マーカーを含む)を貼り付けます。

  2. APIクライアントを生成をクリックします。

  3. Appleが表示する3つの値(クライアントID、チームID、キーID)をコピーします。これらは後で再表示されません。

2. インストール

npm install
npm run build

3. 設定

.env.exampleを.envにコピーして記入するか、MCPクライアントを通じて環境変数を渡します。

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 call

ASA_PRIVATE_KEY(PEMの内容をインラインで記述。JSON経由で注入する場合は\nエスケープが必要)は、ASA_PRIVATE_KEY_PATHの代わりとしてサポートされています。

4. MCPクライアントへの接続

{
  "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"
      }
    }
  }
}

認証

このサーバーは、ES256 JWTクライアントアサーションを使用したOAuth 2.0クライアント認証フローを処理します:

  1. .p8秘密鍵でJWTに署名します(ヘッダー: kid=キーID, alg=ES256; ペイロード: iss=チームID, sub=クライアントID, aud=https://appleid.apple.com)。

  2. grant_type=client_credentialsおよびscope=searchadsorgを指定してhttps://appleid.apple.com/auth/oauth2/tokenにPOSTします。

  3. 返された1時間有効なアクセストークンを、すべてのAPI呼び出しでAuthorization: Bearer …およびX-AP-Context: orgId=…として使用します。

トークンは有効期限の約30秒前までメモリにキャッシュされるため、1時間ごとに1つのアサーションに署名し、1つのトークンを交換します。401エラーが発生した場合、サーバーは強制的にリフレッシュして1回再試行します。429/5xxエラーの場合は、(Retry-Afterを尊重しつつ)最大3回までバックオフします。

ツール一覧(74ツール)

アカウントとアクセス (2)

org_acls, me_user — 組織コンテキストなしで呼び出し、トークンで何ができるかを確認します。

ディスカバリー (3)

search_apps, search_geo, geo_lookup

アプリメタデータ (6)

apps_get, apps_locale_details, apps_eligibilities_find, apps_assets_find, creative_app_preview_devices, countries_or_regions_list

カスタムプロダクトページ (3)

cpp_list, cpp_get, cpp_locale_details

キャンペーン (6)

campaigns_create, campaigns_get, campaigns_list, campaigns_find, campaigns_update, campaigns_delete

広告グループ (7)

adgroups_create, adgroups_get, adgroups_list, adgroups_find_in_campaign, adgroups_find_org_wide, adgroups_update, adgroups_delete

クリエイティブ (4)

creatives_create, creatives_list, creatives_get, creatives_find — クリエイティブはカスタムプロダクトページ、デフォルトプロダクトページ、またはクリエイティブセットの参照をラップします。広告はcreativeIdを介してクリエイティブに紐付けられます。

広告 (7)

ads_create, ads_get, ads_list, ads_find_in_campaign, ads_find_org_wide, ads_update, ads_delete

ターゲティングキーワード (7)

targeting_keywords_create, targeting_keywords_get, targeting_keywords_list, targeting_keywords_find, targeting_keywords_update, targeting_keywords_delete (一括), targeting_keywords_delete_single

除外キーワード — 広告グループスコープ (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

除外キーワード — キャンペーンスコープ (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

レポート (7)

ツール

エンドポイント

reports_campaigns

POST /reports/campaigns

reports_adgroups

POST /reports/campaigns/{id}/adgroups

reports_keywords_in_campaign

POST /reports/campaigns/{id}/keywords

reports_keywords_in_adgroup

POST /reports/campaigns/{id}/adgroups/{id}/keywords

reports_search_terms_in_campaign

POST /reports/campaigns/{id}/searchterms

reports_search_terms_in_adgroup

POST /reports/campaigns/{id}/adgroups/{id}/searchterms

reports_ads_in_campaign

POST /reports/campaigns/{id}/ads

すべてstartTime, endTimeを受け付けます。オプションでgranularity (HOURLY/DAILY/WEEKLY/MONTHLY)、groupBy (adminArea / ageRange / countryCode / countryOrRegion / deviceClass / gender / locality)、selector、returnRowTotals、returnGrandTotals、returnRecordsWithNoMetrics、timeZone (UTC | ORTZ) を指定可能です。

インプレッションシェアレポート (3) — 非同期

custom_reports_create → reportIdを返します。state=COMPLETEDになるまでcustom_reports_getでポーリングします。custom_reports_listで一覧表示します。

予算オーダー (4) — LOCアカウントのみ

budget_orders_create, budget_orders_get, budget_orders_list, budget_orders_update。v5には予算オーダーの削除機能はありません。

審査不合格理由の監査 (2)

product_page_reasons_find, product_page_reasons_get — Appleの審査担当者がクリエイティブを却下した理由を読み取り専用で確認します。

エスケープハッチ (1)

apple_search_ads_request — 任意のパスとメソッドで呼び出します。認証と組織コンテキストは引き続き自動的に処理されます。

セレクター

*_findツールはAppleのセレクター文法を受け付けます:

{
  "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 }
}

演算子: EQUALS, NOT_EQUALS, CONTAINS, STARTS_WITH, ENDS_WITH, GREATER_THAN, LESS_THAN, IN, NOT_IN, CONTAINS_ALL, CONTAINS_ANY, BETWEEN。valuesは常に配列です。

エンドツーエンドの例

Claudeを通じて完全に実行可能なワークフロー:

  1. org_acls → orgIdを選択。

  2. search_appsでアプリを検索 → adamIdを取得。

  3. そのadamId、日次予算、米国ターゲティング、adChannelType=SEARCH, supplySources=["APPSTORE_SEARCH_RESULTS"], billingEvent=TAPSを指定してcampaigns_createを実行。

  4. キャンペーン内でdefaultBidAmount={amount:"1.00",currency:"USD"}, pricingModel=CPCを指定してadgroups_createを実行。

  5. {text, matchType, bidAmount}の行のバッチでtargeting_keywords_createを実行。

  6. cpp_list → productPageIdを選択 → type=CUSTOM_PRODUCT_PAGEでcreatives_createを実行してcreativeIdを作成 → ads_createで広告グループに紐付け。

  7. 数日待つ。reports_campaignsでトップラインを確認し、reports_search_terms_in_campaignで新しいキーワード/除外キーワードを収集。

  8. 上位検索のインプレッションシェア/シェアオブボイスについてcustom_reports_createを実行。

既知の注意点 (v5の癖)

  • レガシーなクリエイティブセットのCRUDはありません。 Appleはv5で削除しました。代わりにcreatives行を作成し、ads.creativeIdから参照してください。

  • アプリカテゴリのエンドポイントはありません。 apps_getを使用してprimaryGenre / secondaryGenreを読み取ってください。

  • 郵便番号による地域ターゲティングはありません。 v5の地域エンティティは国 / 管理区域 / 地域のみです。

  • キーワードや広告グループスコープのキーワード検索に対する組織全体の検索はありません。 Appleはターゲティングキーワードの検索をキャンペーンレベル(/campaigns/{id}/adgroups/targetingkeywords/find)でスコープし、広告グループ全体で集計します。絞り込むにはセレクターでadGroupIdを指定してください。

  • 予算オーダーのDELETEはありません。 更新してください(削除はできません)。

  • オーディエンス、予測、コンバージョンイベントはv5には含まれていません。 これらは別のApple API(AdServices Attributionなど)に存在します。

ローカル開発

npm run dev        # tsc --watch
npm run typecheck  # one-shot type check
npm run build      # compile to dist/

apple_search_ads_requestを使用して任意のエンドポイントを直接デバッグしてください。Appleが返した正確なレスポンス形状を確認できるよう、生のエンベロープを返します。

Available Tools

74 tools
adgroup_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

    B3.3/5.0

    Scored across 74 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action, with clear prefixes like adgroups_, campaigns_, targeting_keywords_, etc., so there is no ambiguity between tools.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Apple Search Ads API v5 (read-only). Campaigns, ad groups, keywords, performance reports.
      9
      1
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Typed 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.
      12
      4
      MIT