---
description: UniFi MCP Fix - Working solution with API key authentication
created: 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:**
```bash
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:**
```bash
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

---