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.

Contents

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

Overview

The server exposes 14 tools that map 1:1 to documented /api/v1/* endpoints — no internal services, no undocumented calls. Issue a read-only key for analysis-only assistants and destructive tools (launch, restart, terminate, SSH-key changes) are hidden from the catalog entirely. Works with Claude Code, Claude Desktop, Cursor, and Codex.

| Tool | Required key | Returns |
|---|---|---|
| gpu_inventory_list | read-only | GPU configurations, pricing, regional capacity |
| images_list | read-only | VM image catalog |
| instances_list | read-only | Your running VM instances |
| instances_get | read-only | A single instance by UUID |
| instances_launch | full | Newly-launched instance details (incurs cost) |
| instances_restart | full | Restart confirmation |
| instances_terminate | full | Termination confirmation (destructive) |
| coupon_information | read-only | Coupon discount terms |
| coupon_accepted_products | read-only | Products a coupon applies to |
| account_token_validation | read-only | Token validity status |
| account_billing | read-only | Billing settings, recharge configuration |
| ssh_keys_list | read-only | Your SSH keys |
| ssh_keys_create | full | Newly-created key details |
| ssh_keys_delete | full | Deletion confirmation (destructive) |

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

Same 14 tools, same API key, 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/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "massed-compute": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://vm.massedcompute.com/api/mcp",
        "--header", "Authorization: Bearer MC_TOKEN"
      ]
    }
  }
}

Local CLI

Install via whichever ecosystem you prefer:

```bash
npm install -g massed-compute-mcp # Node >= 20