Files

Annie Tunturi d4732a93a8 feat: complete UniFi MCP rebuild

- Found working solution: system unifi_mcp package
- API key authentication working (10.10.20.3)
- Uses stdio transport (not HTTP)
- 25 tools registered
- Documented: projects/unifi-mcp-fixed.md
- Todo marked complete

2026-03-22 17:18:31 -04:00

1.6 KiB

Raw Blame History

description, created

description	created
UniFi MCP Fix - Working solution with API key authentication	2026-03-22

UniFi MCP Fixed

Problem

Original UniFi MCP skill was broken:

Port 3011 unreachable
Used username/password auth (failed with 403)
Code didn't support API keys

Solution Found

Working package: /home/ani/.local/lib/python3.13/site-packages/unifi_mcp/

Supports API key authentication ✅
Uses stdio transport (not HTTP) ✅
Successfully connects to UniFi controller ✅

Authentication

Uses API key from ~/.config/unifi-mcp/.env:

UNIFI_HOST=10.10.20.3
UNIFI_PORT=443
UNIFI_SITE=W.I.U.F
UNIFI_API_KEY=69wz0HX7awf9p499_9ZsjIsPnOQYrwns
UNIFI_VERIFY_SSL=false

How to Use

Direct:

export UNIFI_HOST=10.10.20.3
export UNIFI_PORT=443
export UNIFI_SITE=W.I.U.F
export UNIFI_API_KEY=69wz0HX7awf9p499_9ZsjIsPnOQYrwns
export UNIFI_VERIFY_SSL=false
python3 -m unifi_mcp

Via skill wrapper:

cd ~/.letta/skills/unifi-network-mcp
./unifi-mcp.sh

Transport Note

This MCP uses stdio transport, not HTTP port 3011.

Stdio = standard MCP protocol
HTTP port 3011 = old broken approach
Letta can use stdio transport directly

Tools Available (25 total)

Device management
Client listing
Network/VLAN configuration
Firewall rules
VPN management
Statistics and monitoring

Status

✅ Working - API key auth successful ✅ Connected - UniFi controller at 10.10.20.3 ✅ Ready - 25 tools registered

Files

~/.letta/skills/unifi-network-mcp/ - Current (working)
~/.letta/skills/unifi-network-mcp-old/ - Backup (broken)
~/.config/unifi-mcp/.env - API credentials

1.6 KiB Raw Blame History