# UniFi — MCP server on mcp.ai
> Connect your UniFi account and use 9 tools for internet of things straight from your AI agent. Connect with your own API key. Monitor UniFi Site Manager inventory, internet health metrics, and SD-WAN configurations across the connected UI account's sites. This toolkit excludes arbitrary Cloud Connector requests and all local Network, Protect, Mobility, Carrier Fabric, and InnerSpace API surfaces.

By: mcp.ai · official
Page: https://mcp.ai/unifi

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_unifi?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/unifi/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/unifi/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/unifi/skill.md
Postman collection (v2.1): https://mcp.ai/unifi/postman.json

## Tools
- unifi_get_host(host_id: string) — Get detailed information for one UniFi host by the Site Manager host ID returned by List Hosts.
- unifi_get_isp_metrics(duration?: string, interval: string, end_timestamp?: string, begin_timestamp?: string) — Get ISP performance metrics for all accessible sites, optionally limited by a relative duration or explicit timestamp bounds.
- unifi_get_sd_wan_config(config_id: string) — Get the topology and settings of one SD-WAN configuration by ID.
- unifi_get_sd_wan_config_status(config_id: string) — Get deployment, generation, WAN, tunnel, warning, and error status for one SD-WAN configuration.
- unifi_list_devices(host_ids?: string[], page_size?: integer, next_cursor?: string, updated_after?: string) — List UniFi devices managed by hosts where the connected UI account is an owner or super admin. Results are grouped by host and can be filtered by host ID or by the last processed device timestamp.
- unifi_list_hosts(page_size?: integer, next_cursor?: string) — List UniFi hosts associated with the connected UI account. Use the returned host IDs with device filters, site metrics, and host detail tools.
- unifi_list_sd_wan_configs() — List the SD-WAN configurations associated with the connected UI account.
- unifi_list_sites(page_size?: integer, next_cursor?: string) — List sites from UniFi Network applications associated with the connected UI account. Use returned host and site IDs for selected-site ISP metrics.
- unifi_query_isp_metrics(sites: object[], interval: string) — Get ISP performance metrics for selected host/site pairs. Each site can specify its own RFC3339 time bounds. Always inspect partial_success, status, and message: UniFi can return usable metrics for on

## Example prompts
- "What can I do in UniFi?"
- "Show me a summary of my UniFi account"

## Links
Docs: https://mcp.ai/docs/mcps/unifi
Website: https://mcp.ai/mcps/unifi