io.github.beautyfree/app-store-connect MCP Server

<p align="center"> <img width="20%" src=".github/assets/logo.webp" alt="mcp-appstore-connect" /> </p> <p align="center"> <h1 align="center">App Store Connect MCP</h1> </p> <p align="center"> App Store Connect in your AI agent. MCP server for the official App Store Connect API. </p> <div align="center">

</div>

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 instead of clicking through the App Store Connect UI.

Use it to: list and inspect apps, builds, and beta groups · manage TestFlight testers and review submissions · create and update subscription groups and prices · edit App Store version localizations and "What's New" · download sales and finance reports · list Xcode schemes and CI products. All with JWT auth and the same API Apple's own tools use.

Install

Cursor (install link):

Other clients (Claude Desktop, etc.):

npx add-mcp mcp-asc

Configure

Add the server to your MCP config and set these environment variables:

Variable	Required	Description
APP_STORE_CONNECT_KEY_ID	Yes	API Key ID from App Store Connect
APP_STORE_CONNECT_ISSUER_ID	Yes	Issuer ID from App Store Connect
APP_STORE_CONNECT_P8_PATH	Yes	Path to your .p8 private key file
APP_STORE_CONNECT_VENDOR_NUMBER	For reports	Needed for sales/finance reports

Create an API key at App Store Connect → Users and Access → Integrations → App Store Connect API. Download the .p8 and note Key ID and Issuer ID.

Example (stdio):

{
  "mcpServers": {
    "app-store-connect": {
      "command": "npx",
      "args": ["-y", "mcp-asc"],
      "env": {
        "APP_STORE_CONNECT_KEY_ID": "YOUR_KEY_ID",
        "APP_STORE_CONNECT_ISSUER_ID": "YOUR_ISSUER_ID",
        "APP_STORE_CONNECT_P8_PATH": "/path/to/AuthKey_XXXXX.p8",
        "APP_STORE_CONNECT_VENDOR_NUMBER": "YOUR_VENDOR_NUMBER_OPTIONAL"
      }
    }
  }
}

Example (HTTP SSE): Run npm run build then npm run start:http. Point your client at http://localhost:3001/mcp with the same env vars.

Tools

Tools are exposed in kebab-case. Use your MCP client to list them and see parameters. Summary by area:

Apps & metadata

• list-apps, get-app, list-app-infos, get-app-info, get-app-availability
• list-app-store-versions, get-app-store-version, create-app-store-version, update-app-store-version
• list-app-store-version-localizations, list-app-categories, list-app-encryption-declarations, list-nominations

TestFlight / Beta

• list-beta-groups, get-beta-group, list-beta-testers, get-beta-tester, add-beta-testers-to-group, remove-beta-testers-from-group
• list-builds, get-build, list-build-beta-details, list-pre-release-versions, get-pre-release-version
• list-beta-app-localizations, list-beta-app-review-details, list-beta-app-review-submissions, list-beta-license-agreements, get-beta-license-agreement, update-beta-license-agreement

Subscriptions

• list-subscription-groups, list-subscription-group-subscriptions, get-subscription, create-subscription-group, create-subscription
• create-subscription-availability, list-subscription-price-points, create-subscription-price, create-subscription-localization

Store & review

• list-review-submissions, get-review-submission, submit-for-review, list-customer-reviews, create-customer-review-response
• get-app-store-review-detail, update-app-store-review-detail

Other

• list-bundle-ids, get-bundle-id · list-certificates, get-certificate · list-profiles · list-devices, get-device
• list-users, get-user, list-user-invitations · list-territories · list-actors, get-actor
• get-eula, update-eula · get-phased-release, create-phased-release · update-age-rating-declaration
• list-schemes (Xcode), list-ci-products (Xcode Cloud)
• download-sales-report, download-finance-report (require APP_STORE_CONNECT_VENDOR_NUMBER)

Development

Built with xmcp. One tool per file under src/tools/; each file exports metadata and a default handler.

npm install
npm run build
npm run start:stdio   # or npm run start:http for HTTP transport
npm run dev            # watch + run

Node 20+.

Open Plugins

This repository now includes Open Plugins-compatible metadata and layout:

• .plugin/plugin.json for plugin metadata
• .mcp.json for MCP server wiring
• skills/app-store-connect/SKILL.md for installable skill context

Open Plugins standard: open-plugins.com

You can test locally by loading the plugin directory in a compatible host, for example:

claude --plugin-dir .

Listing in MCP catalogs

To add this server to the official MCP Registry, Cursor MCP Directory, cursor.store, and other catalogs, see docs/REGISTRY.md.

License

MIT.

Links

• Model Context Protocol
• App Store Connect API
• xmcp