Skip to main content

Sandbox MCP tools

Review the tools the Sandbox MCP gives your agent to create and work in a sandbox.

When you install the Sandbox MCP, your agent gains these tools for creating and working in a sandbox. Your agent chooses the tools as it works through your request. You do not call them yourself.

ToolWhat it does
create_sandboxStarts a sandbox and returns its ID.
execute_codeRuns Python in the persistent kernel.
execute_commandRuns a shell command, including elembio CLI commands.
install_packagesInstalls additional Python packages with pip.
list_filesLists the files in a sandbox directory.
list_artifactsLists files with size and type details, to find a file to share.
fetch_artifactCreates a short-lived download link for a file in the sandbox.
request_uploadCreates a short-lived link that uploads a file from your computer into the sandbox.
get_statusReports whether the sandbox is ready or busy, and how much memory it uses.
get_resultsReturns the result of code that continued running in the background.
interrupt_executionStops the running code and keeps the kernel state.
destroy_sandboxEnds the sandbox permanently.
read_skillReads an Element Biosciences skill that the Sandbox MCP provides, such as a multiomics skill.

See also​