Skip to main content
Glama
asc-mcp
by Hiru-ge

asc-mcp

An unofficial MCP server for the App Store Connect API — automate releases, App Review, metadata, screenshots, TestFlight, product page experiments, diagnostics, reports, reviews, and ASO analysis.

App Store Connect API 用の非公式MCPサーバー。Claude CodeなどのMCP対応エージェントから、自分のアプリの運営・分析データを直接扱えるようにする。

できること

  • App Store Connectに登録されているアプリの一覧取得

  • カスタマーレビューの取得(並び順・国・星評価でフィルタ)とデベロッパー返信の投稿

  • TestFlightビルド一覧の取得(処理状態・有効期限つき)

  • App Storeバージョン一覧の取得(審査状況・リリースタイプ)

  • 売上サマリーレポートの取得(日次・週次・月次・年次)

  • App Storeでのキーワード検索順位チェック(認証不要・単体で使える)

  • Analytics Reportsの取得(インプレッション・プロダクトページ閲覧・流入元別ダウンロードなどのASO分析データ)

  • App Storeバージョン作成、ローカライズ、ビルド紐付け、審査情報更新、審査提出

  • スクリーンショットセット作成、ローカル画像の分割アップロード、一覧・削除

  • 手動・自動・予約リリース、段階的リリース、配信国、アプリ価格の管理

  • TestFlightグループ・テスター・ビルド・What to Test・外部テスト審査の管理

  • カスタムプロダクトページとProduct Page Optimizationの作成・更新

  • クラッシュ・ハングの診断ログ、起動時間などのパフォーマンス指標の取得

  • アプリ内課金(消耗型・非消耗型)の作成、ローカライズ、価格、配信国、審査用スクリーンショット、審査提出

サブスクリプション、Webhookの管理は対象外。

Related MCP server: App Store Connect MCP Server

クイックスタート

1. App Store Connect APIキーを用意する

App Store Connect の Users and Access > Integrations > App Store Connect API > Team Keys でAPIキーを作成し、.p8 ファイルをダウンロードする。ロールは売上レポート(asc_get_sales_report)を使うなら Admin、使わないなら App Manager で足りる。秘密鍵は一度しかダウンロードできない点に注意。あわせて同ページで Issuer ID と Key ID を控える。詳細はAPIキー作成の詳細を参照。

2. ビルドする

git clone https://github.com/Hiru-ge/asc-mcp.git
cd asc-mcp
npm install
npm run build

3. MCPクライアントに登録する

Claude Codeの場合:

claude mcp add --scope user app-store-connect \
  -e ASC_KEY_ID=xxx \
  -e ASC_ISSUER_ID=xxx \
  -e ASC_PRIVATE_KEY_PATH=/path/to/AuthKey_xxx.p8 \
  -- node /path/to/asc-mcp/dist/index.js

/path/to/asc-mcp はクローンしたディレクトリの絶対パスに置き換える。売上レポートを使う場合は -e ASC_VENDOR_NUMBER=xxxxx も追加する(Vendor Numberの場所)。

4. 動かしてみる

新しいセッションでエージェントにそのまま聞けばよい。

直近のカスタマーレビューを5件見せて

「カフェ 開拓」で検索したときのうちのアプリの順位は?

App Store Connect APIキーの作成

  1. App Store Connect にログインする。

  2. Users and Access > Integrations > App Store Connect API > Team Keys を開く。

  3. 「キーを生成」から新しいAPIキーを作成する。ロールの選び方は次のとおり。

    • App Manager: アプリ情報・レビュー取得と返信・ビルド・バージョン・Analytics Reportsをカバーする。売上レポートには権限が足りない(HTTP 403になる)

    • Admin または Sales: 売上レポート(asc_get_sales_report)も使う場合はこちら。SalesロールはSales and Trendsへのアクセスに特化しているが、レビュー返信など他ツールの権限が不足する場合があるため、全ツールを1つのキーで使うなら Admin が確実。キーのロールは作成後に変更できない

  4. 生成後に表示される .p8 ファイルをダウンロードする。この秘密鍵は一度しかダウンロードできない。紛失した場合はキーを失効させて再発行する必要がある。ダウンロードしたファイルは安全な場所に保管すること(Gitリポジトリにコミットしない)。

Issuer ID / Key ID の場所

  • Issuer ID: 同じ Integrations > App Store Connect API ページの上部に表示される(例: 57246542-96fe-1a63-e053-0824d011072a)。チーム全体で共通の値。

  • Key ID: 作成したキーの一覧に表示される10文字程度の識別子(例: 2X9R4HXF34)。.p8 ファイル名にも AuthKey_<Key ID>.p8 の形で含まれる。

Vendor Number(売上レポート用)

asc_get_sales_report を使う場合のみ必要。App Store Connect の Payments and Financial Reports ページに表示される、契約ごとのベンダー番号(数字のみ)。

