Tools reference
The MCP server exposes 17 tools. The columns below show which API key (or OAuth grant) tier sees each tool in the assistant's tool list. Use a read-only credential when the assistant only needs to read your account state; use a full-access credential when it needs to launch, restart, terminate, or manage SSH keys. Tools that a read-only credential cannot see are hidden from the assistant entirely — they cannot be invoked accidentally or by prompt injection.
When someone asks to install, configure, or spin up software on a VM, call recipes_search first. Recipes encode the right image, SKU, and steps. recipes_list is for browsing the catalogue; recipes_get loads the full markdown by slug.
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 the Ubuntu 22 image." |
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 billing settings (recharge amount and threshold) | "What's my recharge configuration?" |
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 setup-recipe metadata (slug, title, tags) | "What can I set up on a Massed Compute VM?" |
recipes_search | ✓ | ✓ | Find a setup recipe from a natural-language intent — call this first for install/deploy requests | "Set up nginx as a reverse proxy." |
recipes_get | ✓ | ✓ | Fetch the full markdown body for a recipe slug | "Get the jupyter-server recipe." |
VM passwords
instances_list and instances_get are the two tools that return instance details — and instance details include the cleartext VM password. Those two tools redact the password before it reaches the AI assistant, so the credential never lands in your chat history. None of the other tools return password data in the first place, so there's nothing to redact.
You can still see the password yourself in two places:
- 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.