manage_client
Update a UniFi network client's name to a descriptive alias. Replace generic MAC-only names with convention-based labels like 'phone-pedro'.
Instructions
Set or update the friendly name (alias) for a network client. Use this to replace MAC-only or generic hostnames with descriptive names. Convention: {type}-{owner-or-purpose} — e.g. 'phone-pedro', 'laptop-work', 'tv-living-room', 'speaker-kitchen'. Identify the client's MAC from list_clients first. Uses the classic Network Application REST API (the integration API v1 does not support client updates).
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": {
"action": "<action>",
"macAddress": "<macAddress>",
"name": "<name>"
},
"name": "manage_client"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | Operation to perform | |
| macAddress | Yes | Client MAC address (from list_clients), e.g. 'aa:bb:cc:dd:ee:ff' | |
| name | Yes | Friendly name for the client. Convention: {type}-{owner-or-purpose}, e.g. 'phone-pedro', 'laptop-work', 'tv-living-room', 'speaker-kitchen' |