Skip to main content
Glama
io.github.gjeltep/app-store-connect-mcp

io.github.gjeltep/app-store-connect-mcp

by gjeltep

App Store Connect MCP Server

Test PyPI Python Version MCP Registry

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 httpx client, 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-mcp

From 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-mcp

Or 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-only

Use 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.py

Development

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 domain

Credits

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 tools
analytics_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

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

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

    C2.9/5.0

    Scored across 40 tools

    Disambiguation4/5

    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.

    Naming Consistency3/5

    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.

    Tool Count2/5

    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.

    Completeness2/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers