Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
UNIFI_TOOLSNoComma-sep allowlist of categories.
MCP_HTTP_HOSTNoHTTP bind host127.0.0.1
MCP_HTTP_PORTNoHTTP listen port3000
MCP_TRANSPORTNohttp to enable Streamable HTTP transportstdio
UNIFI_API_KEYYesAPI key from unifi.ui.com (any admin role)
UNIFI_API_URLNoAPI base URLhttps://api.ui.com/v1
UNIFI_DISABLENoComma-sep denylist. Ignored when UNIFI_TOOLS is set.
MCP_HTTP_TOKENNoBearer token. Required when MCP_TRANSPORT=http
MCP_HTTP_SKIP_AUTHNoSkip Bearer authfalse
UNIFI_API_KEY_OWNERNoOwner-role API key — enables 35 Cloud Connector tools. If your key has owner role, set this to the same value.

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
list-sites-overviewA

Get a health overview of all UniFi sites with status, issues, and device counts

analyze-site-healthA

Analyze health of a specific site by name (e.g., 'USM'). Returns device status, WAN info, reboot detection

detect-recent-rebootsB

Detect devices that rebooted within a time window. Checks all sites by default

compare-sitesA

Side-by-side comparison of all (or selected) sites: device count, online %, WAN avg/min uptime, gateway. Use to spot fleet outliers.

firmware-inventoryB

Group all devices by firmware version + model and surface outdated devices. Helps detect fleet inconsistency and pending upgrades.

wan-uptime-trendA

Aggregate WAN uptime across all sites with severity flagging (default threshold 95%). Returns per-WAN sorted by lowest uptime first.

top-clients-by-bandwidthA

Top N clients by bandwidth on a site (combined / tx-only / rx-only). Requires Cloud Connector (UNIFI_API_KEY_OWNER).

list-hostsA

List all UniFi console hosts (UDM, UDM Pro, Cloud Key, etc.)

get-hostC

Get detailed information about a specific host by ID

list-sitesA

List all sites with statistics (device counts, WAN status, ISP info)

list-devicesB

List all devices across hosts (switches, APs, gateways, cameras)

get-isp-metricsC

Get ISP performance metrics. May be unavailable depending on account

query-isp-metricsC

Query ISP metrics with filters. May be unavailable depending on account

list-sdwan-configsB

List all SD-WAN configurations

get-sdwan-configB

Get a specific SD-WAN configuration by ID

get-sdwan-config-statusB

Get the status of a specific SD-WAN configuration

summarize-siteA

Deep aggregated site view: devices + WAN status + (opt) clients + networks + WiFi broadcasts in one call. Replaces 4-5 round-trips. Connector-dependent fields auto-skip when owner key absent. Renders an Apps SDK card on ChatGPT clients (Claude clients receive the same JSON text).

site-health-timelineA

Per-site health snapshot over a lookback window: devices with stability scores, reboots, WAN uptime, optional client count. Replaces 5+ sequential calls (devices + wan + reboots + clients). Caveats[] surfaces partial-data and API limitations.

search-toolsA

Discover available tools by natural language query. Returns matching tool names + descriptions across all categories. Use this first to navigate the 51+ tool surface efficiently.

Prompts

Interactive templates invoked by user choice

NameDescription
triage-site-degradationInvestigate a site's health, recent reboots, client impact, and WAN status to produce a triage summary.
firmware-rollout-auditAudit a firmware rollout: which hosts/devices are on the target version, which are lagging, and what to upgrade next.
wan-uptime-reportCompute a WAN uptime SLA-style report for a site over a window, with relative ranking against the fleet.
cross-site-anomaly-detectionCompute fleet medians across sites and flag sites that deviate >2σ from the median on key health metrics.
msp-onboard-site-checklistValidate that a newly-added site has the firmware, config, and security baselines an MSP would require before going live.
msp-monthly-client-reportGenerate the monthly customer-facing health report for one site (uptime, devices, top consumers, anomalies, recommended actions).
msp-fleet-firmware-planPlan a multi-wave firmware upgrade across all sites, ordered by risk-tolerance, with concrete maintenance windows.
msp-bandwidth-complaint-investigationTriage a customer bandwidth complaint by correlating WAN uptime, top consumers, and (when connector is available) DPI category breakdowns.

Resources

Contextual data attached and managed by the client

NameDescription
devicesAll devices across all sites with status, model, firmware
reboots-recentRecent reboot events (last 24h) across all reachable sites
hostsAll UniFi consoles (UDM, UDM Pro, Cloud Key) with status
summarize-site-cardApps SDK UI template rendered with summarize-site tool output

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/us-all/unifi-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server