README.md
A Model Context Protocol server for the App Store Connect API.
App Store Connect MCP Server
A Model Context Protocol server for the App Store Connect API.
Manage apps, builds, TestFlight, reviews, and more — directly from Claude.
Works with:
Overview
asc-mcp is a Swift-based MCP server that bridges Claude (or any MCP-compatible host) with the App Store Connect API. It exposes 208 tools across 25 workers, enabling you to automate your entire iOS/macOS release workflow through natural language.
Key capabilities
- Multi-account — manage multiple App Store Connect teams from a single server
- Full release pipeline — create versions, attach builds, submit for review, phased rollout
- TestFlight automation — beta groups, testers, build distribution, localized What's New
- Build management — track processing, encryption compliance, readiness checks
- Customer reviews — list, respond, update, delete responses, aggregate statistics
- In-app purchases — CRUD for IAPs, localizations, price points, review screenshots
- Subscriptions — subscription CRUD, groups, localizations, prices, offer codes, win-back offers
- Provisioning — bundle IDs, devices, certificates, profiles, capabilities
- Marketing — screenshots, app previews, custom product pages, A/B testing (PPO), promoted purchases
- Analytics & Metrics — sales/financial reports, analytics reports, performance metrics, diagnostics
- Metadata management — localized descriptions, keywords, What's New across all locales
Quick Start
# 1. Install via Mint
brew install mint
mint install zelentsov-dev/asc-mcp@1.4.0
# 2. Add to Claude Code with env vars (simplest setup)
claude mcp add asc-mcp \
-e ASC_KEY_ID=XXXXXXXXXX \
-e ASC_ISSUER_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx \
-e ASC_PRIVATE_KEY_PATH=/path/to/AuthKey.p8 \
-- ~/.mint/bin/asc-mcp
Or use a JSON config file — see Configuration below.
Prerequisites
| Requirement | Version |
|---|---|
| macOS | 14.0+ (Sonoma) |
| Swift | 6.2+ |
| Xcode | 16.0+ (for building) |
| App Store Connect API Key | Create one here |
Installation
Option A: Mint (recommended)
Mint is the simplest way to install — one command, no manual cloning.
# Install Mint (if you don't have it)
brew install mint
# Install asc-mcp from GitHub
mint install zelentsov-dev/asc-mcp@1.4.0
# Register in Claude Code
claude mcp add asc-mcp -- ~/.mint/bin/asc-mcp
To install a specific branch or tag:
mint install zelentsov-dev/asc-mcp@main # main branch
mint install zelentsov-dev/asc-mcp@develop # develop branch
mint install zelentsov-dev/asc-mcp@1.4.0 # specific tag
To update to the latest version:
mint install zelentsov-dev/asc-mcp@1.4.0 --force
Option B: Build from Source
git clone https://git
Tools (4)
manage_appsPerform CRUD operations on App Store Connect apps.manage_buildsManage build processing, encryption compliance, and readiness checks.manage_testflightHandle beta groups, testers, and build distribution.manage_reviewsList, respond to, and manage customer reviews.Environment Variables
ASC_KEY_IDrequiredThe Key ID for your App Store Connect API key.ASC_ISSUER_IDrequiredThe Issuer ID for your App Store Connect API key.ASC_PRIVATE_KEY_PATHrequiredThe local file path to your .p8 private key file.Configuration
claude_desktop_config.json
{"mcpServers": {"asc-mcp": {"command": "/path/to/mint/bin/asc-mcp", "env": {"ASC_KEY_ID": "your_key_id", "ASC_ISSUER_ID": "your_issuer_id", "ASC_PRIVATE_KEY_PATH": "/path/to/AuthKey.p8"}}}}Try it
→List all my apps currently in the App Store and their current status.
→Check if there are any new customer reviews for my app and draft a polite response for the latest one.
→Add a new tester with email test@example.com to the internal beta group for my latest build.
→Get the latest sales and financial report for the last month.
→Submit the latest build for review and set the release type to manual.