io.github.gjeltep/app-store-connect-mcp
Provides tools for interacting with App Store Connect, enabling management of app reviews, TestFlight crashes, analytics reports, and Xcode Cloud workflows.
Allows listing configured SCM providers and repositories, and interacting with Bitbucket as a Git provider within Xcode Cloud.
Allows listing configured SCM providers and repositories, and interacting with GitHub as a Git provider within Xcode Cloud.
Allows listing configured SCM providers and repositories, and interacting with GitLab as a Git provider within Xcode Cloud.
Offers tools for Xcode Cloud CI/CD, including managing products, workflows, builds, artifacts, issues, test results, and SCM integration.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@io.github.gjeltep/app-store-connect-mcp list recent customer reviews"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
App Store Connect MCP Server
Talk to App Store Connect about your app. Modular tools, async I/O, and OpenAPI‑driven typing so your agent stays accurate as Apple evolves.
Why this is different
Spec‑aware: Fields and enums are derived from Apple’s OpenAPI spec at runtime, reducing drift and surprise breakage.
Fast by default: Async
httpxclient, server‑side filtering, and smart pagination to keep payloads lean.Smart filtering: Server‑side + client‑side filtering with chainable filter engine for complex queries.
Modular domains: Clean separation of tool schemas and handlers; add new domains without touching the core; optimized LLM discovery/ usage
MCP‑native: Stdio transport, capability declarations, and tool wiring align with the official SDK python‑sdk README.
Installation
From PyPI
pip install app-store-connect-mcpFrom Source
git clone https://github.com/gjeltep/app-store-connect-mcp.git
cd app-store-connect-mcp
uv pip install -e ".[dev]"Configuration
Set these environment variables:
# Required
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"Usage
Run with your environment variables set (recommended):
app-store-connect-mcpOr use a .env file during development:
# Copy and configure .env file
cp .env.example .env
# Edit .env with your credentials
# Run with --env-file flag
app-store-connect-mcp-dev --env-file .env
# Validate configuration without starting server
app-store-connect-mcp-dev --env-file .env --validate-onlyUse with any MCP‑compatible client; the server announces tools and handles calls over stdio.
Generate or update API models
Models are generated from Apple's official OpenAPI spec (fetched automatically from Apple's developer site).
You can override the source with APP_STORE_CONNECT_OPENAPI_URL to point to a local JSON file.
uv pip install -e .[dev]
python scripts/generate_models.pyDevelopment
For development setup, testing, and contribution guidelines, see CONTRIBUTING.md.
Tools
Tools use a resource-first naming convention (resource.verb) with category tags for discoverability.
App Tools
reviews.list: List customer reviews with filters (
rating,territory,appStoreVersion).reviews.search: Advanced search with rating ranges, territory matching, date windows, and content search.
reviews.get: Get detailed review information.
TestFlight Tools
crashes.list: List crash submissions from beta testers with filters (
device_model,os_version,app_platform,device_platform,build_id,tester_id).crashes.search: Advanced search with:
Server‑side filters (
appPlatform,deviceModel,osVersion)Post‑filters: OS ranges (min/max), device model substrings (e.g., "iPhone 15"), and date windows (
created_since_days,created_after,created_before).
crashes.get_by_id: Get detailed information about a specific crash submission.
crashes.get_log: Retrieve the raw crash log text for a specific submission.
Analytics Tools
Requests:
analytics_report_requests.list: List analytics report requests for an app with filters (
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.
Reports:
report_requests.list_reports: List available reports within a request with filters (
name,category).reports.get: Get specific analytics report information.
reports.list_instances: List report instances with filters (
granularity,processing_date).report_instances.get: Get detailed information about a specific report instance.
Segments:
report_instances.list_segments: List data segments for a report instance.
report_segments.get: Get segment download information (checksum, URL, size).
report_instances.download_data: Download analytics report data to a TSV file.
Xcode Cloud Tools
Products & Workflows:
products.list: List all Xcode Cloud products with filters (
product_type).products.get: Get detailed information about a specific product.
workflows.list: List workflows for a product with filters (
is_enabled).workflows.get: Get detailed workflow information (note: create/update/delete operations not supported for safety).
Builds:
builds.list: List builds for a product or workflow with filters (
execution_progress,completion_status,is_pull_request_build).builds.get: Get detailed build information including status, duration, and issue counts.
builds.start: Start a new build for a workflow with optional branch/tag or pull request specification.
Build Artifacts & Results:
artifacts.list: List downloadable artifacts for a build.
issues.list: List issues (errors, warnings) for builds or workflows.
test_results.list: List test results including status, duration, and failure messages.
SCM Integration:
scm_providers.list: List configured SCM providers (GitHub, GitLab, 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.
Architecture
graph TD
%% Entry Point
subgraph "Entry Point"
SERVER[server.py<br/>MCP stdio server]
end
%% Domain Implementations
subgraph "Domain Handlers"
TESTFLIGHT[testflight/handlers.py<br/>TestFlight crash<br/>management]
APP[app/handlers.py<br/>App Store review<br/>management]
ANALYTICS[analytics/handlers.py<br/>Analytics report<br/>management]
XCODE_CLOUD[xcode_cloud/handlers.py<br/>Xcode Cloud CI/CD<br/>management]
end
%% Core Architecture
subgraph "Core Components"
subgraph "Core Framework"
PROTOCOLS[protocols.py<br/>Abstract interfaces]
BASE_HANDLER[base_handler.py<br/>Abstract base class]
QUERY_BUILDER[query_builder.py<br/>Fluent query construction]
FILTERS[filters.py<br/>Chainable filter engine]
RESPONSE_HANDLER[response_handler.py<br/>API response processing]
CONTAINER[container.py<br/>Dependency injection]
ERRORS[errors.py<br/>Structured error handling]
end
subgraph "API Layer"
ASC_CLIENT[app_store_connect.py<br/>App Store Connect client<br/>with JWT auth]
HTTP_CLIENT[http_client.py<br/>Base HTTP client]
MODELS[app_store_connect_models.py<br/>Auto-generated Pydantic<br/>models from OpenAPI spec]
end
subgraph "Data & Tools"
OPENAPI[app_store_connect_api_openapi.json<br/>Apple's OpenAPI spec]
GENERATE_SCRIPT[scripts/generate_models.py<br/>Model generation script]
end
end
%% Vertical Stack Relationships
SERVER -->|"routes to"| ANALYTICS
ANALYTICS -->|"uses"| ASC_CLIENT
%% Styling
classDef entry fill:#f3e5f5,stroke:#4a148c,stroke-width:2px
classDef core fill:#fff3e0,stroke:#e65100,stroke-width:2px
classDef domain fill:#fce4ec,stroke:#880e4f,stroke-width:2px
class SERVER entry
class PROTOCOLS,BASE_HANDLER,QUERY_BUILDER,FILTERS,RESPONSE_HANDLER,CONTAINER,ERRORS,ASC_CLIENT,HTTP_CLIENT,MODELS,OPENAPI,GENERATE_SCRIPT core
class TESTFLIGHT,APP,ANALYTICS,XCODE_CLOUD domainCredits
Built on the official Model Context Protocol Python SDK — see the docs and examples in the python‑sdk README.
See CONTRIBUTING.md if you'd like to help.
Available Tools
40 toolsanalytics_report_requests_listB
[Analytics/Requests] List analytics report requests for an app.
Default limit is 50 to prevent response size issues. Increase limit up to 200 for more results.
Inputs: limit, app_id, include, access_type. Returns: object
artifacts_listB
[XcodeCloud/BuildArtifacts] List artifacts for a build.
Inputs: build_id (required), limit. Returns: object
builds_getA
[XcodeCloud/Builds] Get detailed information about a specific build.
Inputs: build_id (required), include. Returns: object
builds_listB
[XcodeCloud/Builds] List builds for a product or workflow. Requires either product_id or workflow_id.
Inputs: sort, limit, filters, include, +2 more. Returns: object
builds_startA
[XcodeCloud/Builds] Start a new build using a branch or tag name.
The branch/tag name is resolved to a Git reference ID via the API.
For direct ID usage without resolution, use builds_start_by_ref_id.
Inputs: workflow_id (required), pull_request_number, source_branch_or_tag. Returns: object
builds_start_by_ref_idA
[XcodeCloud/Builds] Start a new build using a Git reference ID directly.
Use this when you already have the Git reference UUID to skip resolution.
For branch/tag names, use builds_start instead.
Inputs: workflow_id (required), source_ref_id, pull_request_number. Returns: object
crashes_get_by_idC
[TestFlight] Get detailed information about a specific crash submission.
Inputs: submission_id (required), include. Returns: object
crashes_get_logB
[TestFlight] Get the raw crash log text for a specific crash submission.
Inputs: submission_id (required). Returns: object
crashes_listA
[TestFlight] List crash submissions from beta testers.
Default limit is 25 due to large response size. Max 200. Use pagination metadata for additional pages.
Inputs: sort, limit, app_id, filters, +1 more. Returns: object
crashes_searchC
[TestFlight] Search crash submissions with advanced filtering.
Default limit is 25 due to large response size. Max 200. Use pagination metadata for additional pages.
Inputs: sort, limit, app_id, include, +10 more. Returns: object
git_references_listB
[XcodeCloud/SCM] List Git references (branches/tags) for a repository.
Inputs: repository_id (required), limit, include. Returns: object
issues_listC
[XcodeCloud/BuildArtifacts] List issues for a build.
Inputs: build_id (required), limit. Returns: object
products_getB
[XcodeCloud/Products] Get detailed information about a specific Xcode Cloud product.
Inputs: product_id (required), include. Returns: object
products_listC
[XcodeCloud/Products] List all Xcode Cloud products.
Inputs: limit, filters, include. Returns: object
pull_requests_listB
[XcodeCloud/SCM] List pull requests for a repository.
Inputs: repository_id (required), limit, include. Returns: object
report_instances_download_dataA
[Analytics/Data] Download analytics report data to a TSV file.
This tool fetches all segments for a report instance and saves the data to a TSV file.
The file can then be analyzed using other tools.
Args:
instance_id: The analytics report instance ID
output_path: Optional path for the output file. If not provided, saves to temp directory
Returns:
Dict containing:
- status: "success", "no_data", or "error"
- file_path: Path to the downloaded TSV file
- file_size_mb: File size in megabytes
- segment_count: Number of segments downloaded
- row_count: Number of data rows (excluding header)
- message: Error message if status is "error" or "no_data"
Inputs: instance_id (required), output_path. Returns: object
report_instances_getC
[Analytics/Reports] Get detailed information about a specific analytics report instance.
Inputs: instance_id (required), include. Returns: object
report_instances_list_segmentsB
[Analytics/Segments] List segments for a specific analytics report instance.
Default limit is 100 (lightweight data). Max 200. Use pagination metadata for additional pages.
Inputs: instance_id (required), limit, include. Returns: object
report_requests_createC
[Analytics/Requests] Create a new analytics report request.
Inputs: request_data (required). Returns: object
report_requests_getB
[Analytics/Requests] Get detailed information about a specific analytics report request.
Inputs: request_id (required), include. Returns: object
report_requests_list_reportsA
[Analytics/Reports] List reports for a specific analytics report request.
Default limit is 50 to prevent response size issues. Increase limit up to 200 for more results.
Inputs: request_id (required), name, limit, include, +1 more. Returns: object
report_segments_getA
[Analytics/Segments] Get detailed information about a specific analytics report segment.
Inputs: segment_id (required), include. Returns: object
reports_getC
[Analytics/Reports] Get detailed information about a specific analytics report.
Inputs: report_id (required), include. Returns: object
reports_list_instancesA
[Analytics/Reports] List instances for a specific analytics report.
Default limit is 100 (lightweight data). Max 200. Use pagination metadata for additional pages.
Inputs: report_id (required), limit, include, granularity, +1 more. Returns: object
repositories_listB
[XcodeCloud/SCM] List Git repositories for an SCM provider.
Inputs: scm_provider_id (required), limit, include. Returns: object
reviews_getC
[App] Get detailed information about a specific customer review.
Inputs: review_id (required), include. Returns: object
reviews_listC
[App] List customer reviews for an app.
Inputs: sort, limit, app_id, filters, +1 more. Returns: object
reviews_searchC
[App] Search customer reviews with advanced filtering.
Inputs: sort, limit, app_id, rating, +10 more. Returns: object
scm_providers_listB
[XcodeCloud/SCM] List SCM providers configured for Xcode Cloud.
Inputs: limit. Returns: object
test_results_listB
[XcodeCloud/BuildArtifacts] List test results for a build.
Inputs: build_id (required), limit. Returns: object
user_invitations_createA
[Users/Invitations] Create a new user invitation.
Args:
invitation_data: Dictionary containing the invitation details
include: Optional list of related resources to include
visible_apps_limit: Optional limit for visibleApps (1-50)
Returns:
Created user invitation information (expires in ~3 days)
Inputs: invitation_data (required), include, visible_apps_limit. Returns: object
user_invitations_deleteA
[Users/Invitations] Cancel/delete a user invitation.
Args:
invitation_id: The ID of the invitation to cancel
Returns:
Confirmation of cancellation
Inputs: invitation_id (required). Returns: object
user_invitations_getB
[Users/Invitations] Get detailed information about a specific user invitation.
Inputs: invitation_id (required), include, visible_apps_limit. Returns: object
user_invitations_listA
[Users/Invitations] List all user invitations.
Default limit is 50. Max 200. Use pagination metadata for additional pages.
Supported sort: email, -email, lastName, -lastName
Inputs: sort, limit, filters, include, +1 more. Returns: object
users_deleteB
[Users/Management] Remove a user account.
Args:
user_id: The ID of the user to delete
Returns:
Confirmation of deletion
Inputs: user_id (required). Returns: object
users_getB
[Users/Management] Get detailed information about a specific user.
Inputs: user_id (required), include. Returns: object
users_listA
[Users/Management] List all users in the organization.
Default limit is 50. Max 200. Use pagination metadata for additional pages.
Inputs: sort, limit, filters, include. Returns: object
users_modifyB
[Users/Management] Modify a user account.
Args:
user_id: The ID of the user to modify
user_data: Dictionary containing the fields to update
include: Optional list of related resources to include
Returns:
Updated user information
Inputs: user_id (required), user_data (required), include. Returns: object
workflows_getA
[XcodeCloud/Workflows] Get detailed information about a specific workflow. Note: Create/update/delete operations are not supported for safety.
Inputs: workflow_id (required), include. Returns: object
workflows_listA
[XcodeCloud/Workflows] List workflows for an Xcode Cloud product. Note: Create/update/delete operations are not supported for safety.
Inputs: product_id (required), limit, filters, include. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 40 tools
Each tool targets a distinct resource and action within its category. The analytics tools follow a clear hierarchy (requests -> reports -> instances -> segments) that is discernible from descriptions, though the naming could be clearer. No two tools appear to do exactly the same thing.
Most tools follow a resource_action pattern, but analytics tools mix conventions: e.g., 'reports_list_instances' vs 'analytics_report_requests_list' vs 'report_requests_get'. Nested list tools use a different word order than top-level lists, and 'builds_start_by_ref_id' is an outlier. Still, names are generally readable and predictable within categories.
40 tools is well above the 25+ threshold for heavy tool sets. While they cover a broad API, many are simple list/get variations, and an agent would be overwhelmed. Some consolidation (e.g., combining list and search, or using parameters for different resource hierarchies) could reduce the count.
The server covers analytics, reviews, crash reports, user management, and Xcode Cloud, but omits major App Store Connect areas like app metadata, TestFlight builds/beta groups, certificates, devices, and in-app purchases. Within included domains, coverage is fairly thorough, but the overall surface is incomplete for a server claiming to be an App Store Connect MCP.
Maintenance
Related MCP Connectors
App Store Connect operator for AI agents: icons, TestFlight builds, listings, IAP, rejection fixes.
Run App Store Connect from your IDE: pricing, listings, screenshots, releases, AI visibility.
Lets AI agents analyze API metrics, request logs, and traces, and manage apps and alerts.
Ship a new iOS app from chat. AI runs App Store Connect, builds, release, and submission through Ap…
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables interaction with Apple's App Store Connect API through natural language to manage apps, beta testing, localizations, analytics, sales reports, and CI/CD workflows for iOS and macOS development.31115 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to manage Apple App Store Connect through the official API, including apps, metadata, reviews, TestFlight, provisioning, users, and reports.MIT
- AlicenseNot gradedqualityDmaintenanceEnables management of App Store Connect apps including registration, listing, IPA upload, store listing updates, and in-app purchase creation via natural language.MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to manage Apple App Store Connect resources like apps, builds, TestFlight, and reviews through natural language.2014 npmMIT