Chat with your Wi‑Fi
WiFi Lens can expose live scan data to a compatible MCP client such as Codex Desktop or Claude Desktop. The MCP server listens only on this Mac; how the client and its model provider handle returned data depends on their policies and your settings. Ask "which channel is least crowded?" or "what stands out in nearby networks?"
Three JSON endpoints
networks
Browse all nearby Wi‑Fi networks with signal strength, band, channel, security, and more.
detail
Inspect a single network in detail by device address, including channel-width information.
occupancy
Check per-channel occupancy to understand congestion across each Wi‑Fi band.
One config to connect
Turn on the MCP server in WiFi Lens, then add the local Streamable HTTP entry in your client format: TOML for Codex, mcpServers JSON for Claude Desktop and compatible clients.
Codex / Claude + WiFi Lens[mcp_servers.wifi-lens] url = "http://127.0.0.1:19840/"
{
"mcpServers": {
"wifi-lens": {
"url": "http://127.0.0.1:19840/"
}
}
}What is MCP?
MCP (Model Context Protocol) is an open standard that lets AI tools connect to local data sources and services. WiFi Lens provides a local MCP server that exposes facts from the latest Wi-Fi scan to a compatible client. The client may send prompts or tool results to its model provider; check that client and provider’s policies and settings to understand how they handle data.
What the endpoints return
Each endpoint returns plain JSON you can read directly or pipe into another tool. Below is a trimmed sample of what WiFi Lens actually returns.
networks
{
"networks": [
{ "ssid": "HomeNet", "bssid": "A4:2B:…", "band": "5GHz", "channel": 36, "rssi": -48, "security": "WPA2" },
{ "ssid": "Office-5G", "bssid": "9C:3D:…", "band": "5GHz", "channel": 149, "rssi": -61, "security": "WPA3" }
]
}All visible networks, strongest first.
detail
{
"ssid": "HomeNet",
"bssid": "A4:2B:…",
"band": "5GHz",
"channel": 36,
"channelWidth": "80MHz",
"rssi": -48,
"noise": -92,
"security": "WPA2"
}One network, looked up by its BSSID.
occupancy
{
"band": "5GHz",
"channels": [
{ "channel": 36, "occupancy": 0.12 },
{ "channel": 149, "occupancy": 0.41 },
{ "channel": 157, "occupancy": 0.08 }
]
}Per-channel load across the 5 GHz band.
A real workflow
Say you keep dropping video calls in the home office. Instead of guessing, you open WiFi Lens, let it scan, then ask your AI assistant to find the problem.
- Ask “Which channel is least crowded right now?” — the AI reads occupancy and names a quiet channel.
- Ask “Why is my connection slower than my phone's?” — it compares your network's signal, channel, and band against the others nearby.
- Ask “What should I change on my router?” — it turns the findings into a concrete, local-only suggestion.
Private by design
The MCP server is off by default and, when enabled, listens only on 127.0.0.1. It exposes the latest scan to clients on this Mac and does not itself send scan data to a remote server. A connected AI client may process or transmit the data according to its own configuration and provider policies.
Start on the page that matches your question
WiFi Lens Features
Focused views for troubleshooting Wi‑Fi performance, coverage, and channel usage.
View pageGet WiFi LensGet WiFi Lens for Mac
WiFi Lens Pro combines live Wi-Fi analysis and local diagnostics with views for reviewing observed network reliability and recorded problems with supporting evidence.
View page