Phonebox (Android for AI agents)

Servidor MCP de Android alojado: dale a Claude Code, Codex o Cursor un teléfono Android en la nube para leer la pantalla, tocar, escribir, instalar APKs y estacionar. Sin ADB ni emulador.

Servidor MCP alojado

npx add-mcp 'https://phonebox.dev/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Servidor MCP de Phonebox para Android

Un servidor MCP de Android alojado para Claude Code, Codex, Cursor y cualquier cliente MCP, de Phonebox, el teléfono en la nube pensado para agentes. Tu agente obtiene un teléfono Android real en la nube. Puede leer la pantalla, tocar, escribir, instalar tu APK, transferir a un humano y estacionar el teléfono cuando termina. No necesitas ADB, Android Studio ni un emulador.

claude mcp add --transport http phonebox https://phonebox.dev/mcp \
  --header "Authorization: Bearer $PHONEBOX_API_KEY"
  • Endpoint: https://phonebox.dev/mcp (HTTP Streamable, clave API de tipo bearer)
  • Precio: $0.06 por minuto de teléfono, facturado por segundo, con un mínimo de 1 minuto. Los teléfonos estacionados son gratuitos y conservan sus aplicaciones e inicios de sesión.
  • Comienza gratis: $2 de crédito, sin tarjeta → phonebox.dev

Este repositorio contiene las configuraciones y ejemplos. El servidor en sí está alojado por Phonebox, así que no hay nada que ejecutar.

Por qué está pensado para agentes

La mayoría de los teléfonos en la nube se crearon para paneles de redes sociales o suites de pruebas de control de calidad y añadieron una API después. Phonebox se creó para el agente: tu agente te registra desde la terminal, lee la pantalla como texto, recibe errores con un paso de next y nunca se reintenta una escritura sin que lo sepa. Los teléfonos inactivos se estacionan solos de forma gratuita.

Por qué está alojado en lugar de un servidor MCP de ADB

Servidor MCP de ADB localMCP alojado de Phonebox
Dónde se ejecuta el teléfonoUn emulador o teléfono USB en tu máquinaLa nube de Phonebox
ConfiguraciónSDK de Android, ADB, una imagen de sistemaUna URL y una clave API
Funciona desde CI, sandboxes y entornos de desarrollo remotosSolo con virtualización anidada o un dispositivoSí
Estado entre sesionesLo que conserve tu emuladorAplicaciones, archivos e inicios de sesión conservados mientras está estacionado
Transferencia a un humanoAlguien en la máquinaUn enlace de vista en vivo en cualquier navegador

Obtén una clave API

La forma más rápida es pegar esto en tu agente de codificación. Te registra desde la terminal y nunca pegas una clave en el chat:

Read https://phonebox.dev/setup.md and set me up with Phonebox from here: get me signed in and ready, then find out what I want to use phones for and help me with that.

O crea una clave en la consola y export PHONEBOX_API_KEY=pbx_….

Conecta tu cliente

Claude Code — ejecuta el comando en la parte superior o confirma el .mcp.json de este repositorio. Lee la clave del entorno de cada persona:

{
  "mcpServers": {
    "phonebox": {
      "type": "http",
      "url": "https://phonebox.dev/mcp",
      "headers": { "Authorization": "Bearer ${PHONEBOX_API_KEY}" }
    }
  }
}

Cursor: añade examples/cursor-mcp.json a ~/.cursor/mcp.json o .cursor/mcp.json.

Codex: añade examples/codex-config.toml a ~/.codex/config.toml.

Cualquier otro cliente: apúntalo a https://phonebox.dev/mcp con un encabezado Authorization: Bearer pbx_…. El servidor es HTTP Streamable sin estado y no usa OAuth.

Herramientas

HerramientaQué hace
create_phoneCrea un teléfono Android en la nube y espera hasta que esté listo
observeLee la pantalla como una lista de texto numerada, más una captura de pantalla de 720px
actEjecuta hasta 20 acciones en orden: tocar, escribir, deslizar, desplazarse, abrir una aplicación, esperar un elemento
install_appInstala desde la biblioteca de aplicaciones o desde tu propio APK subido
create_app_upload / complete_app_uploadSube tu APK con un solo comando curl
live_view_urlUn enlace para que una persona vea y controle el teléfono
start_phone / park_phoneReanuda un teléfono estacionado, o lo estaciona para detener la facturación
list_phones / get_phone / list_apps / reboot_phoneEncuentra teléfonos, espera por ellos, lista aplicaciones, reinicia un teléfono bloqueado

Lo que el agente lee de observe:

app com.android.launcher3
screen 1080x2400
[1] EditText "Search apps" #search clickable editable (540,250)
[2] TextView "Chrome" #icon clickable (200,1900)
[3] TextView "Settings" #icon clickable (500,1900)

Ejemplos

Lo que no es

Solo Android (sin iOS), y no hay números de teléfono, SMS ni llamadas. Phonebox le da a tu agente el dispositivo, no telefonía.

Aprende más