Google Play Console MCP

Un servidor MCP para Google Play Console: 169 herramientas entre publicación, Android vitals, ingresos, ASO y recursos de tienda, con una puerta de confirmación en cada operación destructiva.

Conecta Claude, Cursor, VS Code, Codex, Gemini CLI, Windsurf o cualquier cliente de Model Context Protocol a tu cuenta de desarrollador de Google Play.

Publica una versión. Pregunta si está fallando. Descubre cuánto ha ganado. Mira qué buscaron los usuarios para encontrarla. Responde a una reseña. Todo desde la misma sesión, y ninguna de las partes destructivas sin que digas que sí primero.

"Is the 4.2.1 rollout healthy?"
  -> vitals freshness checked, crash rate by version code, worst issue's stack
     trace, current rollout fraction — and a recommendation

"How much did we make in July, and where did the installs come from?"
  -> earnings per currency, acquisitions by traffic source, top search terms

"Ship 4.2.2 to production at 10%."
  -> a preview you have to approve before anything moves

Por qué este

Hay una docena de servidores MCP de Google Play. Este es el único que cubre toda la superficie, y el único con una suite de pruebas real.

La mayoría de los servidores envuelven la Android Publisher API y ahí se quedan. Esa API no puede decirte tu tasa de fallos, no puede decirte cuánto has ganado y no puede decirte qué ha buscado la gente para encontrar tu app: eso vive en otros dos lugares totalmente distintos.

Related MCP server: MCP Google Play Store Server

Los cinco planos

Cada una necesita credenciales distintas, y el servidor te dice exactamente cuáles faltan y cómo arreglarlas.

Instalación

uvx google-play-console-mcp          # no install
pipx install google-play-console-mcp # or install it
pip install google-play-console-mcp

Configuración

Añádelo a tu cliente MCP (.mcp.json, claude_desktop_config.json, …):

{
  "mcpServers": {
    "google-play": {
      "command": "uvx",
      "args": ["google-play-console-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account.json",
        "GOOGLE_PLAY_MCP_REPORTS_BUCKET": "pubsite_prod_rev_0123456789"
      }
    }
  }
}

Credenciales

1. Cuenta de servicio: Google Cloud Console → habilita la Google Play Android Developer API → crea una cuenta de servicio → descarga el archivo JSON

2. Invítala en Play Console → Usuarios y permisos.

3. Otórgale, que son independientes y se pueden pasar por alto por separado:

El permiso de informes masivos es a nivel de cuenta. Una concesión a nivel de aplicación no llega al bucket de almacenamiento, y esto es la causa más común de que esas herramientas devuelvan 403.

Encuentra el bucket en Play Console → Descargar informes → Estadísticas → Copiar URI de Cloud Storage. No hay ninguna API que lo descubra.

Luego pídele al agente que ejecute verificar acceso_a_informes, o lee el recurso gplay://config — ambos informan de lo que está configurado y qué necesita cada pieza que falta.

Seguridad

Este servidor puede publicar en producción, eliminar cualquier ficha de tienda y hacer reembolsos de dinero real. Así que:

18 herramientas destructivas están detrás de una puerta de confirmación en dos pasos. La primera llamada devuelve una vista previa —qué cambia, en qué afecta, cómo deshacerlo— y no hace nada. Solo es una segunda llamada con el token de la vista previa la que se ejecuta.

El token es un HMAC sobre una huella digital canónica de la operación, con una clave por instalación que el modelo nunca ve. Deteca un token inventado, un token de otra operación, un parámetro cambiado entre la vista previa y la confirmación, un token reutilizado y uno caducado.

El modelo de amenaza no es un usuario hostil. Es un modelo de lenguaje que alucina tokens de confirmación, repite tokens antiguos, ajusta un parámetro entre la vista previa y la confirmación, y te informará satisfecho de que has aprobado algo que nunca viste.

halt_release a propósito no está detrás de la puerta. Interúnir un despliegue defectuoso es la única operación que reduce el radio de impacto, y exigir una segunda instancia en mitad de un incidente ya es en sí mismo el modo de fallo.

La producción no puede llegar al 100 % en un solo paso. La política de despliegue por fases limita el primer paso al 20 %; el llegar a todo el mundo exige una herramienta de ampliación, con otro nombre a la vista. El máximo puede bajarse, pero no inhabilitarse.

Todo queda auditado — previsualizado, confirmado, rechazado, ejecutado, fallido — en ~/.google-play-mcp/audit.jsonl, con datos secretos borrados.

GOOGLE_PLAY_MCP_READ_ONLY=1 rechaza toda escritura de plano, para sesiones de exploratori.

Ver Seguridad de escritura.

Lo que sabe y que de otro modo aprenderías por las malas

• Las capturas de pantalla no deben tener canal alfa. El icono debe tenerlo. Una exportación "simplemente PNG" es RGBA — correcta para el icono, rechazado para todo lo demás. verificación_imagen_tienda lo detecta antes de que sesenta imágenes se vean rechazadas al subirlas.

• Play exige al menos dos capturas por tipo y por locale. Un conjunto de una sola es válido archivo a archivo y sigue bloqueando el lanzamiento.

• Una compra de suscripción que esté tres días sin reconocerse es automáticamente reembolsada y retirada por Google. Pérdida silenciosa de ingresos.

• La API acepta un título de 50 caracteres; la política de Play lo limita a 30. El título se sube sin problemas y se rechaza en la revisión.

• Los datos de Android vitals llegue con un retraso de horas a días. Una consulta por siete días que devuelve cinco se lee como una mejora, no como un vacío, por eso la frescura es una herramienta de primera categoría.

• Los ingresos de un mes no se publican hasta un día 5 del mes siguiente. Informar de «$0» antes de eso se interpreta como un colapso, no como una ausencia.

• Los ingresos tampoco se suman entre divisas: 1000 JPY más 10 EUR son una respuesta incorrecta que parece correcta.

• com.acme.free no debe contabilizar lo que ingresa com.acme.freemium. La atribución se detiene en una frontera de paquete.

Herramientas

169 herramientas. Referencia completa en la documentación.

Más 2 prompts (publish_screenshots, release_health_check) y 4 recursos.

Probada

1,198 tests · 100% line and branch coverage · 15 modules
ruff clean · mypy clean · every release gated at --cov-fail-under=100

No hay llamadas reales a la API en el conjunto. La interpretación de informes se prueba con bytes UTF-16 reales, y el preflight de imágenes contra píxeles PNG y JPEG reales.

Fuera del ámbito

Generación de capturas de pantalla — usa generador-de-capturas u otra herramienta, y luego haz el preflight y súbelas aquí.

Licencia

Apache-2.0.

Keywords: google play console mcp, google play mcp server, android publisher api mcp, play developer api, model context protocol google play, android app release automation, android fun, android vitals mcp, play console api claude, aso mcp, google play earnings api, play store screenshots api, android release agent