環境変数

変数名

必須

説明

ASC_KEY_ID

必須

APIキーのKey ID

ASC_ISSUER_ID

必須

Issuer ID

ASC_PRIVATE_KEY_PATH

必須

ダウンロードした .p8 ファイルへの絶対パス

ASC_VENDOR_NUMBER

任意

売上レポート取得(asc_get_sales_report)に使うベンダー番号

いずれかの必須環境変数が欠けている場合、サーバー自体は起動するが、各ツール呼び出し時に「どの環境変数が欠けているか」を明示したエラーメッセージが返る。

ツール一覧

ツール名

用途

asc_list_apps

App Store Connectに登録されているアプリ一覧を取得する(id・name・bundleId・sku・primaryLocale)

asc_list_customer_reviews

指定アプリのカスタマーレビュー一覧を取得する。並び順・国・星評価でフィルタ可能

asc_reply_to_review

カスタマーレビューにデベロッパー返信を投稿する

asc_list_builds

指定アプリにアップロードされたビルド一覧を取得する(アップロード日時降順)

asc_list_app_store_versions

指定アプリのApp Storeバージョン一覧を取得する(審査状況・リリースタイプなど)

asc_get_sales_report

売上サマリーレポート(SALES/SUMMARY/version 1.0)をTSVとして取得し、パースして返す。ASC_VENDOR_NUMBER が必要

asc_search_ranking

公開iTunes Search APIを使ったキーワード順位チェック。App Store Connect認証(JWT)は不要で、この1ツール単体で使える

asc_request_analytics_reports

Analytics Reportsのリクエスト(ONGOINGアクセス)をensureする。既存があれば再利用し、なければ新規作成する

asc_list_analytics_reports

asc_request_analytics_reports で取得した requestId から、利用可能なレポート一覧を取得する

asc_get_analytics_report_data

asc_list_analytics_reports で取得した reportId から、レポートインスタンスのデータ(CSV/TSV)を取得してパースする

asc_create_app_store_version

新しいApp Storeバージョンを作成する

asc_create_version_localization

バージョンのローカライズを作成する

asc_list_version_localizations

説明文、キーワード、更新内容などをロケール別に取得する

asc_update_version_localization

バージョンのローカライズを部分更新する

asc_list_app_info_localizations

アプリ名、サブタイトル、プライバシーポリシーURLをロケール別に取得する

asc_update_app_info_localization

アプリ情報のローカライズを部分更新する

asc_set_version_build

App Storeバージョンへ審査対象ビルドを紐付ける

asc_get_review_details

App Reviewの連絡先、デモアカウント、審査メモを取得する

asc_create_review_details

App Review情報を作成する

asc_update_review_details

App Review情報を部分更新する

asc_submit_app_store_version

Review Submissionを作り、バージョンを追加して審査へ提出する

asc_submit_product_page_review_item

Product Page Optimization実験またはカスタムページを審査へ提出する

asc_create_screenshot_set

通常ページ、実験、カスタムページ用のスクリーンショットセットを作る

asc_list_screenshot_sets

ローカライズに属するスクリーンショットセットを取得する

asc_list_screenshots

セット内のスクリーンショットと処理状態を取得する

asc_upload_screenshot

ローカル画像を予約、分割アップロード、コミットする

asc_delete_screenshot_resource

スクリーンショットまたはセットを削除する

asc_update_app_store_version

リリース方式、公開予定日時、著作権などを更新する

asc_enable_phased_release

7日間の段階的リリースを有効にする

asc_update_phased_release

段階的リリースを開始、一時停止、再開、完了する

asc_release_app_store_version

承認済みの手動リリース待ちバージョンを公開する

asc_list_app_price_points

配信国ごとの価格候補と収益額を取得する

asc_get_app_price_schedule

現在と予約済みの価格、価格ポイントIDを取得する

asc_set_app_price

基準国の価格を即時変更または予約変更する

asc_get_app_availability

国別の配信状況、公開日、予約注文設定を取得する

asc_list_territory_availabilities

全配信国の設定をページネーション付きで取得する

asc_update_territory_availability

1つの国で配信可否や公開日を更新する

asc_list_beta_groups

TestFlightグループを取得する

asc_create_beta_group

TestFlightグループを作成する

asc_list_beta_testers

TestFlightテスターを取得する

asc_create_beta_tester

TestFlightテスターを作成・招待する

asc_add_to_beta_group

テスターまたはビルドをグループへ追加する

asc_list_beta_build_localizations

ロケール別のWhat to Testを取得する

asc_set_beta_build_localization

ロケール別のWhat to Testを作成・更新する

asc_get_build_beta_details

TestFlightビルドの内部・外部テスト状態を取得する

asc_update_build_beta_details

