{"schema_version":"1.0","documentation_url":"https://taskfuel.ai/catalog/manifest/","source":{"type":"provider_specifications","date":"2026-10-15","catalog_url":"https://taskfuel.ai/catalog/"},"capability":{"id":"linux-vm","name":"Rent a Linux VM","description":"A machine your agent can run commands and services on.","category":{"id":"compute","name":"Compute & dev tools"},"url":"https://taskfuel.ai/catalog/#cap-linux-vm","guide_url":null,"related_guide_urls":[],"detail_url":"https://taskfuel.ai/catalog/capabilities/linux-vm.json","providers":[{"name":"vm402","domains":["vm402.com"]},{"name":"Smol Machines","domains":["mpp.orthogonal.com/smolmachines"]}],"price":{"type":"from","amount":0.01,"currency":"USD","unit":null,"basis":"lowest_positive_declared_endpoint_amount","quote_required":true},"example_prompt":"Use TaskFuel to rent a Linux VM for an hour, install Postgres and run my migration.","endpoint_count":28},"endpoints":[{"provider":{"name":"vm402","domain":"vm402.com"},"method":"POST","url":"https://vm402.com/vms","name":"Create a VM (paid: L402 or x402)","description":"No payment → 402 with a lightning invoice (L402) and USDC-on-Base requirements (x402) for hours × rate (default 24h). Pay, then retry with Authorization: L402 <token>:<preimage>, or with the signed x402 payment in the payment-signature header (repeat the same {\"hours\": n} body).","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"range","minimum":0.01,"maximum":7.2,"quote_required":false}},{"provider":{"name":"vm402","domain":"vm402.com"},"method":"POST","url":"https://vm402.com/vms/{id}/topup","name":"Add time (paid: L402 or x402; no VM token needed)","description":"No payment → 402 with a lightning invoice (L402) and USDC-on-Base requirements (x402) for hours × rate. Pay, then retry with Authorization: L402 <token>:<preimage>, or with the signed x402 payment in the payment-signature header (repeat the same {\"hours\": n} body).","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"range","minimum":0.01,"maximum":7.2,"quote_required":false}},{"provider":{"name":"vm402","domain":"vm402.com"},"method":"POST","url":"https://vm402.com/vms/{id}/aliases","name":"Buy a subdomain alias for the VM's URL (paid: flat $0.20 / 200 sats; no VM token needed)","description":"Attaches {name}.vm402.com as an extra name serving the same app (and visibility) as the VM's URL. No payment → 402 with a lightning invoice (L402) and USDC-on-Base requirements (x402) for the flat price. Pay, then retry with the same {\"name\": ...} body and the payment…","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"fixed","amount":0.2,"quote_required":false}},{"provider":{"name":"Smol Machines","domain":"mpp.orthogonal.com/smolmachines"},"method":"GET","url":"https://mpp.orthogonal.com/smolmachines/v1/machines/{id}/files","name":"Download a file from a machine","description":"","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"unlisted","amount":null,"quote_required":true}},{"provider":{"name":"Smol Machines","domain":"mpp.orthogonal.com/smolmachines"},"method":"POST","url":"https://mpp.orthogonal.com/smolmachines/v1/machines/{id}/files","name":"Upload a file to a machine","description":"","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"unlisted","amount":null,"quote_required":true}},{"provider":{"name":"Smol Machines","domain":"mpp.orthogonal.com/smolmachines"},"method":"GET","url":"https://mpp.orthogonal.com/smolmachines/v1/machines/{id}/sessions","name":"List sessions for a machine","description":"","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"unlisted","amount":null,"quote_required":true}},{"provider":{"name":"Smol Machines","domain":"mpp.orthogonal.com/smolmachines"},"method":"POST","url":"https://mpp.orthogonal.com/smolmachines/v1/machines/{id}/sessions","name":"Create a persistent session that preserves working directory and environment across exec calls","description":"","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"unlisted","amount":null,"quote_required":true}},{"provider":{"name":"Smol Machines","domain":"mpp.orthogonal.com/smolmachines"},"method":"POST","url":"https://mpp.orthogonal.com/smolmachines/v1/machines/{id}/code","name":"Run Python or JavaScript code directly in a machine","description":"","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"unlisted","amount":null,"quote_required":true}},{"provider":{"name":"Smol Machines","domain":"mpp.orthogonal.com/smolmachines"},"method":"POST","url":"https://mpp.orthogonal.com/smolmachines/v1/machines/{id}/sessions/{session_id}/exec","name":"Execute a command within a persistent session. Session preserves working directory and environment across calls.","description":"","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"unlisted","amount":null,"quote_required":true}},{"provider":{"name":"Smol Machines","domain":"mpp.orthogonal.com/smolmachines"},"method":"GET","url":"https://mpp.orthogonal.com/smolmachines/v1/machines","name":"List all machines. Use to discover existing machine IDs for recovery or cleanup.","description":"","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"unlisted","amount":null,"quote_required":true}},{"provider":{"name":"Smol Machines","domain":"mpp.orthogonal.com/smolmachines"},"method":"POST","url":"https://mpp.orthogonal.com/smolmachines/v1/machines","name":"Create a new microVM. Minimal example:…","description":"","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"quote_required","amount":null,"quote_required":true}},{"provider":{"name":"Smol Machines","domain":"mpp.orthogonal.com/smolmachines"},"method":"GET","url":"https://mpp.orthogonal.com/smolmachines/v1/machines/{id}/events","name":"Get machine event log","description":"","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"unlisted","amount":null,"quote_required":true}},{"provider":{"name":"Smol Machines","domain":"mpp.orthogonal.com/smolmachines"},"method":"POST","url":"https://mpp.orthogonal.com/smolmachines/v1/machines/{id}/exec","name":"Run a command inside a machine. Pass command as a shell string (\"ls -la\") or argv array ([\"ls\",\"-la\"]). Machine must…","description":"","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"unlisted","amount":null,"quote_required":true}},{"provider":{"name":"Smol Machines","domain":"mpp.orthogonal.com/smolmachines"},"method":"DELETE","url":"https://mpp.orthogonal.com/smolmachines/v1/machines/{id}","name":"Permanently delete a machine and its storage","description":"","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"unlisted","amount":null,"quote_required":true}},{"provider":{"name":"Smol Machines","domain":"mpp.orthogonal.com/smolmachines"},"method":"POST","url":"https://mpp.orthogonal.com/smolmachines/v1/machines/{id}/start","name":"Start a stopped machine","description":"","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"unlisted","amount":null,"quote_required":true}},{"provider":{"name":"Smol Machines","domain":"mpp.orthogonal.com/smolmachines"},"method":"POST","url":"https://mpp.orthogonal.com/smolmachines/v1/machines/{id}/stop","name":"Stop a running machine. Preserves disk state.","description":"","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"unlisted","amount":null,"quote_required":true}},{"provider":{"name":"vm402","domain":"vm402.com"},"method":"POST","url":"https://vm402.com/vms/{id}/exec","name":"Run a command (bash -c) on the VM (free with the VM bearer token)","description":"Not a paid endpoint — requires the Authorization: Bearer <vm token> returned by createVm. Processes do NOT outlive the command — to run a server, register a managed service (PUT /vms/{id}/services/{name}) instead of backgrounding it here.","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"quote_required","amount":null,"quote_required":true}},{"provider":{"name":"vm402","domain":"vm402.com"},"method":"PUT","url":"https://vm402.com/vms/{id}/files","name":"Upload a file (raw bytes) to an absolute path on the VM (free with the VM bearer token)","description":"Not a paid endpoint — requires the Authorization: Bearer <vm token> returned by createVm. Binary-safe, no base64, no JSON size cap. Body is the raw file content. Typical use: upload a tarball, then exec to extract.","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"quote_required","amount":null,"quote_required":true}},{"provider":{"name":"vm402","domain":"vm402.com"},"method":"GET","url":"https://vm402.com/vms/{id}/services","name":"List managed services and their status (free with the VM bearer token)","description":"","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"unlisted","amount":null,"quote_required":true}},{"provider":{"name":"vm402","domain":"vm402.com"},"method":"GET","url":"https://vm402.com/vms/{id}/services/{name}","name":"One service's status (free with the VM bearer token)","description":"","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"unlisted","amount":null,"quote_required":true}},{"provider":{"name":"vm402","domain":"vm402.com"},"method":"PUT","url":"https://vm402.com/vms/{id}/services/{name}","name":"Register (or replace) a managed service — the way to run a server (free with the VM bearer token)","description":"Processes started via exec die when the command returns. A managed service survives sleep/wake and restarts automatically, so the VM's public URL stays live. Set http_port to the port the server listens on — the public URL routes to it and auto-starts the service (one service…","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"quote_required","amount":null,"quote_required":true}},{"provider":{"name":"vm402","domain":"vm402.com"},"method":"DELETE","url":"https://vm402.com/vms/{id}/services/{name}","name":"Stop and remove a managed service (free with the VM bearer token)","description":"","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"unlisted","amount":null,"quote_required":true}},{"provider":{"name":"vm402","domain":"vm402.com"},"method":"GET","url":"https://vm402.com/vms/{id}/services/{name}/logs","name":"Recent service logs (free with the VM bearer token)","description":"","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"unlisted","amount":null,"quote_required":true}},{"provider":{"name":"vm402","domain":"vm402.com"},"method":"POST","url":"https://vm402.com/vms/{id}/services/{name}/{action}","name":"Start, stop, or restart a managed service (free with the VM bearer token)","description":"Restart after deploying new code so the service picks it up.","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"unlisted","amount":null,"quote_required":true}},{"provider":{"name":"vm402","domain":"vm402.com"},"method":"PATCH","url":"https://vm402.com/vms/{id}/url","name":"Set URL visibility (free with the VM bearer token)","description":"Not a paid endpoint — requires the Authorization: Bearer <vm token> returned by createVm.","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"unlisted","amount":null,"quote_required":true}},{"provider":{"name":"vm402","domain":"vm402.com"},"method":"GET","url":"https://vm402.com/vms/{id}/aliases","name":"List the VM's aliases (free with the VM bearer token)","description":"","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"unlisted","amount":null,"quote_required":true}},{"provider":{"name":"vm402","domain":"vm402.com"},"method":"DELETE","url":"https://vm402.com/vms/{id}/aliases/{name}","name":"Remove an alias — frees the name, no refund (free with the VM bearer token)","description":"","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"unlisted","amount":null,"quote_required":true}},{"provider":{"name":"vm402","domain":"vm402.com"},"method":"DELETE","url":"https://vm402.com/vms/{id}","name":"Delete the VM (free with the VM bearer token)","description":"Not a paid endpoint — requires the Authorization: Bearer <vm token> returned by createVm.","supporting_call":false,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"unlisted","amount":null,"quote_required":true}},{"provider":{"name":"Smol Machines","domain":"mpp.orthogonal.com/smolmachines"},"method":"DELETE","url":"https://mpp.orthogonal.com/smolmachines/v1/machines/{id}/sessions/{session_id}","name":"Delete a session","description":"","supporting_call":true,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"unlisted","amount":null,"quote_required":true}},{"provider":{"name":"Smol Machines","domain":"mpp.orthogonal.com/smolmachines"},"method":"GET","url":"https://mpp.orthogonal.com/smolmachines/v1/machines/{id}","name":"Get machine details and status. Poll until ready is true before executing commands.","description":"","supporting_call":true,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"unlisted","amount":null,"quote_required":true}},{"provider":{"name":"vm402","domain":"vm402.com"},"method":"GET","url":"https://vm402.com/vms/{id}/meter","name":"Meter status (public — anyone can check)","description":"","supporting_call":true,"price":{"currency":"USD","unit":null,"basis":"provider_specification","type":"unlisted","amount":null,"quote_required":true}}]}