211-az-mcp — Model Context Protocol server for 211 Arizona

A Model Context Protocol server that exposes 211 Arizona — operated by Solari Crisis & Human Services — as a set of tools an LLM (Claude Desktop, Claude Code, Claude API agents, or any other MCP client) can call.

Built for the EpiHack Arizona 2026 Heat focus group. Powers the Heat-vertical Scenario C (unsheltered heat check-in on a Magenta-HeatRisk day) in cooperation with nws-heatrisk-mcp and mag-hrn-mcp.

Mock-by-default. 211 Arizona / Solari Crisis & Human Services does not publish a public REST API at the time of writing. This server ships a canned in-memory backend so the end-to-end agent flows in plan/04-data-flows.md run offline. When a real API arrives, point AZ211_BACKEND_URL at it and the client will swap transparently (see Swapping to a real backend below).

Reference for the canned content: https://211arizona.org/crisis/heat-relief/.

What it does

MCP tool What it returns
az211_transport_to_cooling_center Mock ride-dispatch confirmation with a stable dispatch_id, ETA, provider, and a callback phone number. Tagged source: "mock".
az211_get_dispatch Look up a previously-created dispatch by ID (chained call).
az211_utility_assistance_nearby Community-action / LIHEAP providers near the caller, filterable by kind (electric / gas / water / weatherization / emergency_ac_repair). 7 canned providers across Maricopa, Pima, Coconino, Yuma, and Navajo / Apache counties.
az211_crisis_referrals Phone / hours / languages by topic (heat, housing, food, behavioral_health, or all).
az211_cooling_center_referral_nearby Nearby cooling centers (canned). In production this cross-calls mag-hrn-mcp.search_centers for the authoritative Maricopa County registry.
az211_lines Structured phone-line directory: main 2-1-1 / 1-877-211-8661, 988 Suicide & Crisis Lifeline, Solari Crisis Response Network, Veterans Crisis Line, ASL video relay.

Plus two MCP resources:

MCP resource Payload
az211://hours Full operator hours by season (year-round + heat-season expansion May 1 – Sept 30).
az211://languages Languages supported, including indigenous-language pathways (Navajo / Diné bizaad, O’odham, Apache, Hopi) routed through partner organisations (ITCA-TEC, Navajo Epidemiology Center, IHS).

Why this matters for EpiHack

211 Arizona is the statewide non-clinical heat-relief on-ramp: live operators in English and Spanish, expanded hours during the May 1 – September 30 heat season, with connect points to cooling centers, transportation to centers, utility-bill assistance, weatherization, and emergency AC-repair referrals. It is also the voice channel most likely to be reachable for callers with no internet or no smartphone — the same population most exposed to heat mortality (see Heat Q4 and the “anonymity matters” insight on the Unhoused card in World Café Q4 — Heat).

Exposing it as an MCP server lets an agent:

Mock backend

The mock backend lives in src/az211_mcp/mock_data.py and src/az211_mcp/client.py.

Swapping to a real backend

When 211 Arizona ships an API, set AZ211_BACKEND_URL (and optionally AZ211_API_KEY) in env. The client will pick the HttpBackend instead of the mock; today that backend raises NotImplementedError on every method so a misconfiguration is loud. Update src/az211_mcp/client.py::HttpBackend to match the live wire format — none of the FastMCP tools or resources need to change.

Operating partner & data-sovereignty notes

Install & run

As a Claude Desktop MCP server

  1. Install uv if you don’t have it.
  2. Drop the snippet in examples/claude_desktop_config.json into your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows).
  3. Replace the path with the absolute path to this directory.
  4. Restart Claude Desktop. The server starts in mock mode with no credentials required.

Standalone

cd mcp/211-az-mcp
uv sync
uv run az211-mcp                          # stdio (default)
MCP_TRANSPORT=streamable-http uv run az211-mcp  # HTTP

Tests

cd mcp/211-az-mcp
uv run pytest

All tests are offline — no AZ211_BACKEND_URL required.

Cross-references

License

MIT, alongside the rest of epihack-2026.