appstoreconnect-mcp
Provides read-only access to Apple's App Store Connect API, with tools to list apps, retrieve app details, list App Store versions, TestFlight builds and beta groups, and fetch customer reviews.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
appstoreconnect-mcp
Servidor MCP (Model Context Protocol) de solo lectura para la API de App Store Connect de Apple. Transporte local stdio.
Proyecto de VYR TECH SOLUTIONS.
Estado
MVP. La superficie expuesta es de lectura únicamente: el servidor no registra, y no permite registrar, ninguna herramienta de escritura.
Este repositorio recibe el código por ramas (feature/..., fix/...) con PR a main.
Tarea principal: https://paperclip.davidneyra.dev/VYRA/issues/VYRA-47
Plan entregado: https://paperclip.davidneyra.dev/VYRA/issues/VYRA-48
Related MCP server: App Store Connect MCP Server
Alcance de esta fase
Incluido | Excluido (fases posteriores) |
Transporte stdio local | Transporte HTTP / OAuth (PR upstream #6) |
| Informes de ventas ( |
| Métricas de analytics |
| |
| |
|
El servidor solo emite peticiones GET contra la API de App Store Connect. El cliente
no contiene ningún método que haga POST, PATCH, PUT o DELETE.
Requisitos
Node.js >= 18
Una clave de API de App Store Connect (
.p8) y suissuerId
Instalación
npm install
npm run buildConfiguración
Variable | Obligatoria | Descripción |
| Sí | Key ID de la clave |
| Sí | Issuer ID (team ID) de App Store Connect |
| Sí* | Contenido PEM de la clave |
| Sí* | Ruta al archivo |
| No | Restringe el servidor a una app por bundle id |
| No | Restringe el servidor a una app por App Store id |
| No |
|
* Configure una de las dos, no ambas.
Las credenciales se dan por variables de entorno o gestor de secretos: nunca se versionan en este repositorio.
Restricción de alcance
Si define APPLE_BUNDLE_ID o APPLE_APP_STORE_ID, el servidor comprueba el alcance de
cada app antes de cualquier petición. Una app fuera del alcance se rechaza con un error
y no se emite ninguna llamada a la API para ese recurso.
Uso
Como servidor stdio local:
node dist/stdio.jsConfiguración de cliente MCP:
{
"mcpServers": {
"appstoreconnect": {
"command": "npx",
"args": ["-y", "@vyrtech/appstoreconnect-mcp"],
"env": {
"APPLE_KEY_ID": "...",
"APPLE_ISSUER_ID": "...",
"APPLE_PRIVATE_KEY_PATH": "/ruta/a/la/clave.p8"
}
}
}
}Transporte stdio
stdout transporta exclusivamente tramas JSON-RPC del protocolo MCP. Todos los
diagnósticos, avisos y trazas van a stderr.
La redirección de console a stderr se instala antes de importar cualquier otro
módulo, de modo que una dependencia que registre al importarse no puede corromper el
flujo del protocolo.
Si falta la configuración obligatoria, el servidor escribe el error en stderr, deja
stdout vacío y termina con código distinto de cero.
Herramientas
Todas las herramientas son de lectura.
Herramienta | Argumentos | Devuelve |
| — | Apps visibles en la cuenta |
|
| Una app |
|
| Versiones de App Store, más recientes primero |
|
| Builds de TestFlight, más recientes primero |
|
| Grupos de beta de TestFlight |
|
| Reseñas de clientes |
Un argumento desconocido o fuera de rango se rechaza antes de emitir cualquier petición de red.
Seguridad de los logs
Todos los diagnósticos van a
stderr;stdoutnunca lleva texto que no sea JSON-RPC.Los valores secretos se redactan antes de escribir: claves con nombre de secreto (
privateKey,authorization,token, ...) se sustituyen por una huella no reversible.El material secreto incrustado en texto libre también se redacta: bloques PEM, tokens
Bearery paresclave: valor.Las cadenas largas se truncan.
Desarrollo
npm run build # compilar a dist/
npm test # suite completa (mocks y fixtures, sin red)
npx tsc -p tsconfig.test.json # comprobación de tipos de src/ y test/La suite usa fixtures y una clave ES256 generada en memoria. No se usa ninguna credencial real de Apple.
Licencia
MIT. Ver LICENSE.
Atribución de upstream y relación con ryaker/appstore-connect-mcp: ver NOTICE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
MCP server for Appcircle mobile CI/CD platform.
The official Planning Center MCP server for interacting with your ministry's data.
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
Related MCP Servers
- AlicenseBqualityFmaintenanceAn MCP server to communicate with the App Store Connect API for iOS Developers25115 npm331MIT
- AlicenseAqualityBmaintenanceA Model Context Protocol (MCP) server for Apple's App Store Connect API. Manage your iOS, macOS, tvOS, and visionOS apps directly from Claude, Cursor, or any MCP-compatible client.52186 npm23MIT
- AlicenseNot gradedqualityCmaintenanceApp Store Connect MCP Server (Swift) that manages apps, builds, TestFlight, metadata, reviews natively on macOSMIT
- AlicenseNot gradedqualityBmaintenanceThis MCP server provides access to Apple's App Store Connect API. It allows users to inspect apps, versions, builds, TestFlight groups, sales, users, and optionally edit metadata and manage testers.1,131 npm2MIT