list_machines
List machines
List the Macs on this Halfpenny Mac account: name, status (active/awaiting_payment/…), whether online, tier and spec, macOS version, backups, Tailscale host, billing. Start here to find a machine id or name.
Parametersinclude_cancelled
One machine by id or name, with everything list_machines shows.
Parametersmachinerequired
machine_status
Live machine status
Live checks for a machine right now: online (from Tailscale and the last heartbeat), Tailscale invite accepted, whether a connection has ever been made, and where a restart is (queued, restarting, online, late, failed).
Parametersmachinerequired
get_credentials
Get credentials
SENSITIVE. Returns the macOS username and password, the Tailscale host and invite link, and the SSH relay key for a machine. Needs a token with the connect scope. Every call is logged on the account. Only use when the user asks to connect or needs the password.
Parametersmachinerequired
restart_machine
Restart machine
Queue a restart of the Mac (needs the manage scope; owners only). The Mac reboots about a minute after the agent picks the job up; 10-minute cooldown; refused while FileVault is on. Returns an action; poll get_action or machine_status to see it come back.
Parameterswaitmachinerequired
rotate_password
Rotate macOS password
Issue a new macOS password for the machine (needs the manage scope; owners only). Returns an action; when it succeeds, get_credentials shows the new password.
Parameterswaitmachinerequired
Install pending macOS updates on the machine (needs the manage scope). Minor updates install, with a restart where needed; a major upgrade is only reported.
Parametersmachinerequired
Recent actions (restarts, password rotations, macOS updates, bundle installs) on a machine, newest first.
Parameterslimitmachinerequired
The current status of an action by id.
Parametersaction_idrequired
Tiers Halfpenny Mac rents, with prices (in the account's billing currency, or gbp/usd on request), lead times and live stock.
Parameterscurrency
The account and token this server acts as, and the token scopes.
Takes no parameters.