# Superserve (MCP server)

> Superserve is an MCP server that adds tools to AI assistants such as Claude Desktop, Claude Code and Cursor. MCP server for Superserve sandboxes: create, exec, and manage Firecracker microVMs. It has 465 GitHub stars, is released under the Apache-2.0 license and runs locally with npx -y @superserve/mcp.

Model Context Protocol server for Superserve sandboxes. Create, run commands in, and manage isolated Firecracker microVMs from any MCP client — Claude, Cursor, VS Code, Windsurf, Codex.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/superserve-ai/superserve |
| GitHub stars | 465 |
| License | Apache-2.0 |
| Language | TypeScript |
| Transport | stdio, streamable-http |
| Packages | npm: @superserve/mcp |
| Remote URL | https://mcp.superserve.ai |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code, Claude.ai, ChatGPT |
| Category | Other |
| Latest release | v1.1.0 (Mar 1, 2026) |
| Last commit | Oct 7, 2026 |
| MCP registry name | io.github.superserve-ai/mcp |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "superserve": {
      "command": "npx",
      "args": [
        "-y",
        "@superserve/mcp"
      ],
      "env": {
        "SUPERSERVE_API_KEY": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env SUPERSERVE_API_KEY=your-value --transport stdio superserve -- npx -y @superserve/mcp
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "superserve": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@superserve/mcp"
      ],
      "env": {
        "SUPERSERVE_API_KEY": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "superserve_api_key",
      "description": "SUPERSERVE_API_KEY",
      "password": true
    }
  ],
  "servers": {
    "superserve": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@superserve/mcp"
      ],
      "env": {
        "SUPERSERVE_API_KEY": "${input:superserve_api_key}"
      }
    }
  }
}
```

### Claude Code (remote)

```sh
claude mcp add --transport http superserve "https://mcp.superserve.ai"
```

The same server is also hosted as a remote MCP endpoint, so nothing runs on your machine.

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `SUPERSERVE_API_KEY` (secret) (required): Superserve API key (starts with sslive). Create one at https://console.superserve.ai.
- `SUPERSERVE_BASE_URL`: Override the Superserve control-plane API base URL. Defaults to https://api.superserve.ai.

## Tools

- `sandbox_create`: Create a sandbox; returns its id. Accepts secrets bindings and egress rules.
- `sandbox_update`: Change a sandbox's metadata or egress (allowout/denyout) rules after creation.
- `sandbox_list`: List sandboxes (active and paused), filterable by metadata.
- `sandbox_info`: Get a sandbox's status, resources, metadata, network rules, and secret bindings.
- `sandbox_exec`: Run a shell command; returns stdout, stderr, exit code. Auto-resumes a paused sandbox.
- `sandbox_computer`: Drive a GUI desktop sandbox: screenshot, mouse, keyboard, scroll, resize, live viewer URL.
- `sandbox_files_read`: Read a file (UTF-8 text or base64). Rejects files over 1 MiB.
- `sandbox_files_write`: Create or overwrite a file (inline content capped at 8 MiB).
- `sandbox_files_list`: List a directory.
- `sandbox_files_download_dir`: Download a directory as a base64 ZIP (symlinks skipped). Capped at 10 MiB.
- `sandbox_pause`: Pause a sandbox (state preserved).
- `sandbox_resume`: Resume a paused sandbox (usually unnecessary — exec auto-resumes).
- `sandbox_kill`: Delete a sandbox.
- `sandbox_preview_url`: Publish a port and return a public or private signed preview URL.
- `sandbox_network_log`: Audit a sandbox's outbound connections.
- `sandbox_template_list`: List the templates (prebuilt base images) your team can create sandboxes from.
- `sandbox_template_create`: Build a custom template (vCPU/memory/disk shape, preinstalled software). Async.
- `secret_list`: List bindable team secrets (metadata only — never values).
- `sandbox_attach_secret`: Bind a stored secret to a sandbox under an env var.
- `sandbox_detach_secret`: Remove a secret binding from a sandbox.

## Similar MCP servers

- [Reactive Resume](https://appsgit.com/mcp-servers/reactive-resume): A one-of-a-kind resume builder that keeps your privacy in mind. (43,921 stars, MIT)
- [N8n MCP](https://appsgit.com/mcp-servers/n8n-mcp): A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you. (23,047 stars, MIT)
- [XHS Downloader](https://appsgit.com/mcp-servers/xhs-downloader): 小红书（XiaoHongShu、RedNote）链接提取/作品采集工具. (12,922 stars, GPL-3.0)
- [MCP Use](https://appsgit.com/mcp-servers/mcp-use): The fullstack MCP framework to develop MCP Apps for ChatGPT / Claude & MCP Servers for AI Agents. (10,726 stars, MIT)
- [Ha MCP](https://appsgit.com/mcp-servers/ha-mcp): Comprehensive Model Context Protocol server for managing Home Assistant through AI assistants. (4,964 stars, MIT)
- [MCP Server Chart](https://appsgit.com/mcp-servers/mcp-server-chart): A Model Context Protocol server for generating charts using AntV. (4,391 stars, MIT, needs API key)

---

Canonical page: https://appsgit.com/mcp-servers/superserve
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.