Runtime Cloud logo

Runtime Cloud

Connects AI agents to Runtime Linux microVM sandboxes for commands, files, processes, and sandbox lifecycle control.

Install Runtime Cloud

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "runtime-cloud-2": {
      "command": "npx",
      "args": [
        "-y",
        "withruntime"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

Runtime Cloud MCP server exposes Runtime's Firecracker microVM sandboxes as agent tools for running commands, handling files, managing processes, and pausing or waking sandboxes. It runs locally through the `withruntime` npm package over MCP stdio, or remotely through Runtime's Streamable HTTP endpoint. Use it when an agent needs an isolated Linux environment for code execution and sandbox state management. Initial access can use browser approval, while `RUNTIME_API_KEY` supports connected machines and CI.

Use cases

  • Run code in isolated Linux microVM sandboxes
  • Execute agent-generated commands
  • Manage files and processes during coding tasks
  • Pause and wake sandboxes around agent work
  • Connect coding agents to Runtime through MCP

Key features

  • Firecracker microVM sandboxes
  • Command execution
  • File and process operations
  • Pause and wake controls
  • MCP stdio and Streamable HTTP access
  • Browser or API-key authentication

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked

Recent health check succeeded.

10/10 checks healthy over the last 48d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 1d ago via OSV.dev · withruntime (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2Stargazers on the source repository.
npm downloads26kPackage downloads in the last 30 days.
Last commit15d agoMost recent push to the default branch.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How Runtime Cloud works

What Runtime Cloud does

Runtime Cloud connects MCP-compatible agents to isolated Runtime sandboxes. Each sandbox runs as a Firecracker microVM with its own Linux kernel, giving agents an environment for command execution and related runtime operations.

The MCP interface exposes Runtime product capabilities as tools. These cover running commands, working with files, controlling processes, and changing sandbox state by pausing or waking it. A typical use case is an AI coding or automation agent that needs to execute code without using the host machine directly.

How it works

The local MCP server is provided by the withruntime npm package. An MCP client starts it with npx -y withruntime mcp, and the server initially provides runtime_connect. The agent uses that tool to begin authorization; Runtime presents a link and code, and the user approves “Connect agent” in a browser. Once connected, the Runtime tools become available.

Machines already authenticated with npx withruntime login can skip the first-time connection flow. For automated environments, the client can use the RUNTIME_API_KEY environment variable instead of interactive browser approval.

Clients that support MCP Streamable HTTP can connect directly to https://api.withruntime.com/mcp. Runtime is also listed in the official MCP Registry as com.withruntime/runtime.

Setup and configuration

The MCP server requires Node.js 22.12 or later. Install the package through npm, or let npx fetch it when the client starts the server.

For Claude Code, run:

Terminal
claude mcp add --scope user runtime -- npx -y withruntime mcp

Clients using JSON-based stdio configuration can use:

config.json
{
  "mcpServers": {
    "runtime": {
      "command": "npx",
      "args": ["-y", "withruntime", "mcp"]
    }
  }
}

Use npx withruntime login for an interactive machine-level connection. Set RUNTIME_API_KEY in CI or other noninteractive environments. The MCP server itself does not require an API key when browser-based connection is available.

Tools and capabilities

  • Connect an agent to Runtime with runtime_connect.
  • Run commands inside Linux microVM sandboxes.
  • Read and work with sandbox files.
  • Manage processes running in a sandbox.
  • Pause and wake sandboxes.
  • Expose Runtime functionality through local stdio or Streamable HTTP MCP connections.

Limitations and notes

The local server depends on Node.js 22.12 or newer. Browser authorization is interactive unless the machine has already been connected or an API key is supplied. Sandbox execution uses Runtime's hosted Firecracker microVM environment rather than the local operating system.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Runtime Cloud

Runtime Cloud is an MCP server that connects AI agents to Runtime’s Firecracker microVM sandboxes. It exposes tools for running commands, working with files, managing processes, and pausing or waking sandboxes. The `runtime_connect` tool handles initial browser authorization when a machine is not already connected.

Run it through `npx -y withruntime mcp` after installing Node.js 22.12 or later. Add that command to your MCP client’s server configuration, or use `claude mcp add --scope user runtime -- npx -y withruntime mcp` with Claude Code.

Approve the browser connection initiated by `runtime_connect`, or authenticate the machine first with `npx withruntime login`. For CI and other noninteractive environments, set `RUNTIME_API_KEY`.

Yes, Runtime Cloud works with Cursor through its JSON MCP server configuration. Set the command to `npx` and pass `-y`, `withruntime`, and `mcp` as arguments.

Yes, clients that support MCP Streamable HTTP can connect to `https://api.withruntime.com/mcp`. Browser sign-in is used for authorization unless the environment already has another supported connection method.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewRuntime Cloud AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/runtime-cloud-2?style=directory)](https://allmcps.com/mcp/runtime-cloud-2)
HTML Embed
<a href="https://allmcps.com/mcp/runtime-cloud-2"><img src="https://allmcps.com/api/badge/runtime-cloud-2?style=directory" alt="Runtime Cloud on AllMCPs" /></a>