外部テスト開始時の自動招待を更新する

asc_submit_beta_app_review

ビルドを外部TestFlight向け審査へ提出する

asc_list_product_page_experiments

Product Page Optimization実験を取得する

asc_create_product_page_experiment

Product Page Optimization実験を作成する

asc_update_product_page_experiment

実験の配分、状態、名前を更新する

asc_create_experiment_treatment

実験のTreatmentを作成する

asc_list_experiment_treatments

実験のTreatmentを取得する

asc_create_experiment_treatment_localization

Treatmentのローカライズを作成する

asc_list_custom_product_pages

カスタムプロダクトページを取得する

asc_create_custom_product_page

カスタムプロダクトページを作成する

asc_update_custom_product_page

カスタムプロダクトページの名前や表示状態を更新する

asc_create_custom_product_page_version

カスタムプロダクトページの編集可能バージョンを作成する

asc_list_custom_product_page_versions

カスタムプロダクトページのバージョンを取得する

asc_update_custom_product_page_version

カスタムプロダクトページのディープリンクを更新する

asc_create_custom_product_page_localization

カスタムページのローカライズを作成する

asc_get_performance_metrics

アプリまたはビルドの電力・パフォーマンス指標を取得する

asc_list_diagnostic_signatures

ビルドのクラッシュ、ハングなどの診断シグネチャを取得する

asc_get_diagnostic_logs

診断シグネチャの匿名化ログとコールスタックを取得する

各list系ツールは limit(デフォルト20、最大200)と nextUrl(前回のレスポンスに含まれる nextUrl をそのまま渡すと次ページを取得)でページネーションに対応する。

リリース提出の基本フロー

  1. asc_create_app_store_version でバージョンを作る。

  2. asc_create_version_localization または asc_update_version_localization で更新内容などを入れる。

  3. 必要なら asc_create_screenshot_set と asc_upload_screenshot で画像を更新する。

  4. asc_set_version_build で処理済みビルドを紐付ける。

  5. asc_create_review_details または asc_update_review_details で審査メモなどを整える。

  6. asc_submit_app_store_version で審査へ提出する。

asc_upload_screenshot の filePath はMCPサーバープロセスから読めるローカルファイルの絶対パスを渡す。Product Page Optimization用のセットでは localizationType に experimentTreatment、カスタムプロダクトページ用では customProductPage を指定する。

ASO分析ツールの使い方

  • asc_search_ranking は認証情報なしで単体利用できる。ASC_KEY_ID 等が未設定でも動作する。

  • Analytics Reports系は asc_request_analytics_reports → asc_list_analytics_reports → asc_get_analytics_report_data の順に呼び出す3段階フロー。

    • asc_request_analytics_reports で初めてONGOINGリクエストを作成した場合、実際にレポートが生成されるまで最大48時間かかる。生成前に asc_list_analytics_reports を呼んでも空になる。

    • 2回目以降は既存のONGOINGリクエストが再利用されるため、requestId を控えておけば毎回作成し直す必要はない。

セキュリティ上の注意

  • asc_list_customer_reviews が返すレビュー本文(title / body)は、第三者ユーザーが自由に書き込める未検証テキスト。この本文をLLMが読み取る過程で、レビュー文中に埋め込まれた指示(プロンプトインジェクション)に従ってしまう可能性がある。

  • 同じサーバーに公開返信を投稿する asc_reply_to_review が同居しているため、悪意あるレビュー本文がエージェントへの指示を含んでいた場合、確認なしに公開返信が投稿される経路が成立しうる。asc_reply_to_review はMCPクライアントの自動承認(auto-approve)設定に含めず、実行内容を必ず人間が確認してから承認すること。

  • 審査提出、公開、価格、配信国、スクリーンショット削除を行うツールは本番のApp Store Connectデータを変更する。これらも自動承認へ追加せず、対象アプリ、バージョン、国、価格を実行前に確認すること。

実装メモ

  • JWTは jose の importPKCS8 / SignJWT でES256署名する。有効期限はApp Store Connect APIの上限20分に対し19分に設定し、モジュール内でキャッシュ。残り2分を切ったら自動的に再生成する。

  • list系ツールのレスポンスはJSON:APIの attributes を平坦化した配列で返し、トークン消費を抑える。

  • 売上レポートは Accept: application/a-gzip でリクエストし、node:zlib の gunzipSync でTSVに展開してパースする。行数が多い場合は先頭50行と総行数のみを返す。

  • asc_search_ranking は https://itunes.apple.com/search を素の fetch で叩く(JWT不使用)。iTunes Search APIには目安で約20リクエスト/分のレート制限があり、超過するとHTTP 403が返ることがある。

  • Analytics Reportsのセグメントデータ(analyticsReportInstances/{id}/segments の url)は署名付きURLのため、Authorizationヘッダを付けずに素の fetch でダウンロードし、gunzipSync で展開する。セグメントはCSVまたはTSVで、先頭行にタブを含むかで区切り文字を判定する。複数セグメントは行を結合し、先頭50行と総行数のみを返す(services/tsv.ts の parseAnalyticsSegments)。

