Sandbox MCP

A secure, isolated execution environment for running code with full VM capabilities, git integration, and agent-optimized APIs.

Installation

npx @dotdo/mcp install sandbox

Tools

sandbox_create

Create a new sandbox environment.

Tool Schema:

{
  "name": "sandbox_create",
  "description": "Create a new sandbox environment.",
  "inputSchema": {
    "type": "object",
    "properties": {
      // Tool parameters
    }
  }
}

sandbox_delete

Permanently remove the sandbox.

Tool Schema:

{
  "name": "sandbox_delete",
  "description": "Permanently remove the sandbox.",
  "inputSchema": {
    "type": "object",
    "properties": {
      // Tool parameters
    }
  }
}

sandbox_execute

Run code within the sandbox.

Tool Schema:

{
  "name": "sandbox_execute",
  "description": "Run code within the sandbox.",
  "inputSchema": {
    "type": "object",
    "properties": {
      // Tool parameters
    }
  }
}

sandbox_terminate

Force stop any running sandbox execution.

Tool Schema:

{
  "name": "sandbox_terminate",
  "description": "Force stop any running sandbox execution.",
  "inputSchema": {
    "type": "object",
    "properties": {
      // Tool parameters
    }
  }
}

sandbox_clone

Clone a git repository into the sandbox.

Tool Schema:

{
  "name": "sandbox_clone",
  "description": "Clone a git repository into the sandbox.",
  "inputSchema": {
    "type": "object",
    "properties": {
      // Tool parameters
    }
  }
}

sandbox_checkout

Switch to different branch or commit.

Tool Schema:

{
  "name": "sandbox_checkout",
  "description": "Switch to different branch or commit.",
  "inputSchema": {
    "type": "object",
    "properties": {
      // Tool parameters
    }
  }
}

sandbox_pull

Pull latest changes from remote repository.

Tool Schema:

{
  "name": "sandbox_pull",
  "description": "Pull latest changes from remote repository.",
  "inputSchema": {
    "type": "object",
    "properties": {
      // Tool parameters
    }
  }
}

sandbox_commit

Commit changes in sandbox to git.

Tool Schema:

{
  "name": "sandbox_commit",
  "description": "Commit changes in sandbox to git.",
  "inputSchema": {
    "type": "object",
    "properties": {
      // Tool parameters
    }
  }
}

sandbox_push

Push committed changes to remote repository.

Tool Schema:

{
  "name": "sandbox_push",
  "description": "Push committed changes to remote repository.",
  "inputSchema": {
    "type": "object",
    "properties": {
      // Tool parameters
    }
  }
}

sandbox_install

Install dependencies (npm, pip, cargo, etc.).

Tool Schema:

{
  "name": "sandbox_install",
  "description": "Install dependencies (npm, pip, cargo, etc.).",
  "inputSchema": {
    "type": "object",
    "properties": {
      // Tool parameters
    }
  }
}

sandbox_run

Execute shell command in sandbox.

Tool Schema:

{
  "name": "sandbox_run",
  "description": "Execute shell command in sandbox.",
  "inputSchema": {
    "type": "object",
    "properties": {
      // Tool parameters
    }
  }
}

sandbox_read

Read file contents from sandbox filesystem.

Tool Schema:

{
  "name": "sandbox_read",
  "description": "Read file contents from sandbox filesystem.",
  "inputSchema": {
    "type": "object",
    "properties": {
      // Tool parameters
    }
  }
}

sandbox_write

Write content to file in sandbox.

Tool Schema:

{
  "name": "sandbox_write",
  "description": "Write content to file in sandbox.",
  "inputSchema": {
    "type": "object",
    "properties": {
      // Tool parameters
    }
  }
}

sandbox_logs

Retrieve execution logs from sandbox.

Tool Schema:

{
  "name": "sandbox_logs",
  "description": "Retrieve execution logs from sandbox.",
  "inputSchema": {
    "type": "object",
    "properties": {
      // Tool parameters
    }
  }
}

sandbox_reset

Clear sandbox state and return to initial configuration.

Tool Schema:

{
  "name": "sandbox_reset",
  "description": "Clear sandbox state and return to initial configuration.",
  "inputSchema": {
    "type": "object",
    "properties": {
      // Tool parameters
    }
  }
}

Resources

sandbox/created

Triggered when a new sandbox is created.

Resource URI: sandbox://created

sandbox/deleted

Triggered when sandbox is removed.

Resource URI: sandbox://deleted

sandbox/executed

Triggered when code runs in sandbox.

Resource URI: sandbox://executed

sandbox/terminated

Triggered when sandbox execution is force stopped.

Resource URI: sandbox://terminated

sandbox/Repository.cloned

Triggered when git repository is cloned into sandbox.

Resource URI: sandbox://Repository.cloned

sandbox/Branch.checkedOut

Triggered when branch or commit is checked out.

Resource URI: sandbox://Branch.checkedOut

sandbox/Changes.pulled

Triggered when changes are pulled from remote.

Resource URI: sandbox://Changes.pulled

sandbox/Changes.committed

Triggered when changes are committed to git.

Resource URI: sandbox://Changes.committed

sandbox/Commits.pushed

Triggered when commits are pushed to remote.

Resource URI: sandbox://Commits.pushed

sandbox/Packages.installed

Triggered when dependencies are installed.

Resource URI: sandbox://Packages.installed

sandbox/Command.executed

Triggered when shell command runs.

Resource URI: sandbox://Command.executed

sandbox/File.read

Triggered when file is read from filesystem.

Resource URI: sandbox://File.read

sandbox/File.written

Triggered when file is written to filesystem.

Resource URI: sandbox://File.written

sandbox/reset

Triggered when sandbox state is cleared.

Resource URI: sandbox://reset

sandbox/Permission.violated

Triggered when code attempts unauthorized action.

Resource URI: sandbox://Permission.violated

sandbox/Limit.exceeded

Triggered when resource limit is reached.

Resource URI: sandbox://Limit.exceeded

Usage with Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "sandbox": {
      "command": "npx",
      "args": ["-y", "@dotdo/mcp", "serve", "sandbox"]
    }
  }
}

Sandbox MCP

On this page