App Store Connect

You can run the App Store Connect MCP Server to interact with App Store Connect through modular, OpenAPI‑driven tools. This server stays up to date with Apple’s specs, supports async I/O, and filters data efficiently to help your agent work accurately as Apple evolves.

How to use

You run the MCP server locally and connect to it with any MCP‑compatible client. Start the server with your App Store Connect credentials set in the environment, then dispatch tool calls through the client. The server announces available tools and handles calls over the MCP stdio transport.

How to install

Prerequisites you need before installing and running the server include Python and a compatible runtime for the chosen installation method.

# Install from PyPI
pip install app-store-connect-mcp

# Or install from source
git clone https://github.com/gjeltep/app-store-connect-mcp.git
cd app-store-connect-mcp
uv pip install -e ".[dev]"

Configuration and run notes

Set the required environment variables before starting the server. These keys authenticate you to App Store Connect and identify your app where applicable.

export APP_STORE_KEY_ID="YOUR_KEY_ID"
export APP_STORE_ISSUER_ID="YOUR_ISSUER_ID"
export APP_STORE_PRIVATE_KEY_PATH="/path/to/AuthKey_XXXXX.p8"

# Optional
export APP_STORE_APP_ID="YOUR_APP_ID"
export APP_STORE_KEY_TYPE="team"  # or "individual"

Start the MCP server

Run the MCP server with your credentials loaded in the environment. The standard startup command uses the server’s executable name.

app-store-connect-mcp

Development and validation helpers

During development you can validate your configuration or run with a local environment file.

# Copy and configure a local environment file if you maintain one
cp .env.example .env
# Edit .env with your credentials

# Run with an explicit env file
app-store-connect-mcp-dev --env-file .env

# Validate configuration without starting the server
app-store-connect-mcp-dev --env-file .env --validate-only

Available tools

reviews.list

List customer reviews with optional filters like rating, territory, and appStoreVersion.

reviews.search

Advanced search for reviews with rating ranges, territory matching, date windows, and content search.

reviews.get

Get detailed information about a specific review.

crashes.list

List crash submissions from beta testers with filters such as deviceModel, osVersion, appPlatform, and build_id.

crashes.search

Advanced crash search with server-side filters and post-filters for OS ranges, device substrings, and dates.

crashes.get_by_id

Get detailed information about a specific crash submission.

crashes.get_log

Retrieve the raw crash log text for a submission.

analytics_report_requests.list

List analytics report requests for an app with filters like access_type.

report_requests.create

Create new analytics report requests for specific metrics and timeframes.

report_requests.get

Get detailed information about a specific analytics report request.

report_requests.list_reports

List available reports within a request with filters like name and category.

reports.get

Get specific analytics report information.

reports.list_instances

List report instances with filters like granularity and processing_date.

report_instances.get

Get detailed information about a specific report instance.

report_instances.list_segments

List data segments for a report instance.

report_segments.get

Get segment download information including checksum, URL, and size.

report_instances.download_data

Download analytics report data to a TSV file.

products.list

List all Xcode Cloud products with filters like product_type.

products.get

Get detailed information about a specific product.

workflows.list

List workflows for a product with filters like is_enabled.

workflows.get

Get detailed workflow information.

builds.list

List builds for a product or workflow with filters like execution_progress and completion_status.

builds.get

Get detailed build information including status and duration.

builds.start

Start a new build for a workflow with optional branch, tag, or pull request specification.

artifacts.list

List downloadable artifacts for a build.

issues.list

List issues (errors, warnings) for builds or workflows.

test_results.list

List test results with status, duration, and failure messages.

scm_providers.list

List configured SCM providers like GitHub, GitLab, or Bitbucket.

repositories.list

List Git repositories for an SCM provider.

pull_requests.list

List pull requests for a repository.

git_references.list

List branches and tags for a repository.