AI Workflows

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
Codex Desktop · config.toml
[mcp_servers.wifi-lens]
url = "http://127.0.0.1:19840/"
Claude Desktop · claude_desktop_config.json
{
  "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.

  1. Ask “Which channel is least crowded right now?” — the AI reads occupancy and names a quiet channel.
  2. Ask “Why is my connection slower than my phone's?” — it compares your network's signal, channel, and band against the others nearby.
  3. 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.