Skip to main content
Glama
App Store Connect MCP Server

App Store Connect MCP Server

by yuraist

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

npm 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 (.p8 file) — how to create one

Setup

  1. Clone and install:

git clone https://github.com/yuraist/appstoreconnect-mcp.git
cd appstoreconnect-mcp
npm install
npm run build
  1. Create a .env file from the example:

cp .env.example .env
  1. Fill in your API credentials:

ASC_ISSUER_ID=your-issuer-id
ASC_KEY_ID=your-key-id
ASC_PRIVATE_KEY_PATH=/path/to/AuthKey_XXXXXXXXXX.p8

You'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.pem

Then 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-id

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

Or add it globally:

claude mcp add --scope user appstoreconnect -- node /absolute/path/to/appstoreconnect-mcp/build/index.js

Make 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 tools
add_build_to_beta_groupC
Destructive

Assign a build to a TestFlight beta group

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

add_testers_to_beta_groupB
Destructive

Add existing TestFlight testers to a group. Adding may send invitations.

Inputs: betaGroupId (required), betaTesterIds (required).

create_beta_groupA
Destructive

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_testerB
Destructive

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_pageC
Destructive

Create a new custom product page for an app

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

create_experimentC
Destructive

Create a new A/B test experiment for an app store version

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

create_iapC
Destructive

Create a new in-app purchase

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

create_subscriptionC
Destructive

Create a new auto-renewable subscription

Inputs: name (required), groupId (required), productId (required), subscriptionPeriod (required).

create_subscription_groupC
Destructive

Create a new subscription group for an app

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

create_subscription_offerC
Destructive

Create a promotional offer for a subscription

Inputs: name (required), duration (required), offerCode (required), offerMode (required), +2 more.

delete_iapA
Destructive

Delete a draft in-app purchase (only works if not yet submitted for review)

Inputs: iapId (required).

get_api_operationA
Read-onlyIdempotent

Get exact parameters and request schemas, including referenced definitions, for an Apple operation before executing it. No network request.

Inputs: operationId (required).

get_appB
Read-onlyIdempotent

Get details for a specific app by its App Store Connect ID

Inputs: appId (required).

get_beta_review_statusB
Read-onlyIdempotent

Read TestFlight Beta App Review state for a build.

Inputs: buildId (required).

get_buildB
Read-onlyIdempotent

Get details for a specific build

Inputs: buildId (required).

get_custom_product_pageC
Read-onlyIdempotent

Get details for a specific custom product page

Inputs: pageId (required).

get_experimentB
Read-onlyIdempotent

Get details for a specific A/B test experiment

Inputs: experimentId (required).

get_experiment_resultsB
Read-onlyIdempotent

Get results for an A/B test experiment including conversion rates per treatment

Inputs: experimentId (required).

get_iapB
Read-onlyIdempotent

Get details for a specific in-app purchase

Inputs: iapId (required).

get_review_statusC
Read-onlyIdempotent

Get the current review status for an app store version

Inputs: versionId (required).

get_review_submissionB
Read-onlyIdempotent

Get the latest review submission for an app, including rejection reasons if any

Inputs: appId (required), platform.

list_appsB
Read-onlyIdempotent

List all apps in your App Store Connect account

Inputs: no named parameters.

list_app_store_version_localizationsB
Read-onlyIdempotent

List localizations for an app store version (descriptions, what's new, keywords per locale)

Inputs: versionId (required).

list_app_versionsB
Read-onlyIdempotent

List all App Store versions for an app

Inputs: appId (required), platform.

list_beta_groupsB
Read-onlyIdempotent

List TestFlight beta groups for an app

Inputs: appId (required).

list_beta_testersA
Read-onlyIdempotent

List TestFlight beta testers, optionally filtered by beta group

Inputs: betaGroupId.

list_buildsA
Read-onlyIdempotent

List builds for an app, optionally filtered by version or processing state

Inputs: appId (required), version, processingState.

list_custom_product_pagesA
Read-onlyIdempotent

List all custom product pages for an app

Inputs: appId (required).

list_experimentsB
Read-onlyIdempotent

List all A/B test experiments for an app store version

Inputs: versionId (required).

list_iap_localizationsA
Read-onlyIdempotent

List localizations (display names, descriptions) for an in-app purchase

Inputs: iapId (required).

list_iapsA
Read-onlyIdempotent

List all in-app purchases for an app

Inputs: appId (required).

list_subscription_groupsC
Read-onlyIdempotent

List subscription groups for an app

Inputs: appId (required).

list_subscription_localizationsB
Read-onlyIdempotent

List localizations (display names, descriptions) for a subscription

Inputs: subscriptionId (required).

list_subscription_offersB
Read-onlyIdempotent

List promotional offers for a subscription

Inputs: subscriptionId (required).

list_subscription_price_pointsA
Read-onlyIdempotent

List available price points for a subscription, optionally filtered by territory

Inputs: subscriptionId (required), territory.

list_subscriptionsB
Read-onlyIdempotent

List subscriptions within a subscription group

Inputs: groupId (required).

read_apiA
Read-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_groupC
Destructive

Remove existing TestFlight testers from a group. Adding may send invitations.

Inputs: betaGroupId (required), betaTesterIds (required).

search_api_operationsB
Read-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_localizationA
Destructive

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_complianceC
Destructive

Declare whether a build uses non-exempt encryption. Use the app's actual export-compliance determination.

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

set_iap_localizationC
Destructive

Create or update a localization for an in-app purchase

Inputs: name (required), iapId (required), locale (required), description, +1 more.

set_iap_priceB
Destructive

Set or update the price for an in-app purchase using a price point ID

Inputs: iapId (required), pricePointId (required).

set_subscription_localizationC
Destructive

Create or update a localization for a subscription

Inputs: name (required), locale (required), subscriptionId (required), description, +1 more.

set_subscription_priceC
Destructive

Set a price point for a subscription

Inputs: pricePointId (required), subscriptionId (required), startDate.

start_experimentC
Destructive

Start running an A/B test experiment

Inputs: experimentId (required).

stop_experimentC
Destructive

Stop a running A/B test experiment

Inputs: experimentId (required).

submit_beta_reviewA
Destructive

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_reviewA
Destructive

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_reviewA
Destructive

Submit an in-app purchase for review independently of the app version

Inputs: iapId (required).

update_app_descriptionB
Destructive

Update the app description for a specific locale

Inputs: description (required), localizationId (required).

update_beta_groupC
Destructive

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_pageB
Destructive

Update a custom product page name or visibility

Inputs: pageId (required), name, visible.

update_iapC
Destructive

Update an existing in-app purchase

Inputs: iapId (required), name, reviewNote.

update_keywordsC
Destructive

Update the keywords for a specific locale

Inputs: keywords (required), localizationId (required).

update_subscriptionC
Destructive

Update an existing subscription

Inputs: subscriptionId (required), name, groupLevel, reviewNote, +1 more.

update_whats_newC
Destructive

Update the 'What's New' text for a specific locale

Inputs: whatsNew (required), localizationId (required).

upload_buildA
Destructive

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_assetA
Destructive

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_apiA
Destructive

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

    B3.1/5.0

    Scored across 60 tools

    Disambiguation3/5

    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.

    Naming Consistency5/5

    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.

    Tool Count1/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      A 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.
      69
      106 npm
      14
      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
    • A
      license
      B
      quality
      C
      maintenance
      An unofficial MCP server for the App Store Connect API that enables automation of app management, reviews, TestFlight, analytics, and release processes through natural language.
      63
      185 npm
      2
      MIT