Tools reference
The MCP server exposes 14 tools. The columns below show which API key tier sees each tool in the assistant's tool list. Use a read-only key when the assistant only needs to read your account state; use a full-access key when it needs to launch, restart, terminate, or manage SSH keys. Tools that a read-only key cannot see are hidden from the assistant entirely — they cannot be invoked accidentally or by prompt injection.
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'." |
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.