WIz MCP Server

Minimal MCP server exposing Wiz light control tools over UDP.

Tools

• get_status(ip, include_raw=false)

  • Returns a normalized LightStatus-like object
  • Optional raw UDP response when include_raw=true

• set_color(ip, r, g, b, dimming=null, fetch_status=false, include_raw=false)

  • Sends setPilot with RGB (and optional dimming)
  • Optionally fetches a fresh status after setting

Run

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python3 server.py

Notes

• Uses UDP port 38899 for Wiz bulbs
• If you see Operation not permitted, run on a host that allows UDP