English Français العربية

Runtime Cloud

Official registry AI and agents

Linux microVM sandboxes for AI agents: run commands, files, processes, pause and wake.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http runtime-cloud 'https://api.withruntime.com/mcp' --header 'Authorization: <Optional: Bearer <key> from https://withruntime.com/account/keys. Without it the client signs in through the browser (OAuth).>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "runtime-cloud": {
            "type": "http",
            "url": "https://api.withruntime.com/mcp",
            "headers": {
                "Authorization": "<Optional: Bearer <key> from https://withruntime.com/account/keys. Without it the client signs in through the browser (OAuth).>"
            }
        }
    }
}
NPM package withruntime
Claude Code 
claude mcp add runtime-cloud -- npx -y withruntime@0.37.0 mcp
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "runtime-cloud": {
            "command": "npx",
            "args": [
                "-y",
                "withruntime@0.37.0",
                "mcp"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Runtime
  2. What is here
  3. Documentation
  4. How Runtime compares
  5. Tests
  6. Contributing
  7. License

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

PathWhat it is
packages/cloud-sdkThe TypeScript SDK, the runtime CLI and the MCP server: withruntime on npm
sdks/pythonThe Python SDK: withruntime on PyPI
sdks/python/integrations/langchain-withruntimeLangChain and Deep Agents sandbox backend
sdks/go, sdks/java, sdks/rubyThe Go, Java and Ruby SDKs
integrations/openai-agents, pydantic-ai, google-adk, smolagentsOpenAI Agents SDK, Pydantic AI, Google ADK and smolagents integrations, each <name>-withruntime on PyPI
integrations/claude-code, codex, cursor, gemini-cli, vscode, windsurfSkills, rules and MCP settings for coding agents
packages/cloud-guide/docsThe guides served at withruntime.com/docs, which the SDK tests check samples against

Documentation

How Runtime compares

Pages that answer what people ask when choosing a sandbox, each with the providers' published rates and the date they were read:

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.

Frequently asked questions

What is Runtime Cloud?

Linux microVM sandboxes for AI agents: run commands, files, processes, pause and wake.

How do I install Runtime Cloud?

It runs as a remote server. In Claude Code: claude mcp add --transport http runtime-cloud 'https://api.withruntime.com/mcp' --header 'Authorization: <Optional: Bearer <key> from https://withruntime.com/account/keys. Without it the client signs in through the browser (OAuth).>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Runtime Cloud need an API key?

Yes. It expects Authorization, which you set in its configuration.

Is Runtime Cloud open source?

Yes. Its code is on GitHub under the Apache-2.0 license.

Who maintains Runtime Cloud?

It is published by withruntime. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.