npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@cntechio-dev/app-store-connect-mcp

v0.1.0

Published

MCP server for the official App Store Connect API

Readme

App Store MCP

Manage App Store Connect releases, metadata, TestFlight, screenshots, and reviews from an AI agent.

Node.js 20+ 38 MCP tools MIT license

Quick start · Capabilities · Apple credentials · MCP clients · Tool reference

App Store MCP is a stdio Model Context Protocol server using the official App Store Connect API. Its shape follows the sibling Play Store MCP project, but uses Apple's resources and publishing workflow. It does not scrape the App Store Connect website. Tools return Apple's JSON:API response, including resource IDs and links.next for pagination.

Quick start

  1. Install Node.js 20 or newer and create an App Store Connect API key.

  2. Configure the server in your MCP client. For a package installed from npm after publication:

    codex mcp add app-store \
      --env APP_STORE_CONNECT_KEY_ID=YOUR_KEY_ID \
      --env APP_STORE_CONNECT_ISSUER_ID=YOUR_ISSUER_UUID \
      --env APP_STORE_CONNECT_PRIVATE_KEY_PATH=/absolute/path/to/AuthKey_YOUR_KEY_ID.p8 \
      -- npx -y @cntechio-dev/app-store-connect-mcp
    codex mcp list

    The package is currently local and has not been published. For local use, replace npx -y @cntechio-dev/app-store-connect-mcp with node /absolute/path/to/app-store-mcp/dist/index.js after npm install && npm run build.

  3. Ask your agent to call list_apps, then use the returned app id in other tools. The App Store Connect app ID is an opaque resource ID, not the bundle ID.

Capabilities

| Area | Tools | | --- | --- | | Apps and builds | Discover apps and versions; upload IPA binaries; inspect upload status and processed builds. | | Reviews | Read customer reviews and publish or replace developer replies. | | Metadata | Read and edit app-level name/subtitle and version-level descriptions, keywords, URLs, and release notes. | | Screenshots | Create screenshot sets, upload local PNG/JPEG files with Apple's reserve/upload/commit workflow, and list screenshots. | | TestFlight | List and create beta groups and testers, then assign processed builds and existing testers to groups. | | Publishing | Create a version, attach a processed build, create a review submission, add the version, submit it, and manually release an approved version. |

Apple does not use Google Play's transactional app edits. Metadata changes affect App Store Connect immediately, subject to the version state. Sending a review submission starts Apple's review process; it does not guarantee approval. release_version is only for an approved version in PENDING_DEVELOPER_RELEASE and cannot be canceled. Apple's manual release documentation

The upload_ipa tool uses Apple's Build uploads API: it creates a build upload, reserves the IPA file, uploads Apple-specified byte ranges, and commits an MD5 checksum. Provide the version and build number found inside the IPA; the server does not inspect the archive. Apple processes uploads asynchronously. Poll get_build_upload, then list_builds, and attach only a processed build. Xcode and Transporter remain alternatives for binary delivery.

Tool reference

| Tool | Action | | --- | --- | | list_apps | List apps; optionally filter by bundle ID. | | get_app | Read one app. | | list_versions | List an app's App Store versions, optionally by platform. | | get_version | Read a version and its assigned build. | | list_builds | List processed builds for an app. | | get_build | Read a build and processing state. | | list_build_uploads | List build upload records for an app. | | get_build_upload | Read upload processing state. | | upload_ipa | Uploads: send a local iOS IPA via Apple Build uploads API. | | list_reviews | List an app's reviews, optionally by rating. | | get_review | Read one customer review. | | get_review_response | Read the developer response for a review. | | reply_to_review | Publishes: create or replace a public review response. | | list_localizations | List version-level metadata localizations. | | get_localization | Read a version localization. | | create_localization | Changes metadata: add a version localization. | | update_localization | Changes metadata: edit description, keywords, release notes, and URLs. | | list_app_infos | List app-level information records. | | list_app_info_localizations | List localized names, subtitles, and privacy URLs. | | create_app_info_localization | Changes metadata: add an app-level locale. | | update_app_info_localization | Changes metadata: edit localized name, subtitle, or privacy URLs. | | list_screenshot_sets | List screenshot sets for a version locale. | | create_screenshot_set | Changes metadata: create a display-type screenshot set. | | list_screenshots | List screenshots in a set. | | upload_screenshot | Uploads: add a local PNG or JPEG to a screenshot set. | | list_beta_groups | List an app's TestFlight groups. | | create_beta_group | Changes TestFlight access: create a group. | | list_beta_testers | List an app's TestFlight testers. | | create_beta_tester | Changes TestFlight access: add a tester to a group. | | add_build_to_beta_group | Changes TestFlight access: give a group access to a build. | | add_tester_to_beta_group | Changes TestFlight access: add an existing tester to a group. | | create_version | Creates draft: create an App Store version. | | assign_build_to_version | Changes draft: attach a processed build. | | list_review_submissions | List App Review submissions. | | create_review_submission | Creates draft: create a submission container. | | add_version_to_submission | Changes draft: add a version to a submission. | | submit_review | Submits: send the submission and all its items to App Review; requires confirmSubmit: true. | | release_version | Publishes: manually release an approved version; requires confirmPublish: true. |

