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.

HerramientaQué hace
machines_listTus máquinas, con estado, vencimiento y URL MCP; filtra por external_id y labels
machine_createCrea y arranca una máquina (name, size, screen, ttl_minutes, on_expire, external_id, labels)
machine_getDetalles, incluyendo mcpUrl y mcpToken
machine_start / machine_stopEnciende o apaga una máquina; el estado se conserva
machine_set_ttlCambia cuánto tiempo permanece encendida (null = siempre encendida)
vpn_locations, machine_set_vpn, machine_vpn_statusUbicaciones VPN: navega desde una IP residencial en un país elegido
machine_resizeCambia el tamaño (tiny … large) sin recrear; una máquina en ejecución se reinicia una vez (~20 s)
machine_updateActualiza el agente de la máquina a la última versión (en vivo cuando sea posible) — ver Actualizaciones
machine_set_browserCambia el navegador: light (rápido, sin WebGL) o full (Chromium con WebGL) — ver Modo navegador
machine_set_tagsEstablece external_id (el id de tu cliente) y labels
pools_list, pool_create, pool_update, pool_delete, pool_claimGrupos en caliente: mantén máquinas arrancadas y entrega una a un cliente al instante
usage_by_customerGasto por external_id o por máquina (Facturación)
event_webhooks_list, event_webhook_create, event_webhook_test, event_webhook_deleteWebhooks de eventos: recibe notificaciones cuando las máquinas cambian de estado
machine_destroyElimina una máquina permanentemente (su disco, bóveda, instantáneas, programaciones y webhooks)
machine_schedule_*, machine_webhook_*, machine_job_runsTrabajos programados y webhooks; ver Trabajos programados y webhooks
machine_live_viewUn enlace para ver o tomar el control de la máquina, listo para un <iframe> (Incrusta la vista en vivo)
machine_call_toolLlama a cualquier herramienta de la máquina sin una segunda conexión
account_balanceSaldo, 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.

HerramientaArgumentos
browser_navigateurl
browser_snapshotmax_chars — URL, título, texto y elementos interactivos etiquetados [ref]
browser_clicktarget — una referencia de la instantánea, o un selector CSS
browser_filltarget, value, submit
browser_type / browser_press_keytext / key
browser_evaluateexpression
browser_screenshot—
browser_tabsaction: list, new, switch, close
browser_logincredential (opcional; coincide por URL) — completa y envía un formulario de inicio de sesión desde la bóveda
human_solve_captchakind, 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

HerramientaArgumentos
screenshot, desktop_screenshotCaptura la pantalla
get_app_stateÁrbol de accesibilidad + captura de pantalla de una aplicación
list_windows, focused_window, activate_windowGestión de ventanas
click, drag, scroll, type_text, press_keyEntrada, por índice de elemento, selector o coordenadas
perform_action, set_valueAcciones de accesibilidad

Aplicaciones, shell y archivos

HerramientaArgumentos
apps_listquery
apps_installkind: apt (packages), deb (url), appimage (url, name), flatpak (ref), script
apps_launchapp o command — espera la ventana
shell_runcommand, cwd, timeout_seconds, background
browser_capabilitiesEl motor del navegador (light / full) y si las páginas obtienen WebGL/WebGL2
network_infoIP pública, país y red desde la que navega la máquina, y si hay una ubicación VPN configurada
file_read / file_writepath / path, content

Bóveda

HerramientaArgumentos
vault_listNombres, URLs y nombres de usuario — nunca secretos
vault_setname, url, username, password, totp_secret
vault_type_secretname, field (username / password / totp) — escribe en la aplicación enfocada
vault_deletename

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_saveRegistra ventanas y pestañas abiertas ahora (también ocurre cada 20 s)
machine_infoQué está en ejecución y cómo encajan las herramientas