English Français العربية

io.github.beautyfree/app-store-connect

Official registry Security

App Store Connect API as MCP: apps, TestFlight, subscriptions, localizations, reports. JWT auth.

Source code Documentation

What can you do with io.github.beautyfree/app-store-connect?

  • 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
  • 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
  • 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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package mcp-asc
Claude Code 
claude mcp add app-store-connect -e 'APP_STORE_CONNECT_KEY_ID=<your app_store_connect_key_id>' -e 'APP_STORE_CONNECT_ISSUER_ID=<your app_store_connect_issuer_id>' -e 'APP_STORE_CONNECT_P8_PATH=<your app_store_connect_p8_path>' -e 'APP_STORE_CONNECT_VENDOR_NUMBER=<APP_STORE_CONNECT_VENDOR_NUMBER>' -- npx -y mcp-asc@2.0.4
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "app-store-connect": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-asc@2.0.4"
            ],
            "env": {
                "APP_STORE_CONNECT_KEY_ID": "<your app_store_connect_key_id>",
                "APP_STORE_CONNECT_ISSUER_ID": "<your app_store_connect_issuer_id>",
                "APP_STORE_CONNECT_P8_PATH": "<your app_store_connect_p8_path>",
                "APP_STORE_CONNECT_VENDOR_NUMBER": "<APP_STORE_CONNECT_VENDOR_NUMBER>"
            }
        }
    }
}

Environment variables

  • APP_STORE_CONNECT_KEY_ID required secret API Key ID from App Store Connect (Users and Access → Integrations → App Store Connect API)
  • APP_STORE_CONNECT_ISSUER_ID required secret Issuer ID from App Store Connect
  • APP_STORE_CONNECT_P8_PATH required secret Path to your .p8 private key file (downloaded from App Store Connect)
  • APP_STORE_CONNECT_VENDOR_NUMBER Vendor number; required for sales and finance reports only

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. App Store Connect MCP
  2. Install
  3. Configure
  4. Tools
  5. Development
  6. Open Plugins
  7. Listing in MCP catalogs
  8. License
  9. Links

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

npx add-mcp mcp-asc

Configure

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

VariableRequiredDescription
APP_STORE_CONNECT_KEY_IDYesAPI Key ID from App Store Connect
APP_STORE_CONNECT_ISSUER_IDYesIssuer ID from App Store Connect
APP_STORE_CONNECT_P8_PATHYesPath to your .p8 private key file
APP_STORE_CONNECT_VENDOR_NUMBERFor reportsNeeded 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.

Frequently asked questions

What is io.github.beautyfree/app-store-connect?

App Store Connect API as MCP: apps, TestFlight, subscriptions, localizations, reports. JWT auth.

How do I install io.github.beautyfree/app-store-connect?

It runs on your machine. In Claude Code: claude mcp add app-store-connect -e 'APP_STORE_CONNECT_KEY_ID=<your app_store_connect_key_id>' -e 'APP_STORE_CONNECT_ISSUER_ID=<your app_store_connect_issuer_id>' -e 'APP_STORE_CONNECT_P8_PATH=<your app_store_connect_p8_path>' -e 'APP_STORE_CONNECT_VENDOR_NUMBER=<APP_STORE_CONNECT_VENDOR_NUMBER>' -- npx -y mcp-asc@2.0.4. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.beautyfree/app-store-connect need an API key?

Yes. It expects APP_STORE_CONNECT_KEY_ID, APP_STORE_CONNECT_ISSUER_ID, APP_STORE_CONNECT_P8_PATH, which you set in its configuration.

Is io.github.beautyfree/app-store-connect open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.beautyfree/app-store-connect?

It is published by beautyfree. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.