convez.ai
MCP ServerIntegração & APIsAvançado
zelentsov-dev

App Store Connect MCP Server

zelentsov-dev/asc-mcp

Automatize toda a pipeline de lançamento iOS/macOS pelo Claude com 389 ferramentas

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP em Swift que conecta Claude e outras ferramentas IA com a API do App Store Connect, expondo 389 ferramentas para automação completa da pipeline de lançamento iOS/macOS. Gerencia apps, builds, TestFlight, reviews, subscrições, IAPs e mais através de linguagem natural.

Instalação

$npx convez-ai zelentsov-dev/asc-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
91
Forks
17
Acompanhando
1
Saúde
100%
Último commit
há 1 semana
Versão
v4.3.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automação de submissão e gerenciamento de builds no App Store
  • Gerenciamento de TestFlight e distribuição de betas
  • Automação de criação de versões, IAPs e subscrições
  • Monitoramento e resposta a reviews de clientes
  • Configuração de marketing, screenshots e A/B testing

Veredito

Ferramenta robusta e bem-estruturada para quem trabalha com ecossistema Apple e precisa automatizar pipelines complexas de lançamento. Requer conhecimento técnico de App Store Connect e MCP, mas oferece cobertura abrangente com 389 endpoints documentados.

README

A tradução para o português deste README ainda está na fila.


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 389 tools across 30 App Store tool domains + 2 core domains, 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, availability, offer codes, win-back, intro, and promotional offers
  • Provisioning — bundle IDs, devices, certificates, profiles, capabilities
  • Marketing — screenshots, app previews, custom product pages, A/B testing (PPO), promoted purchases
  • Accessibility declarations — manage App Store accessibility support declarations by device family
  • Webhooks — manage webhook configurations, inspect delivery diagnostics, verify signatures, parse payloads, and triage events
  • Analytics & Metrics — sales/financial reports, analytics reports, performance metrics, diagnostics
  • Metadata management — localized descriptions, keywords, What's New across all locales
  • MCP 2025-11-25 surface — tool annotations, output schemas for stable tools, structured JSON results, and safe result-size metadata
  • OpenAPI drift tooling — generate coverage reports from Apple's official App Store Connect OpenAPI specification

Quick Start

# 1. Install via Mint
brew install mint
mint install zelentsov-dev/asc-mcp@v3.0.2

# 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

RequirementVersion
macOS14.0+ (Sonoma)
Swift6.2+
Xcode26.0+ or a Swift 6.2 toolchain
App Store Connect API KeyCreate 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@v3.0.2

# 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@v3.0.2     # specific tag

To update to the latest version:

mint install zelentsov-dev/asc-mcp@v3.0.2 --force

Option B: Build from Source

git clone https://github.com/zelentsov-dev/asc-mcp.git
cd asc-mcp
swift build -c release

# Register in Claude Code
claude mcp add asc-mcp -- $(pwd)/.build/release/asc-mcp

[!TIP] For convenience, copy the binary to a location in your PATH:

cp .build/release/asc-mcp /usr/local/bin/asc-mcp

Configuration

1. App Store Connect API Key

  1. Go to App Store Connect → Users and Access → Integrations → Team Keys
  2. Click Generate API Key — select appropriate role (Admin or App Manager recommended)
  3. Download the .p8 private key file (you can only download it once!)
  4. Note the Key ID and Issuer ID

2. Companies Configuration

asc-mcp supports three configuration methods (checked in this order):

Option A: Environment Variables (recommended for MCP clients)

Single company — simplest setup:

export ASC_KEY_ID=XXXXXXXXXX
export ASC_ISSUER_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
export ASC_PRIVATE_KEY_PATH=/path/to/AuthKey.p8
# or pass the key content directly:
# export ASC_PRIVATE_KEY="-----BEGIN PRIVATE KEY-----\nMIGT..."
# optional:
# export ASC_COMPANY_NAME="My Company"
# export ASC_VENDOR_NUMBER=YOUR_VENDOR_NUMBER          # for analytics

Multiple companies — numbered variables:

export ASC_COMPANY_1_NAME="My Company"
export ASC_COMPANY_1_KEY_ID=XXXXXXXXXX
export ASC_COMPANY_1_ISSUER_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
export ASC_COMPANY_1_KEY_PATH=/path/to/AuthKey1.p8
export ASC_COMPANY_1_VENDOR_NUMBER=YOUR_VENDOR_NUMBER   # optional, for analytics

