App Store Connect MCP Server
It is a local MCP server that gives Claude or other MCP clients direct access to Apple App Store Connect workflows, plus an optional Apple Ads keyword-research integration.
List and inspect apps, app versions, builds, beta groups, and beta testers; assign builds to TestFlight groups.
Create, update, delete, localize, price, and submit in-app purchases for review.
Manage subscription groups, subscriptions, localizations, price points, and promotional offers.
Create and manage custom product pages and A/B test experiments, including starting/stopping tests and viewing results.
Check App Review status, review submissions, and rejection reasons; update descriptions, What's New text, and keywords per locale; submit versions for review.
Search, describe, and execute any of 1,303 App Store Connect API operations via read/write API tools, with dry-run support for writes.
Use optional Apple Ads tools for App Store search-term popularity, keyword suggestions, and impression-share data.
Use the same API client from a CLI for search, describe, read, write, and signed build uploads.
Provides tools for managing apps, in-app purchases, subscriptions, TestFlight, product page experiments, and App Review submissions via Apple's App Store Connect API.
Offers integration with the App Store Connect platform, enabling management of app listings, pricing, localizations, beta builds, and review submissions.
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., "@App Store Connect MCP Server List all my apps in App Store Connect"
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.
App Store Connect MCP Server
A Model Context Protocol server that wraps Apple's App Store Connect API (official OpenAPI 4.5.1). Gives Claude (or any MCP client) direct access to manage apps, in-app purchases, subscriptions, TestFlight, product page experiments, and App Review submissions.
API-first release 0.2.1
The server exposes 60 tools plus optional Apple Ads tools. A searchable catalog covers all 1303 operations in the pinned Apple specification. Search and inspect an operation, then execute a validated GET with read_api or a mutation with write_api. Reads preserve the JSON:API envelope; writes support dry-run. This avoids thousands of MCP tool definitions while keeping the full public API reachable.
New named workflows cover TestFlight groups, public links, tester membership, beta review, export compliance, What to Test, signed build uploads, and file delivery for screenshots/previews/review attachments. App Store submission now attaches the app version and actually submits its draft.
Use the same API client from the CLI:
npm run build
node build/cli.js search betaGroups
node build/cli.js describe betaGroups_createInstance
node build/cli.js read apps_getCollection
node build/cli.js write betaGroups_createInstance group.json --dry-run
node build/cli.js upload signed-build.jsonnpm run install:local -- --shared-skill also links the shared agent skill to this checkout, preserving an existing skill symlink. npm run install:local refreshes the local plugin files and installs asc-api and appstoreconnect-mcp links under ~/.local/bin. Refresh the existing Codex personal marketplace plugin with codex plugin add appstoreconnect@personal --json. Existing Claude MCP registrations using scripts/launch.mjs load the new build on reconnect. New Codex chats refresh the discovered tools; the CLI can be used immediately.
MCP uses SDK 2.4 with protocol 2026-07-28 and a compatibility listener for older clients. The plugin includes a workflow skill and portable, Codex and Claude manifests. See API workflow guide and compatibility research.
Related MCP server: App Store Connect MCP
What You Can Do
Apps — List apps, view details, check version history and statuses.
In-App Purchases — Create, update, delete IAPs. Manage localizations and pricing. Submit for review.
Subscriptions — Manage subscription groups and products. Set prices per territory. Create introductory and promotional offers.
Product Page Optimization — Create custom product pages. Run A/B test experiments and check results.
Builds & TestFlight — List builds, manage beta groups and testers, distribute builds to test groups.
App Review — Check review status, view rejection reasons, submit versions for review. Update descriptions, keywords, and What's New text per locale.
Keyword Research (Apple Ads) — Apple's own App Store search term popularity, keyword suggestions, and impression share. Optional, and needs separate credentials — see Apple Ads setup.
See the full tool reference for named tools and the full API catalog.
Prerequisites
Node.js 22.12+ (or a newer supported Node release)
An Apple Developer account with App Store Connect access
An App Store Connect API key (
.p8file) — how to create one
Setup
Clone and install:
git clone https://github.com/yuraist/appstoreconnect-mcp.git
cd appstoreconnect-mcp
npm install
npm run buildCreate a
.envfile from the example:
cp .env.example .envFill in your API credentials:
ASC_ISSUER_ID=your-issuer-id
ASC_KEY_ID=your-key-id
ASC_PRIVATE_KEY_PATH=/path/to/AuthKey_XXXXXXXXXX.p8You'll find the Issuer ID and Key ID on the App Store Connect API Keys page.
Apple Ads Setup (optional)
In August 2026 Apple released the Apple Ads Platform API 1.0, which exposes App Store search term popularity — first-party keyword demand data that ASO tools previously could only estimate from models and historical data. This server can query it, along with keyword and phrase suggestions.
These tools are off unless you configure them, so the server works fine with App Store Connect alone.
These are not your App Store Connect credentials. Apple Ads uses a different host, a different key registry, and a different auth model (OAuth2 client-credentials, where the JWT is only the client secret rather than the bearer token itself). Your .p8 will not work here.
You must be on Apple Ads Advanced, not Basic. Apple's comparison page is explicit that Basic gets "no keyword data or access to the Apple Ads Platform API" — it is disqualified twice over. Pick Advanced at signup.
You do not need a company. Apple's setup guide says that if you're a sole proprietor you answer "No" to the business-entity question and use your own legal name as the legal entity name. No D-U-N-S number is involved anywhere in this flow, and an Individual Apple Developer account is fine.
What you need:
An Apple Ads Advanced account. Creating one requires a live iPhone or iPad app on the App Store, an Apple Account with an email address (phone-number-only accounts are rejected), and an App Store Connect role of Admin, Legal, App Manager, or Marketing to link the two.
A valid credit or debit card. Prepaid cards, gift cards, and digital wallets like PayPal are explicitly rejected. No minimum spend or deposit is documented — a working card on file is the real requirement.
API access created by an Account Admin at ads.apple.com → Account Settings → API, where you upload the public half of an EC P-256 key pair and receive a client ID, team ID, and key ID.
Two settings are permanent once chosen: account currency and time zone. Changing currency later means creating a new account. Supported currencies are AUD, GBP, CAD, RMB (mainland China), EUR, INR (UPI only), JPY, MXN, NZD, and USD — check countries and regions, which lists permitted advertiser-residence countries separately from the storefronts you can advertise in.
Generate the key pair with:
openssl ecparam -genkey -name prime256v1 -noout -out apple-ads-private-key.pem
openssl ec -in apple-ads-private-key.pem -pubout -out apple-ads-public-key.pemThen add to .env:
APPLE_ADS_CLIENT_ID=SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
APPLE_ADS_TEAM_ID=SEARCHADS.xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
APPLE_ADS_KEY_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
APPLE_ADS_PRIVATE_KEY_PATH=/path/to/apple-ads-private-key.pem
APPLE_ADS_AD_ACCOUNT_ID=your-ad-account-idDon't know your ad account ID? Leave it unset, start the server, and run the list_ad_accounts tool — it's the one call that works without it.
What the data looks like. get_search_term_popularity returns up to the top 500 search terms per country and genre, scored 1–100 (within genre and overall) and 1–5 (matching the figure in the Apple Ads UI). Only terms with at least 500 searches appear. Scoping is per storefront, not per language. Weekly data is published Mondays at 07:00 UTC with 65 weeks of history; monthly data on the 5th of each month with 15 months. No advertising campaign is required to query it.
Usage with Claude Desktop
Add this to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"appstoreconnect": {
"command": "node",
"args": ["/absolute/path/to/appstoreconnect-mcp/build/index.js"],
"env": {
"ASC_ISSUER_ID": "your-issuer-id",
"ASC_KEY_ID": "your-key-id",
"ASC_PRIVATE_KEY_PATH": "/path/to/AuthKey_XXXXXXXXXX.p8"
}
}
}
}Restart Claude Desktop. The App Store Connect tools will appear in the tool list.
Usage with Claude Code
Add the server to your project:
claude mcp add appstoreconnect -- node /absolute/path/to/appstoreconnect-mcp/build/index.jsOr add it globally:
claude mcp add --scope user appstoreconnect -- node /absolute/path/to/appstoreconnect-mcp/build/index.jsMake sure the environment variables are set in your shell, or use the .env file in the project directory.
Example Prompts
Once connected, try asking Claude:
"List all my apps in App Store Connect"
"Show me the current review status for my app"
"Create a new consumable IAP called 'Premium Gems' with product ID com.example.gems"
"What subscription groups do I have for app X?"
"Add this build to the External Testers beta group"
"Start an A/B test experiment on the current version"
Security
Your API key (.p8 file) never leaves your machine. The MCP server runs locally, authenticating directly with Apple's API using short-lived JWTs.
License
MIT
Codex and other local MCP clients
Build once with npm ci && npm run build. Launch with node scripts/launch.mjs.
The launcher loads only ASC_* and APPLE_ADS_* variables from
~/Developer/.secrets/.env, or the file selected by ASC_ENV_FILE.
Explicit process environment values take precedence. Key material stays local.
The stdio protocol works from any working directory.
For Codex CLI, register with codex mcp add appstoreconnect -- node /absolute/path/to/appstoreconnect-mcp/scripts/launch.mjs.
Use either this registration or the personal Codex plugin, so tools appear once.
For Claude Code, use the same command and arguments in the appstoreconnect
MCP entry. No credentials need to be embedded in the client configuration.
npm run smoke checks protocol initialization, tool discovery, and annotations.
npm run smoke:live additionally calls the read-only list_apps endpoint and
prints only the count. Neither command changes App Store Connect data.
This is a local connector. A remotely hosted connector would separately need Streamable HTTP, client authentication/OAuth, per-user Apple credential storage, and a deployment. The personal Codex plugin does not expose a public endpoint.
Available Tools
60 toolsadd_build_to_beta_groupCDestructive
Assign a build to a TestFlight beta group
Inputs: buildId (required), betaGroupId (required).
add_testers_to_beta_groupBDestructive
Add existing TestFlight testers to a group. Adding may send invitations.
Inputs: betaGroupId (required), betaTesterIds (required).
create_beta_groupADestructive
Create an internal or external TestFlight group. External public links are optional. Internal testers must already be eligible ASC team users.
Inputs: name (required), appId (required), isInternalGroup, publicLinkLimit, +1 more.
create_beta_testerBDestructive
Create/invite a TestFlight tester by email and assign to groups. May send invitation email. For internal testing, the user must already have the appropriate ASC team access.
Inputs: email (required), betaGroupIds (required), lastName, firstName.
create_custom_product_pageCDestructive
Create a new custom product page for an app
Inputs: name (required), appId (required).
create_experimentCDestructive
Create a new A/B test experiment for an app store version
Inputs: name (required), platform (required), versionId (required), trafficProportion (required).
create_iapCDestructive
Create a new in-app purchase
Inputs: name (required), appId (required), productId (required), inAppPurchaseType (required).
create_subscriptionCDestructive
Create a new auto-renewable subscription
Inputs: name (required), groupId (required), productId (required), subscriptionPeriod (required).
create_subscription_groupCDestructive
Create a new subscription group for an app
Inputs: appId (required), referenceName (required).
create_subscription_offerCDestructive
Create a promotional offer for a subscription
Inputs: name (required), duration (required), offerCode (required), offerMode (required), +2 more.
delete_iapADestructive
Delete a draft in-app purchase (only works if not yet submitted for review)
Inputs: iapId (required).
get_api_operationARead-onlyIdempotent
Get exact parameters and request schemas, including referenced definitions, for an Apple operation before executing it. No network request.
Inputs: operationId (required).
get_appBRead-onlyIdempotent
Get details for a specific app by its App Store Connect ID
Inputs: appId (required).
get_beta_review_statusBRead-onlyIdempotent
Read TestFlight Beta App Review state for a build.
Inputs: buildId (required).
get_buildBRead-onlyIdempotent
Get details for a specific build
Inputs: buildId (required).
get_custom_product_pageCRead-onlyIdempotent
Get details for a specific custom product page
Inputs: pageId (required).
get_experimentBRead-onlyIdempotent
Get details for a specific A/B test experiment
Inputs: experimentId (required).
get_experiment_resultsBRead-onlyIdempotent
Get results for an A/B test experiment including conversion rates per treatment
Inputs: experimentId (required).
get_iapBRead-onlyIdempotent
Get details for a specific in-app purchase
Inputs: iapId (required).
get_review_statusCRead-onlyIdempotent
Get the current review status for an app store version
Inputs: versionId (required).
get_review_submissionBRead-onlyIdempotent
Get the latest review submission for an app, including rejection reasons if any
Inputs: appId (required), platform.
list_appsBRead-onlyIdempotent
List all apps in your App Store Connect account
Inputs: no named parameters.
list_app_store_version_localizationsBRead-onlyIdempotent
List localizations for an app store version (descriptions, what's new, keywords per locale)
Inputs: versionId (required).
list_app_versionsBRead-onlyIdempotent
List all App Store versions for an app
Inputs: appId (required), platform.
list_beta_groupsBRead-onlyIdempotent
List TestFlight beta groups for an app
Inputs: appId (required).
list_beta_testersARead-onlyIdempotent
List TestFlight beta testers, optionally filtered by beta group
Inputs: betaGroupId.
list_buildsARead-onlyIdempotent
List builds for an app, optionally filtered by version or processing state
Inputs: appId (required), version, processingState.
list_custom_product_pagesARead-onlyIdempotent
List all custom product pages for an app
Inputs: appId (required).
list_experimentsBRead-onlyIdempotent
List all A/B test experiments for an app store version
Inputs: versionId (required).
list_iap_localizationsARead-onlyIdempotent
List localizations (display names, descriptions) for an in-app purchase
Inputs: iapId (required).
list_iapsARead-onlyIdempotent
List all in-app purchases for an app
Inputs: appId (required).
list_subscription_groupsCRead-onlyIdempotent
List subscription groups for an app
Inputs: appId (required).
list_subscription_localizationsBRead-onlyIdempotent
List localizations (display names, descriptions) for a subscription
Inputs: subscriptionId (required).
list_subscription_offersBRead-onlyIdempotent
List promotional offers for a subscription
Inputs: subscriptionId (required).
list_subscription_price_pointsARead-onlyIdempotent
List available price points for a subscription, optionally filtered by territory
Inputs: subscriptionId (required), territory.
list_subscriptionsBRead-onlyIdempotent
List subscriptions within a subscription group
Inputs: groupId (required).
read_apiARead-onlyIdempotent
Execute an official Apple GET operation after schema validation. Returns one unflattened JSON:API page with relationships, included resources and pagination links. Pass cursor from links.next for another page. Binary reports return base64.
Inputs: operationId (required), body, path, query.
remove_testers_from_beta_groupCDestructive
Remove existing TestFlight testers from a group. Adding may send invitations.
Inputs: betaGroupId (required), betaTesterIds (required).
search_api_operationsBRead-onlyIdempotent
Search the complete official Apple App Store Connect OpenAPI catalog. Covers provisioning, users, TestFlight, releases, metadata, pricing, screenshots, analytics, Xcode Cloud and more. No network request.
Inputs: limit, query, method, offset.
set_beta_build_localizationADestructive
Create or update localized What to Test text for a TestFlight build. Supply localizationId to update an existing locale.
Inputs: locale (required), buildId (required), whatsNew (required), localizationId.
set_build_export_complianceCDestructive
Declare whether a build uses non-exempt encryption. Use the app's actual export-compliance determination.
Inputs: buildId (required), usesNonExemptEncryption (required).
set_iap_localizationCDestructive
Create or update a localization for an in-app purchase
Inputs: name (required), iapId (required), locale (required), description, +1 more.
set_iap_priceBDestructive
Set or update the price for an in-app purchase using a price point ID
Inputs: iapId (required), pricePointId (required).
set_subscription_localizationCDestructive
Create or update a localization for a subscription
Inputs: name (required), locale (required), subscriptionId (required), description, +1 more.
set_subscription_priceCDestructive
Set a price point for a subscription
Inputs: pricePointId (required), subscriptionId (required), startDate.
start_experimentCDestructive
Start running an A/B test experiment
Inputs: experimentId (required).
stop_experimentCDestructive
Stop a running A/B test experiment
Inputs: experimentId (required).
submit_beta_reviewADestructive
Submit a processed build for TestFlight external Beta App Review, after completing beta app description, review contacts and export compliance. This is separate from App Store review.
Inputs: buildId (required).
submit_for_reviewADestructive
Submit an app version for App Store review: resolve/reuse a draft submission, attach the version and set submitted=true. Separate from TestFlight beta review. On failure inspect and resume the returned submission ID.
Inputs: appId (required), platform, versionId, submissionId.
submit_iap_for_reviewADestructive
Submit an in-app purchase for review independently of the app version
Inputs: iapId (required).
update_app_descriptionBDestructive
Update the app description for a specific locale
Inputs: description (required), localizationId (required).
update_beta_groupCDestructive
Rename a TestFlight group or enable/disable its public invitation link and tester limit.
Inputs: betaGroupId (required), name, publicLinkLimit, publicLinkEnabled, +1 more.
update_custom_product_pageBDestructive
Update a custom product page name or visibility
Inputs: pageId (required), name, visible.
update_iapCDestructive
Update an existing in-app purchase
Inputs: iapId (required), name, reviewNote.
update_keywordsCDestructive
Update the keywords for a specific locale
Inputs: keywords (required), localizationId (required).
update_subscriptionCDestructive
Update an existing subscription
Inputs: subscriptionId (required), name, groupLevel, reviewNote, +1 more.
update_whats_newCDestructive
Update the 'What's New' text for a specific locale
Inputs: whatsNew (required), localizationId (required).
upload_buildADestructive
Upload a ready, signed local .ipa/.pkg/.zip using Apple's Build Upload API. Streams chunks and commits the checksum. Does not compile, sign, distribute or submit review. For large builds prefer the CLI to avoid host tool-call timeouts. On failure inspect returned reservation IDs before retrying.
Inputs: appId (required), version (required), filePath (required), buildNumber (required), +1 more.
upload_reserved_assetADestructive
Upload a local file into an existing Apple reservation and commit its checksum. Supports screenshots, app previews, review attachments and build files. Create the reservation through write_api first; upload instructions are fetched directly from Apple.
Inputs: filePath (required), resourceId (required), resourceType (required).
write_apiADestructive
Execute a schema-validated official Apple POST/PATCH/DELETE operation. Changes production Apple data; only use within the user's authorized scope. dryRun validates without a network call. Cannot create a new app record: Apple requires its website.
Inputs: operationId (required), body, path, query, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 60 tools
Most specialized tools target distinct resources and actions, but the generic read_api/write_api tools overlap with nearly every specific list/get/create/update tool. upload_build and upload_reserved_asset also overlap for build-file uploads. Descriptions help clarify intent, but an agent still faces real selection ambiguity.
Tool names consistently use snake_case with a verb-first noun pattern (list_apps, get_build, create_iap, set_subscription_price, submit_for_review). Even the generic API tools follow the same convention. There is no mixed casing or chaotic verb style.
At 60 tools, the surface is far beyond a well-scoped set and exceeds the rubric's 50+ extreme threshold. While App Store Connect is a broad domain, this many tools creates substantial selection overhead and increases the chance of choosing the wrong operation.
Core App Store Connect workflows are well covered: apps, versions, builds, TestFlight, review submission, IAPs, subscriptions, pricing, experiments, custom product pages and localizations. Some gaps remain, such as app-level metadata beyond description/whats-new/keywords and user/provisioning operations, but the search/read/write API tools provide a general escape hatch.
Maintenance
Related MCP Connectors
Model Context Protocol server for the Apideck Unified API. Connect any MCP-compatible agent framework to 100+ accounting systems, HRIS platforms, file storage providers, and more through one integration. More information https://www.apideck.com/mcp-server
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
A Model Context Protocol server for Wix AI tools
A Model Context Protocol (MCP) application for automated GitHub PR analysis and issue management.…
Related MCP Servers
- AlicenseAqualityBmaintenanceA Model Context Protocol (MCP) server for Apple's App Store Connect API. Manage your iOS, macOS, tvOS, and visionOS apps directly from Claude, Cursor, or any MCP-compatible client.52185 npm23MIT
- AlicenseAqualityDmaintenanceA Model Context Protocol (MCP) server that connects Cursor, Claude Desktop, and other MCP clients to the official App Store Connect API—so you can manage iOS/macOS apps, TestFlight, in-app subscriptions, and store metadata via chat or automated tool calls.69106 npm14MIT
- 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
- AlicenseBqualityCmaintenanceAn unofficial MCP server for the App Store Connect API that enables automation of app management, reviews, TestFlight, analytics, and release processes through natural language.63185 npm2MIT