App Store Connect MCP (io.github.beautyfree/app-store-connect)

The App Store Connect MCP server exposes the official App Store Connect API to a Model Context Protocol (MCP) client. It provides access to apps, TestFlight, subscriptions, localizations, and reports, with JWT authentication for API requests.

🛠️ Key Features

Integrates with the official App Store Connect API
JWT auth
Supports: apps, TestFlight, subscriptions, localizations, reports

🚀 Use Cases

Query app metadata from an AI agent
Manage or inspect TestFlight-related data
Retrieve subscription and localization information
Access reporting data via MCP

⚡ Developer Benefits

MCP-compatible interface for App Store Connect
Typed, API-driven access to common App Store Connect domains (apps, TestFlight, subscriptions, localizations, reports)
Uses JWT authentication

⚠️ Limitations

The provided description does not specify available MCP tools, scopes, rate limits, or supported API operations beyond the named domains.

mcp-appstore-connect

App Store Connect MCP

App Store Connect in your AI agent. MCP server for the official App Store Connect API.

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.):

bash

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):

json

{
  "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.

bash

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:

bash

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.

io.github.beautyfree/app-store-connect