免責事項

本ツールは非公式のオープンソースプロジェクトであり、Apple Inc.とは無関係。Apple・App Store Connect・iTunesは各社の商標。

ライセンス

MIT

Available Tools

63 tools
asc_add_to_beta_groupAdd Testers or Builds to TestFlight GroupC
Idempotent

Add one or more testers or builds to an existing TestFlight group.

Inputs: groupId (required), resourceIds (required), resourceType (required).

asc_create_app_store_versionCreate App Store VersionA

Create a new App Store version (e.g. to start preparing the next release) for an app.

Args:

  • appId (string, required): The App Store Connect app ID

  • versionString (string, required): The version number, e.g. "1.3.4"

  • platform (string): "IOS" (default) | "MAC_OS" | "TV_OS" | "VISION_OS"

Returns: { "versionId": string, "versionString": string, "appStoreState": string // typically "PREPARE_FOR_SUBMISSION" right after creation }

Error Handling:

  • Returns an error if a version with the same versionString already exists for the app

Inputs: appId (required), versionString (required), platform.

asc_create_beta_groupCreate TestFlight GroupB

Create an internal or external TestFlight group, with optional public-link settings.

Inputs: name (required), appId (required), isInternalGroup, publicLinkLimit, +2 more.

asc_create_beta_testerCreate TestFlight TesterB

Create or invite a TestFlight tester account.

Inputs: email (required), lastName, firstName.

asc_create_custom_product_pageCreate Custom Product PageB

Create a named custom App Store product page for targeted campaigns.

Inputs: name (required), appId (required).

asc_create_custom_product_page_localizationCreate Custom Product Page LocalizationB

Create localized promotional text and an asset container for a custom product page version.

Inputs: locale (required), pageVersionId (required), promotionalText.

asc_create_custom_product_page_versionCreate Custom Product Page VersionB

Create an editable version of a custom product page, with an optional app deep link.

Inputs: pageId (required), deepLink.

asc_create_experiment_treatmentCreate Experiment TreatmentB

Create a named treatment variant for a Product Page Optimization experiment.

Inputs: name (required), experimentId (required), appIconName.

asc_create_experiment_treatment_localizationCreate Experiment Treatment LocalizationC

Create a locale container for treatment screenshots and previews.

Inputs: locale (required), treatmentId (required).

asc_create_product_page_experimentCreate Product Page ExperimentB

Create a Product Page Optimization experiment and set its traffic percentage.

Inputs: name (required), versionId (required), trafficProportion (required).

asc_create_review_detailsCreate App Review DetailsB

Create the App Review contact information, optional demo account, and notes for a version.

Inputs: versionId (required), notes, contactEmail, contactPhone, +5 more.

asc_create_screenshot_setCreate Screenshot SetC

Create a screenshot container for one App Store version locale and display type.

Inputs: localizationId (required), screenshotDisplayType (required), localizationType.

asc_create_version_localizationCreate Version LocalizationC

Create localized App Store metadata for a version, including release notes, keywords, and promotional text.

Inputs: locale (required), versionId (required), keywords, whatsNew, +4 more.

asc_delete_screenshot_resourceDelete Screenshot or SetA
DestructiveIdempotent

Delete one screenshot, or a screenshot set and every screenshot it contains.

Inputs: id (required), resourceType (required).

asc_enable_phased_releaseEnable Phased ReleaseC

Enable a seven-day phased release for an App Store version.

Inputs: versionId (required), phasedReleaseState.

asc_get_analytics_report_dataGet Analytics Report DataA
Read-onlyIdempotent

Fetch the data of an analytics report: resolves the latest (or specified) report instance, downloads and decompresses its segments, and returns a preview of the combined rows.

Args:

  • reportId (string, required): The analytics report ID returned by asc_list_analytics_reports

  • granularity (string): "DAILY" (default) | "WEEKLY" | "MONTHLY"

  • processingDate (string, optional): YYYY-MM-DD. If omitted, the latest available instance is used.

Returns: { "reportId": string, "instanceId": string, "processingDate": string, // YYYY-MM-DD "granularity": string, "segmentCount": number, "totalRows": number, // total number of data rows across all segments "returnedRows": number, // number of rows included in this response (max 50) "truncated": boolean, // true if totalRows > returnedRows "rows": [ { : , ... } ] }

Error Handling:

  • Returns an error if no report instance matches the given granularity/processingDate (report may not be generated yet; can take up to 48 hours after the ONGOING request was created)

Inputs: reportId (required), granularity, processingDate.

asc_get_app_availabilityGet App AvailabilityA
Read-onlyIdempotent

Get global and per-territory App Store availability, release, and pre-order settings.

Inputs: appId (required).

asc_get_app_price_scheduleGet App Price ScheduleA
Read-onlyIdempotent

Get the current and scheduled manual prices for an app, including their price point IDs.

Inputs: appId (required).

asc_get_build_beta_detailsGet TestFlight Build DetailsA
Read-onlyIdempotent

Get internal and external testing states and the buildBetaDetail ID for a build.

Inputs: buildId (required).

asc_get_diagnostic_logsGet Diagnostic LogsA
Read-onlyIdempotent

Download anonymized call-stack logs and insights for one diagnostic signature.

Inputs: signatureId (required).

asc_get_performance_metricsGet Power and Performance MetricsB
Read-onlyIdempotent

Get launch time, hangs, memory, battery, disk, animation, termination, or storage metrics for an app or build.

Inputs: resourceId (required), resourceType (required), platform, deviceType, +1 more.

asc_get_review_detailsGet App Review DetailsA
Read-onlyIdempotent

Get the App Review contact information, demo account, and notes for an App Store version.

Inputs: versionId (required).

asc_get_sales_reportGet Sales ReportA
Read-onlyIdempotent

Fetch a sales summary report (SALES / SUMMARY / version 1.0) for the vendor configured via the ASC_VENDOR_NUMBER environment variable.

Args:

  • reportDate (string, required): Date of the report. Format depends on frequency: DAILY / WEEKLY -> "YYYY-MM-DD" MONTHLY -> "YYYY-MM" YEARLY -> "YYYY"

  • frequency (string): "DAILY" (default) | "WEEKLY" | "MONTHLY" | "YEARLY"

Returns: { "totalRows": number, // total number of data rows in the report "returnedRows": number, // number of rows included in this response (max 50) "truncated": boolean, // true if totalRows > returnedRows "rows": [ { : , ... } ] }

Error Handling:

  • Returns an error if ASC_VENDOR_NUMBER is not set

  • Returns "Error: Resource not found" (HTTP 404) if no report exists for the given date/frequency

Inputs: reportDate (required), frequency.

asc_list_analytics_reportsList Analytics ReportsA
Read-onlyIdempotent

List analytics reports available under an analytics report request. Call asc_request_analytics_reports first to obtain requestId.

Args:

  • requestId (string, required): The analytics report request ID

  • category (string, optional): Filter by category

  • limit (number): Maximum number of reports to return (default 20, max 200)

  • nextUrl (string, optional): Pagination URL returned by a previous call

Returns: { "count": number, "items": [ { "reportId": string, // pass to asc_get_analytics_report_data "name": string, "category": string } ], "nextUrl": string | undefined }

Inputs: requestId (required), limit, nextUrl, category.

asc_list_app_info_localizationsList App Info LocalizationsA
Read-onlyIdempotent

List per-locale app-level metadata (name, subtitle, privacy policy URL) across all appInfos of an app. An app usually has two appInfos: the live one and the one currently being edited (distinguished by appInfoState).

Args:

  • appId (string, required): The App Store Connect app ID

Returns: { "count": number, "items": [ { "id": string, // pass to asc_update_app_info_localization "appInfoId": string, "appInfoState": string, // e.g. "READY_FOR_DISTRIBUTION", "PREPARE_FOR_SUBMISSION" "locale": string, "name": string, "subtitle": string, "privacyPolicyUrl": string } ] }

Inputs: appId (required).

asc_list_app_price_pointsList App Price PointsA
Read-onlyIdempotent

List selectable customer prices and proceeds for an app in one territory.

Inputs: appId (required), territory (required), limit, nextUrl.

asc_list_appsList AppsA
Read-onlyIdempotent

List all apps registered in the App Store Connect account.

Args:

  • limit (number): Maximum number of apps to return (default 20, max 200)

  • nextUrl (string, optional): Pagination URL returned by a previous call. Pass it back to fetch the next page.

Returns: { "count": number, // number of apps in this response "items": [ { "id": string, // App Store Connect app ID "name": string, "bundleId": string, "sku": string, "primaryLocale": string } ], "nextUrl": string | undefined // pass to a subsequent call to fetch the next page, absent if no more pages }

Inputs: limit, nextUrl.

asc_list_app_store_versionsList App Store VersionsA
Read-onlyIdempotent

List App Store versions for an app (both released and in-progress).

Args:

  • appId (string, required): The App Store Connect app ID

  • limit (number): Maximum number of versions to return (default 20, max 200)

  • nextUrl (string, optional): Pagination URL returned by a previous call

Returns: { "count": number, "items": [ { "id": string, "versionString": string, // e.g. "1.3.3" "appStoreState": string, // e.g. "READY_FOR_SALE", "IN_REVIEW", "PREPARE_FOR_SUBMISSION" "platform": string, // e.g. "IOS" "releaseType": string, // e.g. "MANUAL", "AFTER_APPROVAL", "SCHEDULED" "createdDate": string // ISO 8601 } ], "nextUrl": string | undefined }

Inputs: appId (required), limit, nextUrl.

asc_list_beta_build_localizationsList TestFlight What to Test LocalizationsA
Read-onlyIdempotent

List localized What to Test text for a TestFlight build.

Inputs: buildId (required), limit, nextUrl.

asc_list_beta_groupsList TestFlight GroupsA
Read-onlyIdempotent

List internal and external TestFlight groups for an app.

Inputs: appId (required), limit, nextUrl.

asc_list_beta_testersList TestFlight TestersA
Read-onlyIdempotent

List TestFlight testers, optionally filtering by exact email address.

Inputs: email, limit, nextUrl.

asc_list_buildsList BuildsA
Read-onlyIdempotent

List builds uploaded for an app, sorted by upload date (newest first).

Args:

  • appId (string, required): The App Store Connect app ID

  • limit (number): Maximum number of builds to return (default 20, max 200)

  • nextUrl (string, optional): Pagination URL returned by a previous call

Returns: { "count": number, "items": [ { "id": string, "version": string, // build number, e.g. "42" "uploadedDate": string, // ISO 8601 "processingState": string, // e.g. "PROCESSING", "VALID", "FAILED", "INVALID" "expired": boolean, "expirationDate": string // ISO 8601 } ], "nextUrl": string | undefined }

Inputs: appId (required), limit, nextUrl.

asc_list_customer_reviewsList Customer ReviewsA
Read-onlyIdempotent

List customer reviews for an app.

Args:

  • appId (string, required): The App Store Connect app ID

  • sort (string): 'createdDate' | '-createdDate' (default) | 'rating' | '-rating'

  • territory (string, optional): ISO 3166-1 alpha-3 territory code filter (e.g. 'USA', 'JPN')

  • rating (number, optional): Filter by star rating, 1-5

  • limit (number): Maximum number of reviews to return (default 20, max 200)

  • nextUrl (string, optional): Pagination URL returned by a previous call

Returns: { "count": number, "items": [ { "id": string, "rating": number, // 1-5 "title": string, "body": string, "reviewerNickname": string, "createdDate": string, // ISO 8601 "territory": string // ISO 3166-1 alpha-3 } ], "nextUrl": string | undefined }

Inputs: appId (required), sort, limit, rating, +2 more.

asc_list_custom_product_pagesList Custom Product PagesA
Read-onlyIdempotent

List custom App Store product pages and their public URLs.

Inputs: appId (required), limit, nextUrl.

asc_list_custom_product_page_versionsList Custom Product Page VersionsC
Read-onlyIdempotent

List editable and reviewed versions of a custom product page.

Inputs: pageId (required), limit, nextUrl.

asc_list_diagnostic_signaturesList Diagnostic SignaturesA
Read-onlyIdempotent

List recurring crash, hang, and disk-write signatures collected for a build.

Inputs: buildId (required), limit, nextUrl, diagnosticType.

asc_list_experiment_treatmentsList Experiment TreatmentsB
Read-onlyIdempotent

List the treatment variants in a Product Page Optimization experiment.

Inputs: experimentId (required), limit, nextUrl.

asc_list_product_page_experimentsList Product Page ExperimentsB
Read-onlyIdempotent

List Product Page Optimization A/B experiments for an App Store version.

Inputs: versionId (required), limit, nextUrl.

asc_list_screenshotsList ScreenshotsA
Read-onlyIdempotent

List the ordered screenshots and upload processing states in a screenshot set.

Inputs: screenshotSetId (required), limit, nextUrl.

asc_list_screenshot_setsList Screenshot SetsA
Read-onlyIdempotent

List screenshot sets for an App Store version localization.

Inputs: localizationId (required), limit, nextUrl.

asc_list_territory_availabilitiesList Territory AvailabilitiesA
Read-onlyIdempotent

List every territory availability with pagination for an app availability resource.

Inputs: appAvailabilityId (required), limit, nextUrl.

asc_list_version_localizationsList Version LocalizationsA
Read-onlyIdempotent

List per-locale App Store version metadata (description, keywords, what's new, etc.) for an App Store version.

Args:

  • versionId (string, required): The App Store version ID

  • limit (number): Maximum number of localizations to return (default 20, max 200)

  • nextUrl (string, optional): Pagination URL returned by a previous call

Returns: { "count": number, "items": [ { "id": string, // pass to asc_update_version_localization "locale": string, // e.g. "ja", "en-US" "description": string, "keywords": string, "whatsNew": string, "promotionalText": string, "supportUrl": string, "marketingUrl": string } ], "nextUrl": string | undefined }

Inputs: versionId (required), limit, nextUrl.

asc_release_app_store_versionRelease Approved VersionA
Destructive

Release an approved App Store version that is waiting for a manual release.

Inputs: versionId (required).

asc_reply_to_reviewReply to Customer ReviewA

Create a developer response to a customer review. If a response already exists for the review, this will fail (use the App Store Connect UI or API to update/delete an existing response first).

Args:

  • reviewId (string, required): The customer review ID to respond to

  • responseBody (string, required): The response text (max 5970 characters)

Returns: { "id": string, // response ID "state": string, // e.g. "PENDING_PUBLISH", "PUBLISHED" "responseBody": string, "lastModifiedDate": string }

Error Handling:

  • Returns an error if the review already has a response

  • Returns "Error: Resource not found" if reviewId does not exist

Inputs: reviewId (required), responseBody (required).

asc_request_analytics_reportsRequest Analytics ReportsA
Idempotent

Ensure an ONGOING analytics report request exists for an app. If one already exists it is reused; otherwise a new one is created. Call this first, before asc_list_analytics_reports.

Args:

  • appId (string, required): The App Store Connect app ID

Returns: { "requestId": string, // pass to asc_list_analytics_reports "accessType": "ONGOING", "created": boolean, // true if a new request was just created, false if an existing ONGOING request was reused "note": string // reminds that report generation can take up to 48 hours after first creation }

Inputs: appId (required).

asc_search_rankingCheck App Store Search RankingA
Read-onlyIdempotent

Check an app's search ranking for a keyword on the App Store, using the public iTunes Search API. No App Store Connect authentication (JWT) is required for this tool.

Args:

  • keyword (string, required): The search keyword

  • country (string): ISO 3166-1 alpha-2 country code (default 'jp')

  • bundleId (string, optional): Bundle ID of the target app. If provided, its rank within the top 200 results is looked up.

  • topN (number): Number of top results to include (default 10, max 50)

Returns: { "keyword": string, "country": string, "totalResults": number, "targetRank": number | null, // bundleId指定時にランクが見つかった場合のみ数値、それ以外はnull "targetNote": string | undefined, // targetRankがnullの場合の理由 "target": { // bundleIdが上位200件内で見つかった場合のみ "trackName": string, "averageUserRating": number, "userRatingCount": number } | undefined, "topResults": [ { "rank": number, "trackName": string, "bundleId": string, "averageUserRating": number, "userRatingCount": number, "price": number, "genres": string[] // 先頭2件のみ } ] }

Error Handling:

  • iTunes Search APIはレート制限(目安: 約20リクエスト/分)があり、超過するとHTTP 403が返ることがある。その場合は時間をおいて再試行すること。

Inputs: keyword (required), topN, country, bundleId.

asc_set_app_priceSet App PriceA
Destructive

Set or schedule an app price from a price point in the base territory; other territories are equalized automatically.

Inputs: no named parameters.

asc_set_beta_build_localizationSet TestFlight What to TestA
Idempotent

Create or update localized What to Test text for a TestFlight build.

Inputs: no named parameters.

asc_set_version_buildSet Version BuildA
Idempotent

Attach a build to an App Store version's "build" relationship. This is required before the version can be submitted for review.

Args:

  • versionId (string, required): The App Store version ID

  • buildId (string, required): The build ID to attach

Returns: { "versionId": string, "buildId": string, "success": true }

Error Handling:

  • Returns an error if the build is not valid/processed, or if the version is not in an editable state

Inputs: buildId (required), versionId (required).

asc_submit_app_store_versionSubmit App Store VersionB
Destructive

Create a review submission, add one App Store version, and submit it to App Review.

Inputs: appId (required), versionId (required).

asc_submit_beta_app_reviewSubmit Build for External TestFlight ReviewA
Destructive

Submit a build to Beta App Review before external TestFlight distribution.

Inputs: buildId (required).

asc_submit_product_page_review_itemSubmit Product Page Review ItemB
Destructive

Submit a Product Page Optimization experiment or custom product page version to App Review.

Inputs: appId (required), itemId (required), itemType (required).

asc_update_app_info_localizationUpdate App Info LocalizationA

Update per-locale app-level metadata (name, subtitle, privacy policy URL). Only the fields you pass are updated. Only editable while the corresponding appInfo is in an editable state.

Args:

  • localizationId (string, required): The app info localization ID (from asc_list_app_info_localizations)

  • name (string, optional)

  • subtitle (string, optional)

  • privacyPolicyUrl (string, optional)

At least one of the optional fields must be provided.

Returns: { "id": string, "locale": string, "name": string, "subtitle": string, "privacyPolicyUrl": string }

Error Handling:

  • Returns an error if no updatable field is provided

  • Returns an error if the appInfo is not in an editable state

Inputs: localizationId (required), name, subtitle, privacyPolicyUrl.

asc_update_app_store_versionUpdate App Store VersionC
Idempotent

Update version metadata and choose manual, automatic, or scheduled release behavior.

Inputs: versionId (required), usesIdfa, copyright, releaseType, +3 more.

asc_update_build_beta_detailsUpdate TestFlight Build DetailsC
Idempotent

Enable or disable automatic tester invitations when an external build becomes available.

Inputs: autoNotifyEnabled (required), buildBetaDetailId (required).

asc_update_custom_product_pageUpdate Custom Product PageB
Idempotent

Rename or show and hide a custom product page.

Inputs: pageId (required), name, visible.

asc_update_custom_product_page_versionUpdate Custom Product Page VersionB
Idempotent

Update the app deep link for an editable custom product page version.

Inputs: pageVersionId (required), deepLink.

asc_update_phased_releaseUpdate Phased ReleaseB
Idempotent

Start, pause, resume, or complete an existing phased release.

Inputs: phasedReleaseId (required), phasedReleaseState (required).

asc_update_product_page_experimentUpdate Product Page ExperimentA
Idempotent

Rename, start, stop, complete, or change traffic for a Product Page Optimization experiment.

Inputs: experimentId (required), name, state, trafficProportion.

asc_update_review_detailsUpdate App Review DetailsB
Idempotent

Update only the provided App Review contact, demo account, or notes fields.

Inputs: reviewDetailId (required), notes, contactEmail, contactPhone, +5 more.

asc_update_territory_availabilityUpdate Territory AvailabilityA
DestructiveIdempotent

Enable or disable an app in one territory and update its release or pre-order dates.

Inputs: territoryAvailabilityId (required), available, releaseDate, preOrderEnabled, +1 more.

asc_update_version_localizationUpdate Version LocalizationA

Update per-locale App Store version metadata. Only the fields you pass are updated; omitted fields are left unchanged.

Note: promotionalText can be updated anytime; other fields (description, keywords, whatsNew, supportUrl, marketingUrl) can only be updated while the version is in an editable state (e.g. PREPARE_FOR_SUBMISSION, DEVELOPER_REJECTED, REJECTED).

Args:

  • localizationId (string, required): The App Store version localization ID (from asc_list_version_localizations)

  • description (string, optional)

  • keywords (string, optional): comma-separated

  • whatsNew (string, optional)

  • promotionalText (string, optional)

  • supportUrl (string, optional)

  • marketingUrl (string, optional)

At least one of the optional fields must be provided.

Returns: { "id": string, "locale": string, "description": string, "keywords": string, "whatsNew": string, "promotionalText": string, "supportUrl": string, "marketingUrl": string }

Error Handling:

  • Returns an error if no updatable field is provided

  • Returns an error if the version is not in an editable state for the fields being changed

Inputs: localizationId (required), keywords, whatsNew, supportUrl, +3 more.

asc_upload_screenshotUpload ScreenshotB

Reserve, upload, and commit one local screenshot file to an existing screenshot set.

Inputs: filePath (required), screenshotSetId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 63 tools

    Disambiguation4/5

    Most tools have distinct purposes, but the large number (63) and similar prefixes (e.g., multiple create/list/update tools) may cause some confusion. Descriptions help differentiate, but overlapping concepts like custom product pages and experiments could be ambiguous.

    Naming Consistency5/5

    All tools follow a consistent asc_verb_noun snake_case pattern (e.g., list_apps, create_beta_group). No mixing of conventions or unpredictable patterns.

    Tool Count2/5

    63 tools is excessive for typical use cases. While the server aims to be comprehensive, the sheer number overwhelms and suggests insufficient scoping. Most agents would benefit from a more curated set.

    Completeness3/5

    Covers major App Store Connect workflows (apps, versions, builds, TestFlight, pricing, analytics, reviews, custom pages, experiments). Notable gaps include missing delete operations for versions/builds and no support for in-app purchases or user management.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      App Store Connect MCP server: your AI agent ships your iOS app, from a new bundle id to App Store review. 45 tools: signing, Xcode archive and upload, TestFlight, metadata, screenshots, age rating, in-app purchases, preflight, submit, release, reviews, sales. Setup finishes in chat. Submit, release and uploads ask first; every error says what to do next. A fastlane alternative. 7-day trial.
      45
      1,274 npm
      2
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      A Model Context Protocol server that wraps Apple's App Store Connect API v2, enabling management of apps, in-app purchases, subscriptions, TestFlight, product page experiments, and App Review submissions via natural language.
      60
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      A Model Context Protocol server that exposes the entire Apple App Store Connect API (1,200+ operations) as MCP tools, enabling AI assistants to query apps, manage builds, handle submissions, read analytics, and more.
      106 npm
      1
      MIT