List Hosted Machines
machinesList hosted GPU hardware or retrieve one by machine_id to check status, GPU details, earnings, uptime, unread messages, clients, maintenance, disk warnings, fees, and optional live metrics.
Instructions
For users who host hardware on Meshive: list their machines, or show one by machine_id.
Items include online status, GPU model and count, hourly earnings in USD, uptime rate (0..1) and
unread_messages, the messages from the workspaces using the machine that the host hasn't read (read them with
host_messages).
One machine also shows clients: other users' workspaces that use it, with their pods and storage volumes
(stopped ones too; a pod's ram_request is MiB, a volume's capacity_gb and available_size_gb are GiB and
usage_rate is 0..1). Their workspace ids are what send_host_message takes. It also shows maintenance (every
window with its id and status: upcoming, overdue, in_progress, done or expired), the schedules summary,
the diagnostics boot_report and network_warnings, and fee (platform_fee as a fraction, 0.2 = 20%, and
when a promotional fee ends). disk_warnings lists disk problems as kind, device, since, value and
threshold: stall (the disk stopped responding, new workloads are paused and the machine is unlisted; the
host checks the disk, then lists the machine again), slow (value is ms per write while the disk is lightly loaded)
or full (the system disk /; value is percent used). slow and full leave the machine listed.
Set include_metrics for a single machine's live CPU/RAM/GPU/network usage. In metrics, ram_size is bytes,
the other sizes (ram_allocated, volume sizes, GPU vram_size) are MiB, and network_receive/network_transmit
are bytes per second (x 8 / 1,000,000 for Mbps).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "machines"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| cursor | No | ||
| machine | No | ||
| include_metrics | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||