List connected clients
unifi_list_clientsList currently connected UniFi clients with IP, network, AP or switch port, signal, rates, usage, and uptime; filter by wired/wireless, guests, network, or access point.
Instructions
List the clients connected now, with IP, network, AP or switch port, signal, rates, usage and uptime; filter by connection type, guests, network or AP. For offline clients and stored settings (alias, fixed IP, blocked) use unifi_list_known_clients. For connection history use unifi_list_client_sessions.
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_clients"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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. | |
| limit | No | Maximum items to return (default 200) | |
| ap_mac | No | Only clients of this access point | |
| 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 | |
| network | No | Only clients on this network (name) | |
| connection | No | Filter by connection type (default all) | |
| guests_only | No | Only guest clients |