Tools reference
The MCP server exposes 17 tools. Columns below show which API key (or OAuth grant) tier sees each tool. Use a read-only credential when the assistant only needs to inspect account state; use a full-access credential to launch, restart, terminate, or manage SSH keys. Tools a read-only credential cannot see are hidden from the assistant entirely — they cannot be invoked by accident or prompt injection.
When you ask to install, configure, or spin up software on a Massed Compute VM, call recipes_search first, then recipes_get to load the full recipe by slug. Recipes encode the right image, SKU class, and step-by-step commands. recipes_list is for browsing the catalog.
Full tool list
| Tool | Read-only key | Full key | What it does | Example prompt |
|---|---|---|---|---|
gpu_inventory_list | ✓ | ✓ | List available GPU configurations, specs, pricing, and capacity per region | "What GPUs are available right now?" |
images_list | ✓ | ✓ | List preconfigured VM images available for deployment | "What VM images can I deploy?" |
instances_list | ✓ | ✓ | List all running VM instances on the account | "List my running VMs." |
instances_get | ✓ | ✓ | Get a single running instance by UUID | "Show me the details for instance abc-123." |
instances_launch | — | ✓ | Deploy a new VM instance (incurs cost) | "Launch a 1x H100 with Ubuntu Server 24.04." |
instances_restart | — | ✓ | Restart one or more running instances | "Restart instance abc-123." |
instances_terminate | — | ✓ | Terminate one or more instances — permanent and destructive | "Terminate the idle VM I left running yesterday." |
coupon_information | ✓ | ✓ | Look up information about a coupon by code | "What does coupon code SAVE20 do?" |
coupon_accepted_products | ✓ | ✓ | List products a coupon code can be applied to | "Which GPUs can I use SAVE20 on?" |
account_token_validation | ✓ | ✓ | Confirm the bearer token is a valid Massed Compute user API key | "Validate my Massed Compute API key." |
account_billing | ✓ | ✓ | Retrieve the current account balance and billing settings (recharge amount and threshold) | "What's my account balance?" |
ssh_keys_list | ✓ | ✓ | List SSH keys associated with the account | "What SSH keys do I have on my account?" |
ssh_keys_create | — | ✓ | Add a new SSH public key to the account | "Add my work SSH key called 'work-laptop'." |
ssh_keys_delete | — | ✓ | Remove an SSH key from the account — destructive | "Delete the SSH key called 'old-mac'." |
recipes_list | ✓ | ✓ | List published setup recipes (slug, title, summary) | "What setup recipes do you have?" |
recipes_search | ✓ | ✓ | Search recipes by natural-language intent — call this first for install/deploy requests | "Help me set up Ollama on a GPU VM" |
recipes_get | ✓ | ✓ | Fetch full recipe steps by slug | "Show me the jupyter-server recipe" |
If ssh_keys_create fails with -32602, use an existing key from SSH Keys for launch. See Troubleshooting.
Persistent Storage, powered by Backblaze is not available over MCP. There are no storage tools, and instances_launch can't attach storage. Use the website or the REST API instead.
VM passwords
instances_list and instances_get return instance details that include the cleartext VM password. Those two tools redact the password before it reaches the AI assistant, so the credential never lands in chat history. Other tools do not return password data.
You can still see the password yourself:
- On the website under each running instance
- From the REST API at
https://vm.massedcompute.com/api/v1/instance/{uuid}with the same Bearer token