List client sessions
unifi_list_client_sessionsList client connection sessions newest first, with IP, connect/disconnect times, duration, AP, SSID, network, and bytes; filter by MAC, guest/user, time range, and site.
Instructions
List client connection sessions, newest first (default last 168 hours): client, IP, connect and disconnect times, duration, AP, SSID, network and bytes; filter by client MAC or guest/user. For who is connected now use unifi_list_clients.
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": "unifi_list_client_sessions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mac | No | Only sessions for this client | |
| site | No | Site name/ID as used in the API (e.g. 'default'). Defaults to the configured site. See unifi_list_sites. | |
| type | No | Client type (default all) | |
| hours | No | Look back this many hours (default 168) | |
| limit | No | Maximum items to return (default 100) | |
| fields | No | Only return these fields per item (dot paths, e.g. uplink.name) | |
| search | No | Case-insensitive substring match on names, MACs, IPs and similar |