otherapi_key

UniFi

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.

Verdict

The UniFi MCP connects Switchy to your UniFi network infrastructure — routers, switches, access points, and SD-WAN configs. @mention it to pull device health, ISP performance metrics, site topology, or SD-WAN deployment status without opening the UniFi console. Network admins and DevOps teams get the most value: you can triage connectivity issues, audit device configs, or check tunnel status from inside a Project. Requires a UI account with owner or super admin privileges; read-only API key means you can query but not change settings.

Common use cases

  • Diagnose ISP latency spikes during outages
  • Audit which devices need firmware updates
  • Check SD-WAN tunnel health before deployments
  • Compare site uptime across branch offices
  • Generate network inventory for compliance reports

Integration

Vendor
UniFi
Category
other
Auth
API_KEY
Tools
9
Composio slug
unifi

Tools

  • Get Host

    Get detailed information for one UniFi host by the Site Manager host ID returned by List Hosts.

  • Get ISP Metrics

    Get ISP performance metrics for all accessible sites, optionally limited by a relative duration or explicit timestamp bounds.

  • Get SD-WAN Config

    Get the topology and settings of one SD-WAN configuration by ID.

  • Get SD-WAN Config Status

    Get deployment, generation, WAN, tunnel, warning, and error status for one SD-WAN configuration.

  • List Devices

    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.

  • List Hosts

    List UniFi hosts associated with the connected UI account. Use the returned host IDs with device filters, site metrics, and host detail tools.

  • List SD-WAN Configs

    List the SD-WAN configurations associated with the connected UI account.

  • List Sites

    List sites from UniFi Network applications associated with the connected UI account. Use returned host and site IDs for selected-site ISP metrics.

  • Query ISP Metrics

    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 only the accessible subset with HTTP 200.

Setup

Setup guide

  1. 11. Open your Switchy workspace and navigate to Settings > Integrations > Browse MCP Servers. 2. Find UniFi in the list and click Connect. 3. You'll be prompted to paste a UniFi API key — generate one by logging into your UniFi console, going to Settings > API, and creating a read-only key (copy it immediately; you won't see it again). 4. Paste the key into Switchy and click Authorize. 5. Switchy confirms the connection by listing your accessible hosts. 6. Open any Project and type '@UniFi list hosts' in the chat to verify the integration works — you should see a table of your UniFi controllers and their IDs. 7. Use those host IDs in follow-up prompts to filter devices or pull site metrics.

What teammates see: by default, memories from UniFi are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Projects have used this MCP together with a given model.

How Switchy teams use it

Not enough Projects yet to publish anonymised usage stats (we require ≥ 50 Projects per week).

Starter prompts

List All Managed Devices

@UniFi list all devices across my hosts and show their model, firmware version, and last-seen timestamp.

Check ISP Performance

@UniFi get ISP metrics for all sites in the last 24 hours and flag any with packet loss above 1%.

Audit SD-WAN Configs

@UniFi list all SD-WAN configurations and include their current deployment status and any warnings.

Site Health Summary

@UniFi list sites, then for the site with ID [paste ID] show device count, ISP metrics, and any offline devices.

Firmware Update Report

@UniFi list devices and group them by firmware version, then highlight any running versions older than 6 months.

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@UniFi list all devices at our main office site and show me which ones haven't checked in during the past 24 hours

Output

Found 47 devices across your main office site. 44 devices are online and reporting normally. 3 devices have not checked in within the last 24 hours: (1) AP-Conference-Room-B (U6-Pro, last seen 26 hours ago), (2) SW-Warehouse-02 (USW-24-POE, last seen 31 hours ago), (3) AP-Loading-Dock (UAP-AC-LR, last seen 38 hours ago). All three devices are showing as 'disconnected' in the controller. The warehouse switch may need physical inspection given its extended offline period.

Notes

This example combines List Devices with timestamp filtering to surface connectivity issues. Requires API key with read access to the target site. Device state reflects the most recent controller sync — if the UniFi controller itself is behind on polling, results may lag real-world status by several minutes.

Prompt

@UniFi get the current SD-WAN configuration status for our multi-site setup and tell me if there are any tunnel failures or warnings

Output

Retrieved status for SD-WAN config 'Multi-Site-Primary' (ID: sdwan_abc123). Deployment generation 47 is active across 5 sites. Tunnel health: 18 of 20 tunnels are up. 2 tunnels show degraded status: Site A ↔ Site D (packet loss 4.2%, latency spikes to 180ms), Site B ↔ Site E (intermittent drops, 3 reconnects in past hour). No critical errors. One warning flagged: Site C gateway firmware is one version behind the others, which may cause policy sync delays.

Notes

This example demonstrates Get SD-WAN Config Status for proactive network monitoring. Useful for diagnosing multi-site connectivity before users report issues. Note that tunnel metrics reflect the controller's last measurement cycle (typically 1-5 minutes). Write access is not required, but you need visibility into the SD-WAN config itself.

