E2B MCP Server

An MCP server that exposes the E2B Sandbox API as Model Context Protocol tools.

Features

The server currently provides tools for:

• Sandboxes (sandbox_create, sandbox_connect, sandbox_list, sandbox_kill, sandbox_pause, sandbox_set_timeout, sandbox_get_info) — create/connect/list/kill/pause sandboxes and manage their timeout, via the E2B JS SDK (Sandbox).
• Filesystem (files_read, files_write, files_list, files_make_dir, files_rename, files_remove, files_exists, files_get_info) — read/write/list/move/remove/stat files via Sandbox.files.
• Commands (commands_run, commands_connect, commands_list, commands_send_stdin, commands_close_stdin, commands_kill) — run and manage commands via Sandbox.commands.
• PTY (pty_create, pty_connect, pty_send_input, pty_resize, pty_kill) — pseudo-terminal sessions via Sandbox.pty.

The server is stateless: it authenticates with E2B_API_KEY (env) and, for secure sandboxes, replays the accessToken returned by sandbox_create / sandbox_connect on every later call.

Deprecated E2B API endpoints and snapshot-related functionality have been removed from the project.

Requirements

• Node.js 22 or later
• An E2B API key

Installation

npm ci

Configuration

Set your E2B API key in the environment:

export E2B_API_KEY="your-api-key"

Usage

Start the server with:

npm start

The server is designed to be used as an MCP server over stdio. It can be connected to any MCP-compatible client that supports stdio servers.

Docker

Build the image:

docker build -t e2b-mcp-server .

Run it:

docker run --rm -i \
  -e E2B_API_KEY="$E2B_API_KEY" \
  e2b-mcp-server

Development

Check the JavaScript syntax for all source files:

for f in src/*.js; do node --check "$f"; done

Run the smoke test:

npm run smoke

Project Structure

src/
├── http.js
├── index.js
├── tools-common.js
├── tools-filesystem.js
├── tools-process.js
├── tools-sandboxes.js
└── tools-templates.js

License

ISC