List switch ports
unifi_list_switch_portsList a UniFi switch's ports to inspect link state, speed, PoE, assigned profiles, LLDP neighbors, link aggregation, and per-port overrides for troubleshooting.
Instructions
List a switch's ports with link state, speed, PoE, assigned profile, LLDP neighbours (what is plugged in: chassis ID, description and remote port), link aggregation and any per-port overrides configured on the device.
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_list_switch_ports"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| up | No | Only ports whose link is up (true) or down (false) | |
| mac | Yes | MAC address of the switch | |
| site | No | Site name/ID as used in the API (e.g. 'default'). Defaults to the configured site. See unifi_list_sites. | |
| 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 |