Burrowbox
Computadoras Linux persistentes para agentes de IA: escritorio, navegador con sesión iniciada, bóveda de credenciales, instalación de aplicaciones y shell, a través de MCP.
Servidor MCP alojado
npx add-mcp 'https://burrowbox.dev/mcp'Se instala en Claude Code, Codex, Cursor y más
Documentación
MCP
Burrowbox habla el Protocolo de Contexto de Modelo a través de HTTP Streamable. Hay dos tipos de endpoints.
MCP de Plataforma
POST /mcp con tu clave API. Permite que un agente gestione máquinas por sí mismo.
| Herramienta | Qué hace |
|---|---|
machines_list | Tus máquinas, con estado, vencimiento y URL MCP; filtra por external_id y labels |
machine_create | Crea y arranca una máquina (name, size, screen, ttl_minutes, on_expire, external_id, labels) |
machine_get | Detalles, incluyendo mcpUrl y mcpToken |
machine_start / machine_stop | Enciende o apaga una máquina; el estado se conserva |
machine_set_ttl | Cambia cuánto tiempo permanece encendida (null = siempre encendida) |
vpn_locations, machine_set_vpn, machine_vpn_status | Ubicaciones VPN: navega desde una IP residencial en un país elegido |
machine_resize | Cambia el tamaño (tiny … large) sin recrear; una máquina en ejecución se reinicia una vez (~20 s) |
machine_update | Actualiza el agente de la máquina a la última versión (en vivo cuando sea posible) — ver Actualizaciones |
machine_set_browser | Cambia el navegador: light (rápido, sin WebGL) o full (Chromium con WebGL) — ver Modo navegador |
machine_set_tags | Establece external_id (el id de tu cliente) y labels |
pools_list, pool_create, pool_update, pool_delete, pool_claim | Grupos en caliente: mantén máquinas arrancadas y entrega una a un cliente al instante |
usage_by_customer | Gasto por external_id o por máquina (Facturación) |
event_webhooks_list, event_webhook_create, event_webhook_test, event_webhook_delete | Webhooks de eventos: recibe notificaciones cuando las máquinas cambian de estado |
machine_destroy | Elimina una máquina permanentemente (su disco, bóveda, instantáneas, programaciones y webhooks) |
machine_schedule_*, machine_webhook_*, machine_job_runs | Trabajos programados y webhooks; ver Trabajos programados y webhooks |
machine_live_view | Un enlace para ver o tomar el control de la máquina, listo para un <iframe> (Incrusta la vista en vivo) |
machine_call_tool | Llama a cualquier herramienta de la máquina sin una segunda conexión |
account_balance | Saldo, tasa de consumo y tiempo restante |
claude mcp add --transport http burrowbox https://burrowbox.dev/mcp
Los clientes que admiten OAuth (Claude, Cursor, VS Code) abren una página de Burrowbox para iniciar sesión y aprobar, por lo que no necesitas una clave (OAuth). De lo contrario, pasa una clave API:
claude mcp add --transport http burrowbox https://burrowbox.dev/mcp \
--header "Authorization: Bearer $BURROWBOX_KEY"
MCP de Máquina
POST /api/machines/{id}/mcp con el mcpToken de la máquina (o tu clave API). Esto es lo que un agente usa para operar la computadora.
Navegador
El navegador persistente de la máquina. Las cookies, el almacenamiento local y las pestañas sobreviven a los reinicios, y puedes verlo en vivo.
| Herramienta | Argumentos |
|---|---|
browser_navigate | url |
browser_snapshot | max_chars — URL, título, texto y elementos interactivos etiquetados [ref] |
browser_click | target — una referencia de la instantánea, o un selector CSS |
browser_fill | target, value, submit |
browser_type / browser_press_key | text / key |
browser_evaluate | expression |
browser_screenshot | — |
browser_tabs | action: list, new, switch, close |
browser_login | credential (opcional; coincide por URL) — completa y envía un formulario de inicio de sesión desde la bóveda |
human_solve_captcha | kind, sitekey, url, timeoutSeconds, tokenOnly — resuelve el desafío de verificación en la página actual (páginas de verificación de Cloudflare, Turnstile, reCAPTCHA v2, hCaptcha). Se factura por uso |
Escritorio
| Herramienta | Argumentos |
|---|---|
screenshot, desktop_screenshot | Captura la pantalla |
get_app_state | Árbol de accesibilidad + captura de pantalla de una aplicación |
list_windows, focused_window, activate_window | Gestión de ventanas |
click, drag, scroll, type_text, press_key | Entrada, por índice de elemento, selector o coordenadas |
perform_action, set_value | Acciones de accesibilidad |
Aplicaciones, shell y archivos
| Herramienta | Argumentos |
|---|---|
apps_list | query |
apps_install | kind: apt (packages), deb (url), appimage (url, name), flatpak (ref), script |
apps_launch | app o command — espera la ventana |
shell_run | command, cwd, timeout_seconds, background |
browser_capabilities | El motor del navegador (light / full) y si las páginas obtienen WebGL/WebGL2 |
network_info | IP pública, país y red desde la que navega la máquina, y si hay una ubicación VPN configurada |
file_read / file_write | path / path, content |
Bóveda
| Herramienta | Argumentos |
|---|---|
vault_list | Nombres, URLs y nombres de usuario — nunca secretos |
vault_set | name, url, username, password, totp_secret |
vault_type_secret | name, field (username / password / totp) — escribe en la aplicación enfocada |
vault_delete | name |
Automatizaciones
Añadidas por la plataforma, limitadas a esta máquina: schedule_create, schedule_list, schedule_update, schedule_delete, schedule_run, webhook_create, webhook_list, webhook_rotate, webhook_delete, job_runs. Un agente puede programar su propio trabajo ("revisa este panel cada mañana a las 9") o dar a otro sistema una URL que lo active. Ver Trabajos programados y webhooks.
Sesión
| Herramienta | |
|---|---|
session_save | Registra ventanas y pestañas abiertas ahora (también ocurre cada 20 s) |
machine_info | Qué está en ejecución y cómo encajan las herramientas |