Massed Compute MCP server

Massed Compute MCP Server

<!-- mcp-name: io.github.Massed-Compute/mcp -->

A Model Context Protocol server that lets AI assistants — Claude, Cursor, Codex, ChatGPT, and other MCP-compatible clients — interact with your Massed Compute account: browse GPU inventory, launch and manage VMs, audit billing, discover setup recipes.

Contents

• Overview
• Installation
• Verifying the connection
• CLI reference
• Key resolution
• Resources
• License

Overview

The packages published from this repo are a verbatim proxy of the public MCP endpoint at https://vm.massedcompute.com/api/mcp — zero added surface. Every JSON-RPC message (initialize, tools/list, tools/call, resources/list, resources/read, ping, …) is forwarded unchanged with your stored API key injected as a Bearer header, and responses come back unchanged. Nothing is added, renamed, filtered, or rewritten on the way through:

• The hosted endpoint owns the catalog. Tools, resources, schemas, and descriptions come from the live endpoint — the local package never goes stale when new capabilities (like setup recipes) ship upstream.
• The hosted endpoint owns security. Key-scope enforcement (read-only keys hide destructive tools) and credential redaction happen server-side, identically for every client.
• What the local package adds is exactly what a stdio client needs: a stdio↔streamable-HTTP bridge, OS-conventional storage for your API key (0600 on POSIX), and one-shot client wiring via init.

Issue a read-only key for analysis-only assistants and the endpoint rejects destructive tool calls (launch, restart, terminate, SSH-key changes) at call time. Works with Claude Code, Claude Desktop, Cursor, and Codex. Run massed-compute-mcp tools to print the live catalog — GPU inventory, VM images, instance lifecycle, coupons, billing, SSH keys, and setup recipes.

Beyond raw tools, Massed Compute publishes Agent Skills — markdown workflow templates for common operations like GPU selection and cost auditing. Full docs at vm-docs.massedcompute.com/docs/category/mcp.

Installation

Step 1. Get your API key

Open vm.massedcompute.com/settings/api, create a key (read-only for analysis-only assistants; full-access to allow launch / restart / terminate / SSH-key changes), copy it.

Step 2. Pick an install path

• Hosted endpoint — point your client at the streamable-HTTP URL, zero install
• Local CLI — runs on your machine, key stored in your OS config dir

Hosted endpoint

The local packages proxy this endpoint verbatim, so pointing your client straight at it gives you the identical catalog with nothing to install. Pick the snippet for your client:

Claude Code

claude mcp add --transport http massed-compute \
  https://vm.massedcompute.com/api/mcp \
  --header "Authorization: Bearer MC_TOKEN"

Cursor — ~/.cursor/mcp.json

{
  "mcpServers": {
    "massed-compute": {
      "url": "https://vm.massedcompute.com/api/mcp",
      "headers": { "Authorization": "Bearer MC_TOKEN" }
    }
  }
}

Codex — ~/.codex/config.toml

[mcp_servers.massed-compute]
url = "https://vm.massedcompute.com/api/mcp"
bearer_token_env_var = "MC_TOKEN"
enabled = true

Claude Desktop

Claude Desktop does not yet speak streamable-HTTP MCP, so use mcp-remote as a stdio↔HTTP bridge. Config at ~/Library/Application Support/Claude/claudedesktopconfig.json (macOS) or %APPDATA%\Claude\claudedesktopconfig.json (Windows):

Shortened. The full README is on GitHub.