Get client details
unifi_get_clientRetrieve a UniFi client by MAC to view stored settings merged with live connection details and an online flag; returns an error if the controller has never seen the MAC.
Instructions
Get one client by MAC: its stored settings (alias, note, fixed IP, blocked) merged with live connection details when it is connected, and an online flag. Errors if the controller has never seen 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": {
"mac": "<mac>"
},
"name": "unifi_get_client"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mac | Yes | MAC address, e.g. aa:bb:cc:dd:ee:ff | |
| raw | No | Return the full controller objects (large) | |
| site | No | Site name/ID as used in the API (e.g. 'default'). Defaults to the configured site. See unifi_list_sites. |