UISP MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| AUTH_MODE | No | env (default, reads the vars above) or gateway (credentials arrive per-request via the X-UISP-Api-Key / X-UISP-Base-URL headers, injected by the Conduit gateway). | env |
| LOG_LEVEL | No | debug | info (default) | warn | error. | info |
| UISP_API_KEY | No | Account token issued by the UISP console. | |
| MCP_TRANSPORT | No | stdio (default) or http. | stdio |
| UISP_BASE_URL | No | Base URL of the UISP instance, e.g. https://uisp.example.com. | |
| CONDUIT_S2S_SECRET | No | When set, the HTTP transport requires a valid X-Gateway-S2S header (Conduit sidecar auth) on every /mcp request. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| logging | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| uisp_list_sitesA | List sites (network locations - sites, endpoints, and clients - each optionally tied to a UCRM client/service record). Each site's |
| uisp_get_siteB | Get a single site's detail, including its status and (if linked) UCRM client/service reference. |
| uisp_search_sitesC | Search sites, endpoints, and clients by name, address, MAC address, or IP address. |
| uisp_list_site_clientsA | List all client sites belonging to a given (parent) site. |
| uisp_get_site_statisticsA | Get upload/download traffic between a site and its parent site, bucketed by interval. |
| uisp_get_site_traffic_summaryB | Get a site's total upload/download for the given interval up to now. |
| uisp_list_devicesA | List devices (hostname/IP/MAC, status, parent site), optionally filtered by site/type/role/authorization. Each device's |
| uisp_get_deviceB | Get a single device's status overview by ID. |
| uisp_get_device_detailC | Get a single device's detail, optionally including its interfaces and/or connected stations. |
| uisp_get_device_statisticsA | Get device telemetry (CPU/RAM/signal/temperature/throughput) bucketed by interval. |
| uisp_list_device_interfacesA | List a device's network interfaces, including their configured IP addresses and status. |
| uisp_get_device_by_macA | Look up a device by its MAC address. |
| uisp_list_discovered_devicesA | List devices UISP has discovered on the network but which have not yet been added. |
| uisp_list_outagesA | List network outages - UISP's alerting surface - each tied to a site and device. Filter by device, type (outage/unreachable), a text query, or in-progress state. |
| uisp_list_logsB | List the UISP event/audit log (e.g. logins, device state changes, backups, upgrades). Log messages can embed device MAC/IP addresses. Filter by site, device, severity level, event tag, or a text query. |
| uisp_list_data_linksA | List data links - the wireless/wired links UISP has mapped between devices and sites, with signal/frequency/distance detail. |
| uisp_get_data_linkA | Get a single data link's detail by ID. |
| uisp_list_site_data_linksB | List data links attached to a given site. |
| uisp_list_gatewaysA | List gateways - routers configured as network gateways - and their NetFlow/QoS/suspend configuration. |
| uisp_get_gatewayA | Get a single gateway's detail by ID. |
| uisp_list_tasksB | List background tasks (e.g. firmware upgrades, backups, mass operations) and their status. |
| uisp_get_tasks_in_progressA | Get the number of tasks currently in progress. |
| uisp_list_firmwaresA | Get the firmware versions available to UISP for its supported device models. |
| uisp_get_speed_testsA | Get detail about running and recent speed tests. |
| uisp_get_versionA | Get the UISP version, deployment type and build info. Useful as a credential/connectivity sanity check. |
| uisp_get_network_statisticsA | Get network-wide statistics: client/site counts, network health, signal/link/ISP scores, data-link and uplink/downlink utilization, and outage counts. |
| uisp_get_summaryA | Get badge-count-like values across the instance: unread logs/outages/firmwares, active/all client and site counts, devices needing authorization, firmware up-to-dateness. Each *Timestamp param scopes that count to items newer than the given epoch-ms timestamp — pass 0 for the instance's current totals. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 27 tools
Most tools are clearly separated by resource type (sites, devices, data links, gateways, tasks, logs, outages) and action (list/get/search). Minor overlap exists between uisp_list_sites and uisp_search_sites, and between uisp_get_site_statistics and uisp_get_site_traffic_summary, but descriptions clarify the distinction.
The uisp_ prefix is consistent and most tools follow a verb_noun pattern (list_sites, get_site, search_sites). Minor deviations include uisp_get_summary, uisp_get_tasks_in_progress, and uisp_get_speed_tests, which use different noun phrasing but remain readable and predictable.
27 tools is on the higher end but appropriate for a network management platform covering sites, devices, data links, gateways, logs, outages, tasks, and firmware. The count is justified by the breadth of the domain, though it approaches the upper bound of a well-scoped server.
The surface covers the main read-only monitoring and inventory workflows for UISP: sites, devices, data links, gateways, logs, outages, tasks, and network statistics. Missing write operations (e.g., authorize devices, create sites, manage tasks) are notable but the server appears intentionally read-only, so the gap is acceptable for its apparent purpose.