---
title: "UniFi integration for LuumenAI"
url: "https://www.luumen.ai/integrations/unifi/"
entity: SoftwareIntegration
category: "Monitoring & observability"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# UniFi integration for LuumenAI

Read UniFi sites, devices, ISP metrics, and SD-WAN status from the terminal

## What LuumenAI can do with UniFi

LuumenAI connects to UniFi with an API token and exposes 9 tools (9 read-only). Every tool is read-only, so it can answer questions from UniFi but cannot change anything in it. Read actions still follow the configured access and approval policy.

## Key facts

- Authentication: API token
- Tools available: 9 tools (9 read-only)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: Monitoring & observability

## About UniFi with LuumenAI

Ask about your UniFi estate and get an answer. UNIFI_LIST_HOSTS and UNIFI_LIST_SITES map what the connected UI account can see, UNIFI_LIST_DEVICES covers the hardware under it, and UNIFI_GET_ISP_METRICS shows how each internet link has been behaving. When an SD-WAN change looks suspect, UNIFI_GET_SD_WAN_CONFIG_STATUS reports deployment, tunnel, and error state. This toolkit is read-only, authenticated with an API key.

## Example tools

Read-only (9 in total):

- `UNIFI_GET_HOST` — Get detailed information for one UniFi host by the Site Manager host ID returned by List Hosts.
- `UNIFI_GET_ISP_METRICS` — Get ISP performance metrics for all accessible sites, optionally limited by a relative duration or explicit timestamp bounds.
- `UNIFI_GET_SD_WAN_CONFIG` — Get the topology and settings of one SD-WAN configuration by ID.
- `UNIFI_GET_SD_WAN_CONFIG_STATUS` — Get deployment, generation, WAN, tunnel, warning, and error status for one SD-WAN configuration.
- `UNIFI_LIST_DEVICES` — List UniFi devices managed by hosts where the connected UI account is an owner or super admin.
- `UNIFI_LIST_HOSTS` — List UniFi hosts associated with the connected UI account.
- `UNIFI_LIST_SD_WAN_CONFIGS` — List the SD-WAN configurations associated with the connected UI account.
- `UNIFI_LIST_SITES` — List sites from UniFi Network applications associated with the connected UI account.

## Frequently asked questions

### How does LuumenAI connect to UniFi?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in UniFi on its own?

No. Every one of the 9 tools is read-only, so LuumenAI can answer questions from UniFi but cannot change anything in it. Read actions still follow the configured access and approval policy.

### Is there an audit trail?

Every call to UniFi is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/unifi/