List tools accept limit and the links.next URL returned by Apple. Use resource IDs from prior responses. Adding a new locale requires both create_localization and create_app_info_localization; Apple rejects submissions when those locale sets differ. Screenshot display types are Apple's values, such as APP_IPHONE_67 and APP_IPAD_PRO_3GEN_129. The screenshot upload uses Apple's appScreenshots flow; Apple also offers newer asset library APIs, which this package does not yet expose. Localization requirements, screenshot upload workflow

Apple credentials

The Account Holder must request access to the App Store Connect API before keys can be used. Create either a team key under Users and Access → Integrations → App Store Connect API → Team Keys, or an individual key from your profile. Team keys apply to all apps in the account; individual keys inherit the user's app access. Choose the narrowest role that supports your intended tools. Apple key and role documentation, role permissions

Download the .p8 private key once and keep it outside this repository. Set:

  • APP_STORE_CONNECT_KEY_ID: the 10-character key ID.
  • APP_STORE_CONNECT_PRIVATE_KEY_PATH: absolute path to the .p8 file.
  • APP_STORE_CONNECT_ISSUER_ID: issuer UUID for a team key. Omit this for an individual key.

The server signs short-lived ES256 JWTs with aud=appstoreconnect-v1; team tokens use iss, individual tokens use sub=user. It refreshes tokens automatically. Apple token specification

The key's role controls what works. App Manager is a practical role for version metadata and publishing; Customer Support covers review response work. TestFlight access depends on the assigned role and app permissions. Verify the least-privilege role against a test app before production use. The server does not print keys, tokens, or raw Apple error bodies.

MCP clients

After publication, the command is npx -y @cntechio-dev/app-store-connect-mcp. Until then, build locally and use node /absolute/path/to/app-store-mcp/dist/index.js in place of that command.

Codex CLI or app

codex mcp add app-store \
  --env APP_STORE_CONNECT_KEY_ID=YOUR_KEY_ID \
  --env APP_STORE_CONNECT_ISSUER_ID=YOUR_ISSUER_UUID \
  --env APP_STORE_CONNECT_PRIVATE_KEY_PATH=/absolute/path/to/AuthKey_YOUR_KEY_ID.p8 \
  -- npx -y @cntechio-dev/app-store-connect-mcp
codex mcp list

For an individual key, omit the issuer environment option. Replace npx -y @cntechio-dev/app-store-connect-mcp with the local node command until publication.

Claude CLI (Claude Code)

claude mcp add \
  --env APP_STORE_CONNECT_KEY_ID=YOUR_KEY_ID \
  --env APP_STORE_CONNECT_ISSUER_ID=YOUR_ISSUER_UUID \
  --env APP_STORE_CONNECT_PRIVATE_KEY_PATH=/absolute/path/to/AuthKey_YOUR_KEY_ID.p8 \
  --transport stdio app-store \
  -- npx -y @cntechio-dev/app-store-connect-mcp
claude mcp get app-store

For an individual key, omit the issuer option. Until publication, replace the npx command with node /absolute/path/to/app-store-mcp/dist/index.js. Claude CLI saves the server for the current project by default; add --scope user before app-store to use it across projects. See Claude Code MCP setup.

Claude Desktop

Add this entry under the existing mcpServers object, keeping any other servers:

{
  "app-store": {
    "command": "npx",
    "args": ["-y", "@cntechio-dev/app-store-connect-mcp"],
    "env": {
      "APP_STORE_CONNECT_KEY_ID": "YOUR_KEY_ID",
      "APP_STORE_CONNECT_ISSUER_ID": "YOUR_ISSUER_UUID",
      "APP_STORE_CONNECT_PRIVATE_KEY_PATH": "/absolute/path/to/AuthKey_YOUR_KEY_ID.p8"
    }
  }
}

For local use, set command to node and args to ["/absolute/path/to/app-store-mcp/dist/index.js"]. For an individual key, remove the issuer field.

License

MIT. See LICENSE.