boxy
Provides an operational environment where AI agents can execute system commands (shell), interact with the Linux filesystem, and run processes within the contained sandbox.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
OpenBoxy
Give your AI agents a real browser and terminal.
OpenBoxy equips chat-only AI agents with a persistent Chromium browser, workspace shell, and live human takeover over MCP—in a self-hosted, single-container Streamable HTTP MCP server (
/mcp) with a live web UI (/,/view,/view/terminal) where you can watch or click Take Control to handle logins, 2FA, or CAPTCHAs by hand.
Each API token maps to an isolated user sandbox (/data/users/<userId>/profile, /workspace, and /home), so multiple users (or multiple AI clients) can connect safely.
Screenshots
Sign In (/login)

Live Browser View (/view)

Quick Start
Create
.envfrom the example:cp .env.openboxy.example .envGenerate your default API token (
OPENBOXY_MCP_TOKEN):openssl rand -hex 32Optionally add more users in
.env:OPENBOXY_USERS=alice:tok_alice_xxx,bob:tok_bob_xxxStart OpenBoxy:
docker compose -f docker-compose.openboxy.yml up -d --buildVerify:
Health check:
curl http://127.0.0.1:3100/healthzWeb UI (Browser & Terminal):
http://127.0.0.1:3100/
Related MCP server: orchords-web-pilot
Connecting External AI Clients (/mcp)
OpenBoxy supports OAuth 2.0 PKCE + Dynamic Client Registration and Static Bearer Tokens.
Option A: OAuth 2.0 PKCE (Recommended for OpenCode, Claude Code, Cursor)
Point your client at https://your-domain/mcp with no manual headers. In OpenCode (~/.config/opencode/opencode.jsonc):
{
"mcp": {
"boxy": {
"type": "remote",
"url": "https://your-domain/mcp",
"enabled": true
}
}
}Then run /mcps in OpenCode, select boxy, and sign in at /oauth/authorize using your API token. Your OAuth session is bound to that token's user sandbox.
Option B: Static Bearer Token
{
"mcpServers": {
"boxy": {
"serverUrl": "https://your-domain/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}Exposed MCP Tools
Terminal & Files:
shell,read_file,write_file,edit_file,list_dirBrowser:
browser_navigate,browser_snapshot,browser_read,browser_click,browser_type,browser_press,browser_scroll,screenshot,browser_viewBrowser Downloads: Any file downloaded in the live browser automatically saves to
workspace/downloads/and appears in/view/files.
Plugins (Custom Tools)
Drop .ts / .js plugin files into /data/plugins (or set OPENBOXY_PLUGINS_DIR) to register custom MCP tools without modifying OpenBoxy core:
import type { OpenBoxyPlugin } from "/app/src/plugins.ts";
export default {
name: "my-custom-tool",
// Optional: restrict to specific userIds
// allowedUsers: ["default"],
register(ctx) {
ctx.registerTool(
"open_my_app",
{
description: "Open my internal web app and prefill an input.",
inputSchema: { query: ctx.z.string() },
},
async ({ query }) => {
await ctx.sandbox.withPage(ctx.userId, async (page) => {
await page.goto("http://my-service:8080");
// ...prefill page...
});
return ctx.textResult({
viewUrl: `${ctx.publicUrl}/view`,
filesUrl: `${ctx.publicUrl}/view/files`,
});
},
);
},
} satisfies OpenBoxyPlugin;Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Official Browserless MCP server: browser automation, scraping, screenshots and PDFs for AI agents.
Control a real browser from AI agents: navigate, click, type, screenshot, read the page.
A cloud Linux desktop for your AI: browse, click, type, read the screen and run commands.
Give AI agents a real cloud Chrome: open sessions, navigate, read pages, click, type and screenshot.
Related MCP Servers
- AlicenseCqualityDmaintenanceExposes a remote browser as MCP tools via Playwright, enabling AI agents to navigate and interact with web pages through DOM snapshots, clicks, typing, and form operations.4014 npm14Apache 2.0

orchords-web-pilotofficial
FlicenseAqualityCmaintenanceEnables coding agents to drive a real Playwright-backed browser session, navigating, observing, interacting, and capturing proof on web pages via MCP tools across stdio and Streamable HTTP transports.152-- AlicenseNot gradedqualityCmaintenanceEnables AI agents and clients to control a real Chromium browser through MCP tool calls, including navigation, clicking, typing, JavaScript evaluation, screenshots, and DOM snapshots. Supports multiple isolated sessions over authenticated HTTP with no disk writes.Apache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to drive a live, persistent self-hosted Chromium session over MCP, running browser actions via Playwright/CDP, capturing page snapshots, screenshots and videos, and managing uploads and downloads in the same tabs and signed-in accounts a human user can take over at any time.28 npmApache 2.0