# Runtime Cloud

Runtime Cloud gives AI agents isolated Linux sandboxes for commands, processes, files, and persistent state. Connect it to your coding agent to run workloads in the cloud.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: withruntime
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/withruntime/runtime/tree/HEAD/packages/cloud-sdk
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/runtime-cloud

## What it does

Runtime Cloud exposes Linux sandboxes to AI agents through MCP. An agent can execute shell commands, manage background processes, transfer files, use an interactive terminal, and access TCP ports. Sandboxes can be paused and resumed while retaining memory and running processes. Idle instances pause automatically after 300 seconds without activity.

Connection options are available for Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, and Gemini CLI. The hosted MCP endpoint is `https://api.withruntime.com/mcp`; a local process can be started with `npx -y withruntime`. The SDK requires Node.js 22.12 or later, or Bun. For servers and CI runners, authentication can use `RUNTIME_API_KEY`; local clients can also rely on a connection previously approved through the CLI.

The JavaScript SDK creates environments with `Sandbox.create()` and can retrieve an existing environment by name with `Sandbox.getOrCreate(name)`. It also supports snapshots, image changes, and mounting S3, R2, or Google Cloud Storage buckets as directories. Features such as `domains`, `ports`, `addresses`, `tunnel`, and `network` require a paid account. Projects migrating from E2B, Daytona, or Vercel Sandbox can use dedicated compatibility imports; unsupported E2B operations raise `NotSupportedError`.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.withruntime.com/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http runtime https://api.withruntime.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add cloud-sdk -- npx -y withruntime
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add cloud-sdk --url https://api.withruntime.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add cloud-sdk -- npx -y withruntime
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cloud-sdk": {
            "url": "https://api.withruntime.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cloud-sdk": {
            "command": "npx",
            "args": [
                "-y",
                "withruntime"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cloud-sdk": {
            "type": "http",
            "url": "https://api.withruntime.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cloud-sdk": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "withruntime"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http cloud-sdk https://api.withruntime.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add cloud-sdk npx -y withruntime
```

## When to use it
- Run agent-generated commands inside an isolated Linux environment
- Execute background jobs and inspect their results
- Transfer project files to a cloud sandbox and retrieve outputs
- Pause an environment while preserving its running processes
- Expose TCP ports and mount cloud storage as directories

## Example prompts
- Run the project tests in a Runtime Cloud Linux sandbox and report the exit code.
- Upload the project directory, execute its script in the sandbox, and return the generated files.
- Pause the Runtime Cloud sandbox after the task while preserving its current state.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md