Monitor and control UniFi devices with AI

The UniFi MCP Server gives your AI assistant full visibility into every device on your network—access points, switches, and gateways—and the ability to control them through plain English. You can ask your AI to show you which devices are offline, restart a misbehaving access point, or flash an LED to locate a device on the shelf, without opening the UniFi console.

What you can do

List and inspect devices

Query all devices on a site, filter by type, or search by name, MAC address, or IP.

Real-time statistics

Pull live CPU, memory, uptime, and bandwidth stats for any device.

Device control

Restart devices, flash locator LEDs, and trigger firmware upgrades.

Client management

Block, unblock, and reconnect clients directly from your AI assistant.

Listing and finding devices

You can list all devices on a site, filter by device type, or search by name, MAC, or IP address. Example prompts:

“Show me all offline devices”
“List all access points on the main site”
“Find the device with IP 192.168.2.50”
“Which switches are in the network?”

Tools used: list_devices_by_type, search_devices, get_device_details

List by type
Search devices
Get device details

# List all access points
result = await mcp.call_tool("list_devices_by_type", {
    "site_id": "default",
    "device_type": "uap"
})

Response:

[
  {
    "id": "507f1f77bcf86cd799439011",
    "name": "Lobby AP",
    "model": "U6-LR",
    "type": "uap",
    "mac": "aa:bb:cc:dd:ee:ff",
    "ip": "192.168.2.100",
    "state": 1,
    "uptime": 86400,
    "version": "6.5.55.14277"
  }
]

# Search by name, MAC, or IP
result = await mcp.call_tool("search_devices", {
    "site_id": "default",
    "query": "lobby"
})

result = await mcp.call_tool("get_device_details", {
    "site_id": "default",
    "device_id": "507f1f77bcf86cd799439011"
})

Device type codes

Code	Device type
`uap`	Access point
`usw`	Switch
`ugw`	Gateway
`udm`	UniFi Dream Machine
`uxg`	Next-gen gateway

Real-time device statistics

The get_device_statistics tool returns live data for any device. Example prompt: “What is the CPU and memory usage on the conference room AP?”

result = await mcp.call_tool("get_device_statistics", {
    "site_id": "default",
    "device_id": "507f1f77bcf86cd799439011"
})

Response:

{
  "device_id": "507f1f77bcf86cd799439011",
  "uptime": 86400,
  "cpu": 15,
  "mem": 42,
  "tx_bytes": 1024000000,
  "rx_bytes": 2048000000,
  "state": 1,
  "uplink_depth": 0
}

uplink_depth of 0 means the device is directly connected to the gateway. Higher values indicate the device is further down the network tree.

Controlling devices

All device control operations are mutating—they change the state of your hardware. For safety, every mutating tool requires you to pass confirm=True. You can also pass dry_run=True to preview what would happen without making any changes.

Mutating operations such as restart, locate, and firmware upgrade require confirm=True. Omitting this flag causes the tool to return an error. All operations are recorded in audit.log.

Restart a device

Example prompts:

“Restart the access point in the lobby”
“Reboot the switch in server room 2”

# Preview first
preview = await mcp.call_tool("restart_device", {
    "site_id": "default",
    "device_mac": "aa:bb:cc:dd:ee:ff",
    "dry_run": True
})

# Execute
result = await mcp.call_tool("restart_device", {
    "site_id": "default",
    "device_mac": "aa:bb:cc:dd:ee:ff",
    "confirm": True
})

Locate a device (LED blink)

The locate tool flashes the LED on a physical device so you can find it in a rack or ceiling. Example prompt: “Flash the LED on the access point named ‘Warehouse-AP-3’ so I can find it”

result = await mcp.call_tool("locate_device", {
    "site_id": "default",
    "device_mac": "aa:bb:cc:dd:ee:ff",
    "enabled": True,
    "confirm": True
})

Pass "enabled": False to turn the locator off again.

Upgrade firmware

Example prompt: “Upgrade the firmware on the gateway”

result = await mcp.call_tool("upgrade_device", {
    "site_id": "default",
    "device_mac": "aa:bb:cc:dd:ee:ff",
    "confirm": True
})

Firmware upgrades cause a brief device restart. Connected clients will temporarily lose connectivity during the upgrade, which typically takes 2–5 minutes.

Client management

You can block, unblock, and reconnect individual clients on the network through your AI assistant. These operations also require confirm=True. Example prompts:

“Block the device with MAC aa:bb:cc:dd:ee:01 from the network”
“Reconnect John’s laptop”
“Unblock the IoT sensor I blocked yesterday”

Find the client

result = await mcp.call_tool("search_clients", {
    "site_id": "default",
    "query": "johns-laptop"
})

Block the client

result = await mcp.call_tool("block_client", {
    "site_id": "default",
    "client_mac": "aa:bb:cc:dd:ee:01",
    "confirm": True
})

Unblock when ready

result = await mcp.call_tool("unblock_client", {
    "site_id": "default",
    "client_mac": "aa:bb:cc:dd:ee:01",
    "confirm": True
})

Force client reconnect

Use reconnect_client when a client is stuck or has a stale IP lease.

result = await mcp.call_tool("reconnect_client", {
    "site_id": "default",
    "client_mac": "aa:bb:cc:dd:ee:01",
    "confirm": True
})

Safety mechanisms

Every tool that changes device or client state includes built-in safeguards:

Mechanism	How to use
Confirmation	Pass `confirm=True` to execute any mutating operation
Dry run	Pass `dry_run=True` to preview changes without applying them
Audit log	All operations are automatically written to `audit.log`

When in doubt, always run with dry_run=True first. The AI assistant will show you exactly what would happen before any changes are made.

Getting Started

Installation

MCP Client Setup

Features

Advanced

Monitor and control UniFi devices with AI

What you can do

List and inspect devices

Real-time statistics

Device control

Client management

Listing and finding devices

Device type codes

Real-time device statistics

Controlling devices

Restart a device

Locate a device (LED blink)

Upgrade firmware

Client management

Force client reconnect

Safety mechanisms

​What you can do

List and inspect devices

Real-time statistics

Device control

Client management

​Listing and finding devices

​Device type codes

​Real-time device statistics

​Controlling devices

​Restart a device

​Locate a device (LED blink)

​Upgrade firmware

​Client management

​Force client reconnect

​Safety mechanisms

What you can do

Listing and finding devices

Device type codes

Real-time device statistics

Controlling devices

Restart a device

Locate a device (LED blink)

Upgrade firmware

Client management

Force client reconnect

Safety mechanisms