AppScreen

@appscreen/mcp

Servidor MCP para AppScreen — genera capturas de pantalla para App Store / Play Store desde cualquier agente compatible con MCP (Claude Desktop, Claude Code, Cursor, Codex, etc.).

Instalación

# Latest, no install — recommended for end users
npx -y @appscreen/mcp

Configuración (Claude Desktop)

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

{
  "mcpServers": {
    "appscreen": {
      "command": "npx",
      "args": ["-y", "@appscreen/mcp"],
      "env": {
        "APPSCREEN_API_KEY": "mcm_live_…"
      }
    }
  }
}

Omita APPSCREEN_API_KEY para uso anónimo (5 renderizados de por vida, luego se requiere registro).

Configuración (otros clientes)

• Claude Code: claude mcp add appscreen -- npx -y @appscreen/mcp

• Cursor: .cursor/mcp.json — misma estructura JSON que la anterior.

• Codex: codex mcp add appscreen -- npx -y @appscreen/mcp, o agréguelo a ~/.codex/config.toml:

  [mcp_servers.appscreen]
  command = "npx"
  args = ["-y", "@appscreen/mcp"]
  env = { APPSCREEN_API_KEY = "mcm_live_…" }
  

Herramientas

• render_screenshots — Acepta pantallas (JSON de diseño) y archivos de imagen. Devuelve un jobId (con clave/asíncrono) o un enlace de descarga (anónimo/en línea). El uso anónimo gratuito está limitado a 5 de por vida.
• get_render_status — Consulta un jobId. Devuelve el estado y una URL de descarga firmada cuando termina.

Pase imágenes por ruta, no por base64

El servidor se ejecuta localmente, así que proporciónele una ruta de archivo — lee los bytes del disco. No codifique capturas de pantalla reales en base64 dentro de la llamada: un LLM que emite una cadena base64 de 18k–90k caracteres pierde un carácter a mitad de camino y el PNG se renderiza en negro debajo de ese punto.

"files": [
  { "name": "1.png", "path": "~/app/screenshots/home.png" },   // ✅ preferred
  { "name": "2.png", "path": "/abs/path/settings.png" }
]
// base64 is accepted only for tiny synthetic test images:
// { "name": "x.png", "base64": "iVBORw0KG..." }

Las URL de descarga de paquetes están firmadas y caducan después de ~1 hora. Vuelva a consultar para actualizar.

Cuota

El uso con sesión iniciada se mide en créditos: 1 crédito = 1 imagen exportada (pantallas × tamaños × idiomas). Una exportación fallida se reembolsa; la traducción automática es gratuita. Una clave MCP gasta los créditos del espacio de trabajo en el que se creó.

Plan	Créditos / mes	Notas
Gratis	50	iOS 6.9, inglés, 10 pantallas por exportación. 3 renderizados / hora.
Starter — $4 / mes	400	Los 4 tamaños, cualquier 3 idiomas por exportación, traducción automática. 3 renderizados / hora.
Pro — $8 / mes	2,500	Los 15 idiomas, 200 pantallas por exportación. MCP a tarifa completa.
Equipo — $29 / mes	8,000 compartidos	3 asientos incluidos. MCP a tarifa completa.

Los paquetes de créditos únicos funcionan en todos los planes, incluido el Gratis: 100 por $5, 400 por $15, 1,500 por $39, válidos por 12 meses. El uso anónimo (sin clave) no se mide en créditos — está limitado a 5 renderizados, de por vida.

Cada respuesta de herramienta incluye _meta.quota = {used, cap, tier, resetAt}, además de balance (créditos restantes) y, al enviar un renderizado, cost cuando la API los reporta. Para un llamador con sesión iniciada, used y cap cuentan créditos (cap − used = balance) y tier es el id del plan; para un llamador anónimo cuentan los 5 renderizados de por vida y tier es anon-mcp. Cuando queda menos de la mitad, el contenido de texto lleva un aviso breve ("N créditos restantes …"); por debajo del 20%, o en cero, la respuesta también incluye _meta.upgradeUrl.

Una exportación que el espacio de trabajo no puede cubrir falla con HTTP 402 insufficient_credits — el texto del error indica el costo y el saldo. Detalles completos: https://appscreen.co/pricing.

Entorno

Variable	Propósito
APPSCREEN_API_KEY	Opcional. Clave MCP (mcm_live_…) de https://appscreen.co/account/keys. Funciona en todos los planes, incluido el Gratis. No es lo mismo que la clave de API programática ask_live_….
APPSCREEN_BASE_URL	Sobrescribe la URL de la API. El valor predeterminado es https://api.appscreen.co.
APPSCREEN_MCP_CLIENT	Sobrescribe el identificador del cliente (detectado automáticamente desde la inicialización de MCP).

Licencia

MIT