Skip to main content
Sandbox connector for MCP implementations. This module provides a connector for communicating with MCP implementations that are executed inside a sandbox environment (currently using E2B).

SandboxConnector

method init

Initialize a new sandbox connector.Parameters
str
required
String value
list[str]
required
List of items
dict[str, str] | None
default:"None"
Environment variables for the user’s MCP server command.
mcp_use.client.connectors.sandbox.SandboxOptions | None
default:"None"
Configuration options for the E2B sandbox environment.
float
default:"5"
Timeout for the sandbox process in seconds.
float
default:"300"
Timeout for the SSE connection in seconds.
mcp.client.session.SamplingFnT | None
default:"None"
Optional sampling callback.
mcp.client.session.ElicitationFnT | None
default:"None"
Optional elicitation callback.
mcp.client.session.MessageHandlerFnT | None
default:"None"
Optional callback to handle messages.
mcp.client.session.LoggingFnT | None
default:"None"
Optional callback to handle log messages.
list[mcp_use.client.middleware.middleware.Middleware] | None
default:"None"
Optional list of middleware.
list[mcp.types.Root] | None
default:"None"
Optional initial list of roots to advertise to the server.
mcp.client.session.ListRootsFnT | None
default:"None"
Optional custom callback to handle roots/list requests.
Signature

method wait_for_server_response

Wait for the server to respond to HTTP requests.Parameters
str
required
The base URL to check for server readiness
int
default:"30"
Maximum time to wait in seconds
Returns
bool
True if server is responding, raises TimeoutError otherwise
Signature

SandboxOptions

Attributes
str
required
String value
NotRequired
required
Parameter value
NotRequired
required
Parameter value

method init

Initialize self. See help(type(self)) for accurate signature.Parameters
required
Parameter value
required
Parameter value
Signature