mcp server

runtime

Sandboxes for AI agents: TypeScript, Python, Go, Java and Ruby SDKs, the runtime CLI, an MCP server, and agent integrations. Firecracker microVMs.

withruntime/runtimecommunitylistedunreviewednot running here yet

Use tool

Set up

Runs on your computer. Pick your agent and operating system.

Before you start

Node.js 20 or newer

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "runtime": {
      "command": "npx",
      "args": [
        "-y",
        "withruntime"
      ]
    }
  }
}

same format Cursor, GitHub Copilot CLI, Junie, JetBrains AI Assistant, Augment (Auggie CLI), Factory Droid, Kiro, Devin CLI +12

Values in angle brackets are placeholders. Restart Claude Desktop after editing its config.Claude Desktop docs

README

synced Oct 14, 2026

Runtime

The SDKs, CLI, MCP server and agent integrations for Runtime: sandboxes for AI agents. Each sandbox is a Firecracker microVM with its own Linux kernel, started from one call.

npm install withruntime   # TypeScript SDK, the `runtime` CLI and the MCP server
pip install withruntime   # Python SDK, sync and async

import { Sandbox } from "withruntime";

await using sbx = await Sandbox.create();
const result = await sbx.exec("python3 -c 'print(6 * 7)'");
console.log(result.exitCode, result.stdout);

from withruntime import Sandbox

with Sandbox.create() as sbx:
    result = sbx.exec("python3 -c 'print(6 * 7)'")
    print(result.exit_code, result.stdout)

The client reads RUNTIME_API_KEY, or the connection npx withruntime login saved on this machine. A new account starts on a free trial with no card. The quickstart takes it from there.

What is here

Path	What it is
`packages/cloud-sdk`	The TypeScript SDK, the `runtime` CLI and the MCP server: `withruntime` on npm
`sdks/python`	The Python SDK: `withruntime` on PyPI
`sdks/python/integrations/langchain-withruntime`	LangChain and Deep Agents sandbox backend
`sdks/go`, `sdks/java`, `sdks/ruby`	The Go, Java and Ruby SDKs
`integrations/pydantic-ai`, `integrations/google-adk`	Pydantic AI and Google ADK integrations
`integrations/claude-code`, `codex`, `cursor`, `gemini-cli`, `vscode`, `windsurf`	Skills, rules and MCP settings for coding agents
`packages/cloud-guide/docs`	The guides served at withruntime.com/docs, which the SDK tests check samples against

Documentation

Start
TypeScript and Python
CLI and MCP
Frameworks, and moving from E2B or Daytona
Pricing

Tests

bun test in packages/cloud-sdk and python3 -m unittest discover -s tests in sdks/python run here as they are. The suites that start Runtime's API server in-process, including all of the Go, Java and Ruby tests, run in Runtime's main repository before each release.

Contributing

Each release copies the SDKs here from Runtime's main repository, so each commit here is one copy, named after the versions in its source; a copy made before those versions reach npm and PyPI says so. Issues are welcome. A pull request is reviewed here and carried into the next release with its author credited.

License

Apache-2.0. See LICENSE.