UniFi: Request
unifi_requestCall any UniFi Integration API endpoint directly to handle unwrapped resources like VPNs, ACL rules, and DPI tables; only GET requests are allowed unless writes are explicitly enabled.
Instructions
Escape hatch: call any Integration API endpoint directly, for the parts of the API this server does not wrap — switch stacks, LAG, VPN servers, RADIUS profiles, WAN interfaces, device tags, ACL rules, DNS policies and the DPI reference tables. Paths are relative to the API root, so /sites and /sites/<uuid>/wans, and the site must be a real UUID here — this tool does NOT resolve site names, so get one from unifi_list_sites first. Writes are DISABLED: only GET is permitted. Set UNIFI_ALLOW_WRITES=1 to allow mutations, which also registers the purpose-built write tools.
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": {
"path": "<path>"
},
"name": "unifi_request"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | No | JSON request body, for POST, PUT and PATCH. Sent verbatim. | |
| path | Yes | Path relative to the Integration API root, starting with `/` — e.g. `/info`, `/sites`, `/sites/<site-uuid>/wans`. Not a full URL. | |
| query | No | Query parameters, e.g. `{"limit": 50, "filter": "state.eq('OFFLINE')"}`. | |
| method | No | HTTP method. Only GET is available while writes are disabled. | GET |
| revealSecrets | No | Return passphrases and keys in clear instead of masked as `[redacted]`. Only when the user has explicitly asked to see or work with the real value — results land in transcripts. |