Prompt

@UniFi pull ISP performance metrics for the last 7 days across all our sites and identify which location has the worst uplink reliability

Output

Analyzed ISP metrics across 5 sites over the past 7 days. Site rankings by uplink reliability: (1) HQ - 99.97% uptime, avg latency 12ms, (2) Branch-North - 99.89% uptime, avg latency 18ms, (3) Branch-West - 99.76% uptime, avg latency 22ms, (4) Branch-South - 98.34% uptime, avg latency 31ms, (5) Branch-East - 96.12% uptime, avg latency 47ms. Branch-East experienced 11 outage events totaling 6.8 hours downtime, with 4 events exceeding 30 minutes. Peak packet loss during business hours averaged 2.1%. Consider escalating with the ISP or evaluating a secondary uplink for this location.

Notes

This example showcases Get ISP Metrics with historical aggregation, letting the AI synthesize reliability trends from raw telemetry. The MCP returns time-series data; the AI's summary makes it actionable. Metrics depend on the UniFi gateway's WAN monitoring being enabled at each site. Large date ranges may hit API rate limits on accounts with many sites.

Use-case deep-dives

Multi-site network troubleshooting

When this MCP wins for distributed IT teams

A 6-person IT team managing UniFi gear across 12 retail locations hits a Friday afternoon outage. The on-call engineer pulls ISP metrics and device status across all sites in one Switchy thread instead of logging into each controller separately. This MCP is the right call when you're already on UniFi and your team needs to correlate network events across multiple sites without switching contexts. The API key setup is straightforward if you're a super admin. The threshold: if you're troubleshooting a single site or your team doesn't have owner-level access, the web console is faster. For multi-site correlation during incidents, this MCP cuts your mean-time-to-context from 15 minutes to under two.

SD-WAN deployment validation

When this MCP handles post-deployment checks

A 3-person MSP team deploys SD-WAN configs for a client with four branch offices and needs to verify tunnel status and error states before signing off. They use the SD-WAN config and status tools in a Switchy workspace to pull deployment health across all sites in one pass, then document findings in the same thread. This MCP is ideal when you're managing SD-WAN at small-to-medium scale and need programmatic access to topology and tunnel metrics. The trade-off: if you're only checking one or two configs occasionally, the UniFi console is less setup overhead. For teams running repeatable validation workflows across multiple client networks, this MCP turns a 20-minute checklist into a 3-minute query.

Client reporting for managed services

When this MCP automates monthly network reports

A 4-person managed services provider sends monthly uptime and performance reports to 8 clients, each running UniFi at 2-5 locations. They use this MCP to pull ISP metrics and device lists by host, then generate summaries in Switchy without exporting CSVs or screenshotting dashboards. This MCP is the right fit when you're already using UniFi for client networks and need structured data for reporting or SLA tracking. The boundary: if your clients are on mixed vendors or you need sub-hourly granularity, you'll hit the API's metric limits. For monthly or weekly reporting at MSP scale, this MCP replaces manual data collection and keeps the entire workflow in one shared workspace.

Frequently asked

What does the UniFi MCP let me do in Switchy?

It pulls network topology, device status, and ISP performance metrics from your UniFi controllers into Switchy. You can query which access points are online, check SD-WAN tunnel health, or compare site-level bandwidth without logging into the UniFi console. Useful for teams managing multi-site networks who want AI to surface connectivity issues or config drift.

Do I need admin access to connect the UniFi MCP?

Yes. The MCP requires an API key from a UI account with owner or super admin privileges on your UniFi hosts. Without that level of access, tools like List Devices and Get SD-WAN Config will return empty results. Generate the key in your UniFi OS console under System Settings, then paste it into Switchy's integration form.

Can the UniFi MCP change device settings or reboot hardware?

No. This MCP is read-only—it fetches device lists, metrics, and SD-WAN status but cannot modify configurations, restart switches, or provision new sites. If you need to make changes, you still open the UniFi controller UI or use Ubiquiti's management API directly. Think of it as a monitoring layer, not a control plane.

Why use this instead of the UniFi mobile app or controller dashboard?

The MCP lets you ask natural-language questions across multiple sites at once—"Which locations had packet loss above two percent yesterday?" or "Show me all offline APs"—without clicking through per-site dashboards. It's faster for teams who manage dozens of sites and want to correlate network health with other data sources already in Switchy.

Who on my team should connect the UniFi integration?

Whoever holds the super admin API key for your UniFi controllers—usually your network engineer or IT lead. Once connected, any Switchy workspace member can query the data, but only the person who added the integration can rotate or revoke the key. The MCP does not consume per-user seats in your UniFi license.

More other MCPs

See all other MCPs →

Data last verified 61 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.