export ASC_COMPANY_2_NAME="Client Corp"
export ASC_COMPANY_2_KEY_ID=YYYYYYYYYY
export ASC_COMPANY_2_ISSUER_ID=yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy
export ASC_COMPANY_2_KEY_PATH=/path/to/AuthKey2.p8

Numbering starts at 1. The server scans while ASC_COMPANY_{N}_KEY_ID exists.

Option B: JSON Config File

Create ~/.config/asc-mcp/companies.json:

{
  "companies": [
    {
      "id": "my-company",
      "name": "My Company",
      "key_id": "XXXXXXXXXX",
      "issuer_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "key_path": "/Users/you/.keys/AuthKey_XXXXXXXXXX.p8",
      "vendor_number": "YOUR_VENDOR_NUMBER"
    },
    {
      "id": "client-company",
      "name": "Client Corp",
      "key_id": "YYYYYYYYYY",
      "issuer_id": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy",
      "key_path": "/Users/you/.keys/AuthKey_YYYYYYYYYY.p8",
      "vendor_number": "YOUR_VENDOR_NUMBER"
    }
  ]
}

Note: vendor_number is required for analytics tools (analytics_sales_report, analytics_financial_report, analytics_app_summary). Find it in App Store Connect → Sales and Trends → Reports.

Configuration Priority

The server resolves configuration in this order:

  1. --companies /path/to/companies.json (CLI argument)
  2. Constructor parameter (programmatic)
  3. ASC_MCP_COMPANIES=/path/to/companies.json (env var pointing to JSON file)
  4. Default JSON file paths (~/.config/asc-mcp/companies.json, etc.)
  5. ASC_COMPANY_1_KEY_ID ... (multi-company env vars)
  6. ASC_KEY_ID + ASC_ISSUER_ID (single-company env vars)

3. MCP Host Configuration

claude mcp add asc-mcp -- ~/.mint/bin/asc-mcp

Or add to .mcp.json (project) / .claude/settings.json (global) with env vars:

{
  "mcpServers": {
    "asc-mcp": {
      "command": "/path/to/asc-mcp",
      "env": {
        "ASC_KEY_ID": "XXXXXXXXXX",
        "ASC_ISSUER_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "ASC_PRIVATE_KEY_PATH": "/path/to/AuthKey.p8"
      }
    }
  }
}

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "asc-mcp": {
      "command": "/path/to/asc-mcp",
      "env": {
        "ASC_KEY_ID": "XXXXXXXXXX",
        "ASC_ISSUER_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "ASC_PRIVATE_KEY_PATH": "/path/to/AuthKey.p8"
      }
    }
  }
}

Add to ~/.codex/config.toml:

[mcp_servers.asc-mcp]
command = "/path/to/asc-mcp"
startup_timeout_sec = 20
tool_timeout_sec = 60
enabled = true

Set env vars in your shell or use a wrapper script.

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "asc-mcp": {
      "command": "/path/to/asc-mcp",
      "timeout": 60000,
      "env": {
        "ASC_KEY_ID": "XXXXXXXXXX",
        "ASC_ISSUER_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "ASC_PRIVATE_KEY_PATH": "/path/to/AuthKey.p8"
      }
    }
  }
}

Add to .vscode/mcp.json:

{
  "servers": {
    "asc-mcp": {
      "command": "/path/to/asc-mcp",
      "env": {
        "ASC_KEY_ID": "XXXXXXXXXX",
        "ASC_ISSUER_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "ASC_PRIVATE_KEY_PATH": "/path/to/AuthKey.p8"
      }
    }
  }
}

Add to Cursor settings → MCP Servers:

