Skip to content
appsgit

Superserve

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.

github.com/superserve-ai/superserve (opens in a new tab)

Install Superserve

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.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

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

Cursor

.cursor/mcp.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
{
  "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)

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 Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
SUPERSERVE_API_KEYsecretYesSuperserve API key (starts with sslive). Create one at https://console.superserve.ai.
SUPERSERVE_BASE_URLNoOverride the Superserve control-plane API base URL. Defaults to https://api.superserve.ai.

Tools (20)

Parsed from the Tools section of the README; check the repository for the current list.

  • 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.

About Superserve

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.

FAQ

Superserve FAQ

Still curious? Email info@appsgit.com.

What is Superserve?

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. The source code is at github.com/superserve-ai/superserve.

How do I install the Superserve MCP server?

Add the command npx -y @superserve/mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Superserve free?

The server is open source under the Apache-2.0 license, so running it is free. It needs credentials (SUPERSERVE_API_KEY) for the service it connects to, which may require a paid account.

Is Superserve actively maintained?

The most recent commit was on Oct 7, 2026. The latest release is v1.1.0, published Mar 1, 2026. appsgit only lists MCP servers with a commit in the last six months and re-checks every server daily.