List traffic flows
unifi_list_traffic_flowsList recent UniFi gateway traffic flows with source, destination, app, action, risk, bytes and matched policies. Filter by client, IP, domain, action, risk or search; defaults to the last 15 minutes.
Instructions
List recent traffic flows seen by the gateway (Insights > Flows): source and destination client, IP, domain and network, app/service, allowed or blocked, risk, bytes and the policies that matched. This is an expensive query on the gateway, so it looks back 15 minutes (hours: 0.25) and returns 50 flows per page by default; narrow it with client_mac, action, risk or search (applied by the controller to app, domain, client name and more) before widening the window. Recent Network 9.x/10.x with a UniFi gateway.
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_traffic_flows"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| raw | No | Return the full controller objects (large) | |
| page | No | Page number, from 0 | |
| risk | No | Only flows with this risk level | |
| site | No | Site name/ID as used in the API (e.g. 'default'). Defaults to the configured site. See unifi_list_sites. | |
| hours | No | Look back this many hours (default 0.25, i.e. 15 minutes) | |
| action | No | Only allowed or only blocked flows | |
| 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 | |
| client_ip | No | Only flows from this source IP | |
| page_size | No | Flows per page (default 50) | |
| client_mac | No | Only flows from this client MAC address | |
| destination_domain | No | Only flows to this domain |