asc-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@asc-mcp show my latest customer reviews"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 build3. 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キーの作成
App Store Connect にログインする。
Users and Access > Integrations > App Store Connect API > Team Keys を開く。
「キーを生成」から新しいAPIキーを作成する。ロールの選び方は次のとおり。
App Manager: アプリ情報・レビュー取得と返信・ビルド・バージョン・Analytics Reportsをカバーする。売上レポートには権限が足りない(HTTP 403になる)
Admin または Sales: 売上レポート(
asc_get_sales_report)も使う場合はこちら。SalesロールはSales and Trendsへのアクセスに特化しているが、レビュー返信など他ツールの権限が不足する場合があるため、全ツールを1つのキーで使うなら Admin が確実。キーのロールは作成後に変更できない
生成後に表示される
.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 ページに表示される、契約ごとのベンダー番号(数字のみ)。
環境変数
変数名 | 必須 | 説明 |
| 必須 | APIキーのKey ID |
| 必須 | Issuer ID |
| 必須 | ダウンロードした |
| 任意 | 売上レポート取得( |
いずれかの必須環境変数が欠けている場合、サーバー自体は起動するが、各ツール呼び出し時に「どの環境変数が欠けているか」を明示したエラーメッセージが返る。
ツール一覧
ツール名 | 用途 |
| App Store Connectに登録されているアプリ一覧を取得する(id・name・bundleId・sku・primaryLocale) |
| 指定アプリのカスタマーレビュー一覧を取得する。並び順・国・星評価でフィルタ可能 |
| カスタマーレビューにデベロッパー返信を投稿する |
| 指定アプリにアップロードされたビルド一覧を取得する(アップロード日時降順) |
| 指定アプリのApp Storeバージョン一覧を取得する(審査状況・リリースタイプなど) |
| 売上サマリーレポート(SALES/SUMMARY/version 1.0)をTSVとして取得し、パースして返す。 |
| 公開iTunes Search APIを使ったキーワード順位チェック。App Store Connect認証(JWT)は不要で、この1ツール単体で使える |
| Analytics Reportsのリクエスト(ONGOINGアクセス)をensureする。既存があれば再利用し、なければ新規作成する |
|
|
|
|
| 新しいApp Storeバージョンを作成する |
| バージョンのローカライズを作成する |
| 説明文、キーワード、更新内容などをロケール別に取得する |
| バージョンのローカライズを部分更新する |
| アプリ名、サブタイトル、プライバシーポリシーURLをロケール別に取得する |
| アプリ情報のローカライズを部分更新する |
| App Storeバージョンへ審査対象ビルドを紐付ける |
| App Reviewの連絡先、デモアカウント、審査メモを取得する |
| App Review情報を作成する |
| App Review情報を部分更新する |
| Review Submissionを作り、バージョンを追加して審査へ提出する |
| Product Page Optimization実験またはカスタムページを審査へ提出する |
| 通常ページ、実験、カスタムページ用のスクリーンショットセットを作る |
| ローカライズに属するスクリーンショットセットを取得する |
| セット内のスクリーンショットと処理状態を取得する |
| ローカル画像を予約、分割アップロード、コミットする |
| スクリーンショットまたはセットを削除する |
| リリース方式、公開予定日時、著作権などを更新する |
| 7日間の段階的リリースを有効にする |
| 段階的リリースを開始、一時停止、再開、完了する |
| 承認済みの手動リリース待ちバージョンを公開する |
| 配信国ごとの価格候補と収益額を取得する |
| 現在と予約済みの価格、価格ポイントIDを取得する |
| 基準国の価格を即時変更または予約変更する |
| 国別の配信状況、公開日、予約注文設定を取得する |
| 全配信国の設定をページネーション付きで取得する |
| 1つの国で配信可否や公開日を更新する |
| TestFlightグループを取得する |
| TestFlightグループを作成する |
| TestFlightテスターを取得する |
| TestFlightテスターを作成・招待する |
| テスターまたはビルドをグループへ追加する |
| ロケール別のWhat to Testを取得する |
| ロケール別のWhat to Testを作成・更新する |
| TestFlightビルドの内部・外部テスト状態を取得する |
| 外部テスト開始時の自動招待を更新する |
| ビルドを外部TestFlight向け審査へ提出する |
| Product Page Optimization実験を取得する |
| Product Page Optimization実験を作成する |
| 実験の配分、状態、名前を更新する |
| 実験のTreatmentを作成する |
| 実験のTreatmentを取得する |
| Treatmentのローカライズを作成する |
| カスタムプロダクトページを取得する |
| カスタムプロダクトページを作成する |
| カスタムプロダクトページの名前や表示状態を更新する |
| カスタムプロダクトページの編集可能バージョンを作成する |
| カスタムプロダクトページのバージョンを取得する |
| カスタムプロダクトページのディープリンクを更新する |
| カスタムページのローカライズを作成する |
| アプリまたはビルドの電力・パフォーマンス指標を取得する |
| ビルドのクラッシュ、ハングなどの診断シグネチャを取得する |
| 診断シグネチャの匿名化ログとコールスタックを取得する |
各list系ツールは limit(デフォルト20、最大200)と nextUrl(前回のレスポンスに含まれる nextUrl をそのまま渡すと次ページを取得)でページネーションに対応する。
リリース提出の基本フロー
asc_create_app_store_versionでバージョンを作る。asc_create_version_localizationまたはasc_update_version_localizationで更新内容などを入れる。必要なら
asc_create_screenshot_setとasc_upload_screenshotで画像を更新する。asc_set_version_buildで処理済みビルドを紐付ける。asc_create_review_detailsまたはasc_update_review_detailsで審査メモなどを整える。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は各社の商標。
ライセンス
Available Tools
63 toolsasc_add_to_beta_groupAdd Testers or Builds to TestFlight GroupCIdempotent
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 SetADestructiveIdempotent
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 DataARead-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 AvailabilityARead-onlyIdempotent
Get global and per-territory App Store availability, release, and pre-order settings.
Inputs: appId (required).
asc_get_app_price_scheduleGet App Price ScheduleARead-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 DetailsARead-onlyIdempotent
Get internal and external testing states and the buildBetaDetail ID for a build.
Inputs: buildId (required).
asc_get_diagnostic_logsGet Diagnostic LogsARead-onlyIdempotent
Download anonymized call-stack logs and insights for one diagnostic signature.
Inputs: signatureId (required).
asc_get_performance_metricsGet Power and Performance MetricsBRead-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 DetailsARead-onlyIdempotent
Get the App Review contact information, demo account, and notes for an App Store version.
Inputs: versionId (required).
asc_get_sales_reportGet Sales ReportARead-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 ReportsARead-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 LocalizationsARead-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 PointsARead-onlyIdempotent
List selectable customer prices and proceeds for an app in one territory.
Inputs: appId (required), territory (required), limit, nextUrl.
asc_list_appsList AppsARead-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 VersionsARead-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 LocalizationsARead-onlyIdempotent
List localized What to Test text for a TestFlight build.
Inputs: buildId (required), limit, nextUrl.
asc_list_beta_groupsList TestFlight GroupsARead-onlyIdempotent
List internal and external TestFlight groups for an app.
Inputs: appId (required), limit, nextUrl.
asc_list_beta_testersList TestFlight TestersARead-onlyIdempotent
List TestFlight testers, optionally filtering by exact email address.
Inputs: email, limit, nextUrl.
asc_list_buildsList BuildsARead-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 ReviewsARead-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 PagesARead-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 VersionsCRead-onlyIdempotent
List editable and reviewed versions of a custom product page.
Inputs: pageId (required), limit, nextUrl.
asc_list_diagnostic_signaturesList Diagnostic SignaturesARead-onlyIdempotent
List recurring crash, hang, and disk-write signatures collected for a build.
Inputs: buildId (required), limit, nextUrl, diagnosticType.
asc_list_experiment_treatmentsList Experiment TreatmentsBRead-onlyIdempotent
List the treatment variants in a Product Page Optimization experiment.
Inputs: experimentId (required), limit, nextUrl.
asc_list_product_page_experimentsList Product Page ExperimentsBRead-onlyIdempotent
List Product Page Optimization A/B experiments for an App Store version.
Inputs: versionId (required), limit, nextUrl.
asc_list_screenshotsList ScreenshotsARead-onlyIdempotent
List the ordered screenshots and upload processing states in a screenshot set.
Inputs: screenshotSetId (required), limit, nextUrl.
asc_list_screenshot_setsList Screenshot SetsARead-onlyIdempotent
List screenshot sets for an App Store version localization.
Inputs: localizationId (required), limit, nextUrl.
asc_list_territory_availabilitiesList Territory AvailabilitiesARead-onlyIdempotent
List every territory availability with pagination for an app availability resource.
Inputs: appAvailabilityId (required), limit, nextUrl.
asc_list_version_localizationsList Version LocalizationsARead-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 VersionADestructive
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 ReportsAIdempotent
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 RankingARead-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 PriceADestructive
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 TestAIdempotent
Create or update localized What to Test text for a TestFlight build.
Inputs: no named parameters.
asc_set_version_buildSet Version BuildAIdempotent
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 VersionBDestructive
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 ReviewADestructive
Submit a build to Beta App Review before external TestFlight distribution.
Inputs: buildId (required).
asc_submit_product_page_review_itemSubmit Product Page Review ItemBDestructive
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 VersionCIdempotent
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 DetailsCIdempotent
Enable or disable automatic tester invitations when an external build becomes available.
Inputs: autoNotifyEnabled (required), buildBetaDetailId (required).
asc_update_custom_product_pageUpdate Custom Product PageBIdempotent
Rename or show and hide a custom product page.
Inputs: pageId (required), name, visible.
asc_update_custom_product_page_versionUpdate Custom Product Page VersionBIdempotent
Update the app deep link for an editable custom product page version.
Inputs: pageVersionId (required), deepLink.
asc_update_phased_releaseUpdate Phased ReleaseBIdempotent
Start, pause, resume, or complete an existing phased release.
Inputs: phasedReleaseId (required), phasedReleaseState (required).
asc_update_product_page_experimentUpdate Product Page ExperimentAIdempotent
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 DetailsBIdempotent
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 AvailabilityADestructiveIdempotent
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
Scored across 63 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for Appcircle mobile CI/CD platform.
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
Hosted iOS app intelligence and creative research MCP server.
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
Related MCP Servers
- AlicenseAqualityBmaintenanceApp 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.451,274 npm2MIT
- AlicenseBqualityBmaintenanceA 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.601MIT
- AlicenseNot gradedqualityBmaintenanceA 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 npm1MIT
- AlicenseAqualityFmaintenanceAn MCP server that gives AI assistants structured access to App Store Connect data. Built for ASO analysis, download tracking, and performance monitoring.71MIT