{
  "mcpServers": {
    "asc-mcp": {
      "command": "/path/to/asc-mcp",
      "env": {
        "ASC_KEY_ID": "XXXXXXXXXX",
        "ASC_ISSUER_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "ASC_PRIVATE_KEY_PATH": "/path/to/AuthKey.p8"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "asc-mcp": {
      "command": "/path/to/asc-mcp",
      "args": ["--workers", "apps,builds,versions,reviews,beta_groups,iap"],
      "env": {
        "ASC_KEY_ID": "XXXXXXXXXX",
        "ASC_ISSUER_ID": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "ASC_PRIVATE_KEY_PATH": "/path/to/AuthKey.p8"
      }
    }
  }
}

Note: Windsurf has a 100-tool limit. The server exposes 389 tools by default, so you must use --workers to select a subset. See Worker Filtering below.

[!IMPORTANT] If the MCP host doesn't inherit your shell PATH, you may need to specify the full path to the binary and ensure .p8 key paths are absolute.

Worker Filtering

The server exposes 389 tools across 30 App Store tool domains + 2 core domains. Some MCP clients impose a tool limit (e.g., Windsurf caps at 100). Use the 32 --workers filter keys to enable only the workers you need:

# Only load apps, builds, and version lifecycle tools
asc-mcp --workers apps,builds,versions

# Full release + App Store compliance subset (~96 tools, fits within 100-tool clients)
asc-mcp --workers apps,accessibility,builds,versions,reviews,beta_groups,iap

# Monetization focus
asc-mcp --workers apps,iap,subscriptions,pricing,promoted

company and auth workers are always enabled regardless of the filter (they provide core multi-account and authentication functionality).

When builds is enabled, it automatically includes build_processing and build_beta sub-workers.

Read-Only Mode

Use --read-only when you want safe inspection without App Store Connect mutations:

asc-mcp --read-only
asc-mcp --read-only --workers apps,builds,reviews,analytics

In this mode, read tools such as *_list, *_get, *_search, *_status, *_verify, *_parse, *_triage, auth_*, analytics, and metrics remain available. Tools that can create, update, upload, submit, release, delete, revoke, clear, cancel, or otherwise mutate App Store Connect are blocked before their worker handler runs. company_switch remains available because it changes only the local active company context.

OpenAPI Drift Tooling

Use the built-in OpenAPI coverage command to compare the maintained asc-mcp coverage map with Apple's latest App Store Connect OpenAPI specification. This command does not load App Store Connect credentials, does not start the MCP server, and does not call Apple APIs beyond your explicit spec download.

rm -rf /tmp/asc-openapi
mkdir -p /tmp/asc-openapi
curl -L --fail -o /tmp/asc-openapi/spec.zip \
  https://developer.apple.com/sample-code/app-store-connect/app-store-connect-openapi-specification.zip
unzip -q /tmp/asc-openapi/spec.zip -d /tmp/asc-openapi

swift run asc-mcp openapi-coverage \
  --spec /tmp/asc-openapi/openapi.oas.json \
  --output ASC-OPENAPI-COVERAGE-GENERATED.md

The generated report records Apple spec metadata, path and operation counts, domain status, P0/P1 gaps, missing domains, and unclassified paths. The current checked-in report is ASC-OPENAPI-COVERAGE-GENERATED.md, generated from App Store Connect API 4.3.

Available worker names:

WorkerPrefixToolsDescription
companycompany_3Multi-account management
authauth_4JWT token tools
appsapps_9App listing, metadata, localizations
accessibilityaccessibility_6App Store accessibility declarations
webhookswebhooks_11Webhook notifications, delivery diagnostics, and receiver helpers
xcode_cloudxcode_cloud_30Xcode Cloud products, workflows, build runs, artifacts, issues, test results, and SCM
buildsbuilds_4Build management
build_processingbuilds_get_processing_*, builds_update_encryption, builds_check_readiness4Build states, encryption
build_betabuilds_*_beta_*, individual tester build tools11TestFlight localizations, notifications
versionsapp_versions_14Version lifecycle, submit, release
reviewsreviews_8Customer reviews and responses
beta_groupsbeta_groups_9TestFlight groups
beta_feedbackbeta_feedback_8TestFlight feedback screenshots, crash submissions, crash logs
beta_testersbeta_testers_12Tester management
iapiap_46In-app purchases, pricing, availability, offer codes, review assets
subscriptionssubscriptions_73Subscription lifecycle, pricing, availability, offers, assets
sandboxsandbox_3Sandbox testers
beta_appbeta_app_10Beta app localizations and review
pre_releasepre_release_3Pre-release versions
beta_licensebeta_license_3Beta license agreements
provisioningprovisioning_17Bundle IDs, devices, certificates
app_infoapp_info_10App info, categories, EULA
pricingpricing_9Territories, pricing
usersusers_10Team members, roles
app_eventsapp_events_9In-app events, localizations
analyticsanalytics_11Sales/financial reports, analytics
screenshotsscreenshots_16Screenshots, previews, sets
custom_pagescustom_pages_10Custom product pages
ppoppo_9Product page optimization (A/B tests)
promotedpromoted_9Promoted in-app purchases
review_attachmentsreview_attachments_4App Store review attachments
metricsmetrics_4Performance metrics, diagnostics

Token Cost

When connected to an LLM client, tool definitions consume context tokens. Here's the approximate footprint:

ConfigurationTools~Tokens
All workers (default)389~44,000
Release workflow: apps,builds,versions,reviews~57~7,000
Monetization: apps,iap,subscriptions,pricing~137~15,500
TestFlight: apps,builds,beta_groups,beta_testers~56~6,000
Marketing: apps,screenshots,custom_pages,ppo,promoted~60~6,800
--workers apps16~2,000

Heaviest workers: Subscriptions (73 tools), InAppPurchases (46 tools), Xcode Cloud (30 tools), Provisioning (17 tools), Screenshots (16 tools).

For 200K-context clients, ~44K tokens is about 22% of the window. For clients with smaller context windows, use --workers to reduce the footprint.

Available Tools

389 tools organized across 30 App Store tool domains + 2 core domains (use the 32 --workers filter keys — see Worker Filtering):

ToolDescription
company_listList all configured companies
company_switchSwitch active company for API operations
company_currentGet current active company info
ToolDescription
auth_generate_tokenGenerate JWT token for API access
auth_validate_tokenValidate an existing JWT token
auth_refresh_tokenForce refresh JWT token
auth_token_statusGet JWT token cache status
ToolDescription
apps_listList all applications with filtering
apps_get_detailsGet detailed app information
apps_searchSearch apps by name or Bundle ID
apps_list_versionsList all versions with states
apps_get_metadataGet localized metadata for a version
apps_update_metadataUpdate metadata (What's New, description, etc.)
apps_list_localizationsList localizations with content status
apps_create_localizationCreate a new localization for a version
apps_delete_localizationDelete a localization from a version
ToolDescription
accessibility_listList accessibility declarations for an app
accessibility_getGet one accessibility declaration
accessibility_createCreate a declaration for a device family
accessibility_updateUpdate support flags or publish a declaration
accessibility_deleteDelete a declaration
accessibility_list_relationshipsList declaration relationship IDs for an app
ToolDescription
webhooks_listList webhooks for an app
webhooks_getGet a webhook by ID
webhooks_createCreate a webhook configuration
webhooks_updateUpdate webhook fields
webhooks_deleteDelete a webhook
webhooks_list_deliveriesList delivery attempts
webhooks_redeliverRedeliver an existing delivery
webhooks_pingSend a test ping
webhooks_verify_signatureVerify x-apple-signature against the exact raw payload body
webhooks_parse_payloadParse and normalize a raw webhook notification payload
webhooks_triage_eventProduce an actionable triage plan for webhook events or delivery failures
ToolDescription
xcode_cloud_products_listList Xcode Cloud products
xcode_cloud_products_getGet an Xcode Cloud product
xcode_cloud_product_workflows_listList workflows for a product
xcode_cloud_product_build_runs_listList build runs for a product
xcode_cloud_workflows_getGet a workflow
xcode_cloud_workflow_build_runs_listList build runs for a workflow
xcode_cloud_build_runs_getGet a build run
xcode_cloud_build_runs_startStart or rebuild an Xcode Cloud build
xcode_cloud_build_run_actions_listList build actions for a run
xcode_cloud_build_run_builds_listList App Store Connect builds created by a run
xcode_cloud_actions_getGet a build action
xcode_cloud_action_artifacts_listList artifacts for an action
xcode_cloud_action_issues_listList issues for an action
xcode_cloud_action_test_results_listList test results for an action
xcode_cloud_artifacts_getGet an artifact
xcode_cloud_issues_getGet an issue
xcode_cloud_test_results_getGet a test result
xcode_cloud_xcode_versions_listList available Xcode versions
xcode_cloud_xcode_versions_getGet an Xcode version
xcode_cloud_macos_versions_listList available macOS versions
xcode_cloud_macos_versions_getGet a macOS version
xcode_cloud_scm_providers_listList SCM providers
xcode_cloud_scm_providers_getGet an SCM provider
xcode_cloud_scm_provider_repositories_listList repositories for an SCM provider
xcode_cloud_scm_repositories_listList SCM repositories
xcode_cloud_scm_repositories_getGet an SCM repository
xcode_cloud_scm_repository_git_references_listList repository git references
xcode_cloud_scm_repository_pull_requests_listList repository pull requests
xcode_cloud_scm_git_references_getGet a git reference
xcode_cloud_scm_pull_requests_getGet a pull request
ToolDescription
beta_feedback_list_crashesList beta crash feedback submissions
beta_feedback_get_crashGet one beta crash feedback submission
beta_feedback_get_crash_logRead crash log for a submission
beta_feedback_get_crash_log_by_idRead crash log by crash log ID
beta_feedback_delete_crashDelete a beta crash feedback submission
beta_feedback_list_screenshotsList beta screenshot feedback submissions
beta_feedback_get_screenshotGet one beta screenshot feedback submission
beta_feedback_delete_screenshotDelete a beta screenshot feedback submission
ToolDescription
builds_listList builds with processing states
builds_getGet detailed build information
builds_find_by_numberFind build by version number
builds_list_for_versionGet builds for specific app version
ToolDescription
builds_get_processing_stateGet current processing state
builds_update_encryptionSet encryption compliance
builds_get_processing_statusGet detailed processing status
builds_check_readinessCheck if build is ready for submission
ToolDescription
builds_get_beta_detailGet TestFlight configuration for build
builds_update_beta_detailUpdate TestFlight settings
builds_set_beta_localizationSet What's New for TestFlight
builds_list_beta_localizationsList all TestFlight localizations
builds_get_beta_groupsGet beta groups for a build
builds_get_beta_testersGet individual testers for a build
builds_send_beta_notificationSend notification to beta testers
builds_add_to_beta_groupsAdd build to beta groups
builds_add_individual_testersAdd individual testers to a build
builds_remove_individual_testersRemove individual testers from a build
builds_list_individual_testersList individual testers assigned to a build
ToolDescription
beta_groups_listList TestFlight beta groups for an app
beta_groups_createCreate a new beta group
beta_groups_updateUpdate beta group settings
beta_groups_deleteDelete a beta group
beta_groups_add_testersAdd testers to a beta group
beta_groups_remove_testersRemove testers from a beta group
beta_groups_list_testersList testers in a beta group
beta_groups_add_buildsAdd builds to a beta group
beta_groups_remove_buildsRemove builds from a beta group

Includes tester list/search/get/create/delete, app relationships, invitations, beta group assignment, build assignment, and app removal tools.

ToolDescription
app_versions_createCreate a new app version
app_versions_listList versions with state filtering
app_versions_getGet detailed version information
app_versions_updateUpdate version attributes
app_versions_attach_buildAttach build to version
app_versions_submit_for_reviewSubmit for App Store review
app_versions_cancel_reviewCancel ongoing review
app_versions_releaseRelease approved version
app_versions_create_phased_releaseCreate gradual rollout
app_versions_get_phased_releaseGet phased release info and ID
app_versions_update_phased_releasePause/resume/complete rollout
app_versions_set_review_detailsSet reviewer contact info
app_versions_update_age_ratingConfigure age rating declaration
app_versions_deleteDelete an editable app version
ToolDescription
reviews_listGet reviews with filtering and pagination
reviews_getGet specific review details
reviews_list_for_versionGet reviews for a specific version
reviews_statsAggregated review statistics
reviews_create_responseRespond to a customer review
reviews_delete_responseDelete a response
reviews_get_responseGet response for a review
reviews_summarizationsSummarize review themes and ratings
ToolDescription
iap_listList in-app purchases for an app
iap_getGet IAP details
iap_createCreate a new IAP
iap_updateUpdate IAP attributes
iap_deleteDelete an IAP
iap_list_localizationsList IAP localizations
iap_create_localizationCreate IAP localization
iap_update_localizationUpdate IAP localization
iap_delete_localizationDelete IAP localization
iap_submit_for_reviewSubmit IAP for review
iap_list_subscriptionsList subscription groups
iap_get_subscription_groupGet subscription group details
iap_inventoryAI-friendly IAP inventory for an app
iap_list_price_pointsList territory-aware price points
iap_list_price_point_equalizationsList price point equalizations
iap_get_price_scheduleGet price schedule
iap_set_price_scheduleSet price schedule
iap_pricing_summarySummarize current and scheduled prices
iap_prepare_offer_pricesFind price point candidates for offers
iap_set_availabilitySet territory availability
iap_get_availabilityGet availability by IAP or availability ID
iap_list_available_territoriesList available territories
iap_get_promoted_purchaseGet promoted purchase state
iap_list_offer_codesList IAP offer codes
iap_get_offer_codeGet an IAP offer code
iap_create_offer_codeCreate an IAP offer code
iap_update_offer_codeUpdate an IAP offer code
iap_deactivate_offer_codeDeactivate an IAP offer code
iap_list_offer_code_pricesList territory-aware offer prices
iap_generate_one_time_codesGenerate one-time offer codes
iap_list_one_time_codesList one-time code batches
iap_get_one_time_codeGet a one-time code batch
iap_update_one_time_codeUpdate a one-time code batch
iap_deactivate_one_time_codeDeactivate a one-time code batch
iap_get_one_time_code_valuesGet generated one-time code values
iap_create_custom_codeCreate a custom offer code
iap_get_custom_codeGet custom code details
iap_update_custom_codeUpdate a custom code
iap_deactivate_custom_codeDeactivate a custom code
iap_get_review_screenshotGet review screenshot
iap_upload_review_screenshotUpload review screenshot
iap_delete_review_screenshotDelete review screenshot
iap_upload_imageUpload promotional image
iap_get_imageGet promotional image
iap_delete_imageDelete promotional image
iap_list_imagesList promotional images

Includes subscription groups, group localizations, subscriptions, subscription localizations, territory-aware prices, price points, price point equalizations, availability, promoted purchase reads, inventory/pricing helpers, intro offers, promotional offers, offer codes, one-time/custom codes, win-back offers, images, and review screenshots. All former public offer_codes_*, intro_offers_*, promo_offers_*, and winback_* functionality is exposed through subscriptions_*.

ToolDescription
sandbox_listList sandbox testers
sandbox_updateUpdate sandbox tester settings
sandbox_clear_purchase_historyClear purchase history for sandbox testers
ToolDescription
beta_app_list_localizationsList beta app localizations
beta_app_create_localizationCreate beta app localization
beta_app_get_localizationGet beta app localization
beta_app_update_localizationUpdate beta app localization
beta_app_delete_localizationDelete beta app localization
beta_app_submit_for_reviewSubmit build for beta review
beta_app_list_submissionsList beta review submissions
beta_app_get_submissionGet beta review submission
beta_app_get_review_detailsGet beta app review details
beta_app_update_review_detailsUpdate beta app review details

Includes pre-release version listing, details, and associated builds.

Includes beta license agreement list, get, and update.

ToolDescription
provisioning_list_bundle_idsList registered bundle identifiers
provisioning_get_bundle_idGet bundle ID details
provisioning_create_bundle_idRegister a new bundle identifier
provisioning_delete_bundle_idDelete a bundle identifier
provisioning_list_devicesList registered devices
provisioning_register_deviceRegister a new device (UDID)
provisioning_update_deviceUpdate device name or status
provisioning_list_certificatesList signing certificates
provisioning_get_certificateGet certificate details
provisioning_revoke_certificateRevoke a certificate
provisioning_list_profilesList provisioning profiles
provisioning_get_profileGet profile details
provisioning_delete_profileDelete a profile
provisioning_create_profileCreate a provisioning profile
provisioning_list_capabilitiesList bundle ID capabilities
provisioning_enable_capabilityEnable a capability
provisioning_disable_capabilityDisable a capability

Includes app info list/get/update, app info localizations, and EULA get/create/update tools.

Includes territories, availability, price points, price schedules, and App Store availability v2 tools.

Includes team member list/get/update/remove, invitations, visible apps, and visible app relationship updates.

Includes in-app event CRUD plus event localization list/create/update/delete.

Includes sales, financial, app summary, analytics report request, report, instance, snapshot, and segment tools.

ToolDescription
screenshots_list_setsList screenshot sets
screenshots_create_setCreate a screenshot set
screenshots_delete_setDelete a screenshot set
screenshots_listList screenshots in a set
screenshots_uploadUpload a screenshot
screenshots_getGet screenshot details
screenshots_deleteDelete a screenshot
screenshots_reorderReorder screenshots in a set
screenshots_list_preview_setsList app preview sets
screenshots_create_preview_setCreate a preview set
screenshots_delete_preview_setDelete a preview set
screenshots_upload_previewUpload an app preview
screenshots_get_previewGet preview details
screenshots_list_previewsList previews in a preview set
screenshots_upload_batchUpload screenshots in a batch
screenshots_delete_previewDelete a preview
ToolDescription
custom_pages_listList custom product pages
custom_pages_getGet page details
custom_pages_createCreate a custom page
custom_pages_updateUpdate a custom page
custom_pages_deleteDelete a custom page
custom_pages_list_versionsList page versions
custom_pages_create_versionCreate a page version
custom_pages_list_localizationsList version localizations
custom_pages_create_localizationCreate a localization
custom_pages_update_localizationUpdate a localization
ToolDescription
ppo_list_experimentsList A/B test experiments
ppo_get_experimentGet experiment details
ppo_create_experimentCreate an experiment
ppo_update_experimentUpdate/start/stop experiment
ppo_delete_experimentDelete an experiment
ppo_list_treatmentsList experiment treatments
ppo_create_treatmentCreate a treatment variant
ppo_list_treatment_localizationsList treatment localizations
ppo_create_treatment_localizationCreate treatment localization
ToolDescription
promoted_listList promoted purchases for an app
promoted_getGet promotion details
promoted_createCreate a promotion
promoted_updateUpdate promotion (visibility/order)
promoted_deleteDelete a promotion
promoted_upload_imageUpload promoted purchase image
promoted_get_imageGet promoted purchase image
promoted_delete_imageDelete promoted purchase image
promoted_get_image_for_purchaseGet image for a promoted purchase

Includes App Store review attachment upload, get, delete, and list tools.

ToolDescription
metrics_app_perfGet app performance/power metrics
metrics_build_perfGet build performance metrics
metrics_build_diagnosticsList diagnostics for a build
metrics_get_diagnostic_logsGet diagnostic logs

Usage Examples

Complete Release Workflow

You: "Release version 2.2.0 of my app with build 456"

Claude will:
1. app_versions_create(app_id, platform: "IOS", version_string: "2.2.0")
2. app_versions_attach_build(version_id, build_id)
3. app_versions_set_review_details(version_id, contact_email: "...")
4. app_versions_submit_for_review(version_id)
5. app_versions_create_phased_release(version_id)  # after approval

TestFlight Distribution

You: "Create a beta group 'External Testers' and distribute the latest build"

Claude will:
1. beta_groups_create(app_id, name: "External Testers")
2. builds_list(app_id, limit: 1)  # find latest
3. builds_set_beta_localization(build_id, locale: "en-US", whats_new: "...")
4. beta_groups_add_testers(group_id, tester_ids: [...])

Review Management

You: "Show me all 1-star reviews from the last week and draft responses"

Claude will:
1. reviews_list(app_id, rating: 1, sort: "-createdDate", limit: 50)
2. reviews_create_response(review_id, response_body: "...")  # for each

Multi-Company Workflow

You: "Switch to ClientCorp and check their latest build status"

Claude will:
1. company_switch(company: "ClientCorp")
2. apps_list(limit: 5)
3. builds_list(app_id, limit: 1)
4. builds_get_processing_state(build_id)

API Constraints

ConstraintDetails
No emojisMetadata fields (What's New, Description, Keywords) must not contain emoji characters
Version stateApp Store Connect validates editable states for metadata updates. Rejected and metadata-rejected versions can be edited for resubmission; published or in-review versions may be rejected by Apple.
JWT expiryTokens expire after 20 minutes — the server auto-refreshes them
Rate limitsApple enforces per-account rate limits (documentation)
Locale formatUse standard codes: en-US, ru, de-DE, ja, zh-Hans

Architecture

Sources/asc-mcp/
├── EntryPoint.swift                # Entry point, --workers filtering
├── Core/
│   ├── Application.swift           #   MCP server setup & initialization
│   └── ASCError.swift              #   Custom error types
├── Helpers/                        # JSON formatting, pagination, safe helpers
├── Models/                         # API request/response models
│   ├── AppStoreConnect/            #   Apps, versions, localizations
│   ├── Builds/                     #   Builds, beta details, beta groups
│   ├── AppLifecycle/               #   Version lifecycle models
│   ├── InAppPurchases/             #   IAP models
│   ├── Subscriptions/              #   Subscriptions, offer codes, win-back
│   ├── Marketing/                  #   Screenshots, custom pages, PPO, promoted
│   ├── Metrics/                    #   Performance metrics, diagnostics
│   ├── Analytics/                  #   Sales/financial reports
│   ├── Provisioning/               #   Bundle IDs, devices, certificates
│   ├── Shared/                     #   Shared upload/image types
│   └── ...                         #   AppEvents, AppInfo, Pricing, Users
├── Services/
│   ├── HTTPClient.swift            #   Actor-based HTTP with retry logic
│   ├── JWTService.swift            #   ES256 JWT token generation
│   └── CompaniesManager.swift      #   Multi-account management
└── Workers/                        # MCP tool implementations (36 Swift worker classes + MainWorker router)
    ├── MainWorker/WorkerManager    #   Central tool registry & routing
    ├── CompaniesWorker/            #   company_* tools
    ├── AuthWorker/                 #   auth_* tools
    ├── AppsWorker/                 #   apps_* tools
    ├── AccessibilityWorker/        #   accessibility_* tools
    ├── WebhooksWorker/             #   webhooks_* tools
    ├── XcodeCloudWorker/           #   xcode_cloud_* tools
    ├── BuildsWorker/               #   builds_* tools
    ├── BuildProcessingWorker/      #   builds_*_processing tools
    ├── BuildBetaDetailsWorker/     #   builds_*_beta_* tools
    ├── AppLifecycleWorker/         #   app_versions_* tools
    ├── ReviewsWorker/              #   reviews_* tools
    ├── BetaGroupsWorker/           #   beta_groups_* tools
    ├── BetaFeedbackWorker/         #   beta_feedback_* tools
    ├── BetaTestersWorker/          #   beta_testers_* tools
    ├── InAppPurchasesWorker/       #   iap_* tools
    ├── SubscriptionsWorker/        #   subscriptions_* tools
    ├── OfferCodesWorker/           #   subscriptions offer-code tools
    ├── IntroductoryOffersWorker/   #   subscriptions intro-offer tools
    ├── PromotionalOffersWorker/    #   subscriptions promotional-offer tools
    ├── WinBackOffersWorker/        #   subscriptions win-back tools
    ├── SandboxTestersWorker/       #   sandbox_* tools
    ├── BetaAppWorker/              #   beta_app_* tools
    ├── PreReleaseVersionsWorker/   #   pre_release_* tools
    ├── BetaLicenseAgreementsWorker/ #  beta_license_* tools
    ├── ProvisioningWorker/         #   provisioning_* tools
    ├── AppInfoWorker/              #   app_info_* tools
    ├── PricingWorker/              #   pricing_* tools
    ├── UsersWorker/                #   users_* tools
    ├── AppEventsWorker/            #   app_events_* tools
    ├── AnalyticsWorker/            #   analytics_* tools
    ├── ScreenshotsWorker/          #   screenshots_* tools
    ├── CustomProductPagesWorker/   #   custom_pages_* tools
    ├── ProductPageOptimizationWorker/ # ppo_* tools
    ├── PromotedPurchasesWorker/    #   promoted_* tools
    ├── ReviewAttachmentsWorker/    #   review_attachments_* tools
    └── MetricsWorker/              #   metrics_* tools

Design Principles

  • Swift 6 strict concurrency — all workers and services are Sendable, proper actor isolation
  • Actor-based HTTP client — thread-safe with exponential backoff and retry logic
  • Prefix-based routing — WorkerManager routes tool calls by name prefix (zero config)
  • Minimal dependencies — only the MCP Swift SDK

Troubleshooting

  1. Verify the binary path is correct in your MCP host config
  2. Check that companies.json exists and is valid JSON
  3. Ensure .p8 key file paths are absolute and the files exist
  4. Try running the binary directly to see error output: .build/release/asc-mcp
  1. Verify your Key ID and Issuer ID match what's shown in App Store Connect
  2. Ensure the .p8 file is the original download (not modified)
  3. Check that the API key hasn't been revoked
  4. JWT tokens auto-refresh, but if the key is invalid, all requests will fail

apps_update_metadata sends the metadata PATCH to App Store Connect after local text, locale, and URL validation. Apple decides whether the current version state is editable. Rejected and metadata-rejected versions can be edited and resubmitted; published, in-review, or otherwise locked versions may return an Apple API error.

Use builds_get_processing_status to inspect the current processing state and builds_check_readiness to verify App Store/TestFlight readiness. Apple's build processing typically takes 5-30 minutes but can be longer during peak times.

The HTTP client automatically retries with exponential backoff on 429 responses. If you consistently hit limits, reduce the frequency of API calls or use pagination with smaller page sizes.

Development

Building

swift build              # Debug build
swift build -c release   # Release build (optimized)
swift package clean      # Clean build artifacts

Test Mode

.build/debug/asc-mcp --test    # Runs built-in integration tests

Adding a New Tool

  1. Create handler method in the appropriate Worker+Handlers.swift
  2. Add tool definition in Worker+ToolDefinitions.swift
  3. Register in worker's getTools() method
  4. Add routing case in worker's handleTool() switch
  5. The WorkerManager auto-routes by prefix — no changes needed there

Adding a New Worker

  1. Create directory: Workers/MyWorker/
  2. Create 3 files: MyWorker.swift, MyWorker+ToolDefinitions.swift, MyWorker+Handlers.swift
  3. Add worker property and initialization in WorkerManager.swift
  4. Add routing rule in WorkerManager.registerWorkers()
  5. Add getMyTools() helper method

Contributing

We welcome contributions! See Contributing Guide for details.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Acknowledgments


This is an unofficial, community-maintained tool and is not affiliated with or endorsed by Apple Inc.

Ver o original no GitHub

Bom para

Relacionados