Run a read-only diagnostic
diagnoseRun one bounded, read-only diagnostic program on the selected Mac or a linked server. Arguments are passed directly, never through a shell, and time limits are applied. argv[0] must be one of: ping, ping6, dig, nslookup, host, traceroute, nc (with -z), curl (GET/HEAD), ifconfig, netstat, route, arp, ipconfig (get* only), networksetup (read-only queries), scutil, sysctl, df, uptime, vm_stat, uname, sw_vers, brew (list/info/services list), apachectl configtest, nginx -t, php (-v/-m/-i/--ini/-l), php-config; on Linux targets also nvme, iscsiadm, lsscsi, multipath -ll and InfiniBand status tools. ["oclp"] returns a macOS update-safety report for Macs using OpenCore Legacy Patcher. Anything else is refused by the Mac.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"argv": "<argv>"
},
"name": "diagnose"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| argv | Yes | Program and arguments, e.g. ["dig","example.com","MX"] or ["uptime"]. | |
| mac_id | No | Opaque id of one of this account's FrontierStack Macs. Optional only when exactly one Mac is online. | |
| target | No | Optional linked server, by the name or host FrontierStack knows it by, to run on over SSH. Omit for the selected Mac itself. |