Utility Network MCP server

Give Claude and other AI agents working knowledge of the Esri ArcGIS Utility Network.

Utility Network questions are hard for general-purpose AI: the answer depends on the dataset version, the deployment, which API you're in, and a long list of ordering rules and gotchas. This project packages that knowledge so an agent answers like an experienced UN implementer — and connects agents to a live network through MCP.

See it in action

Ask the questions you'd ask a senior UN consultant:

"Apply Asset Package keeps failing when I add gas to our water UN. Pro 3.5, Enterprise 11.3."

→ Troubleshooting answer walking the four prerequisites that cause most failures (maps closed, topology disabled, Pro/UN version match, both owners on DEFAULT), and why the tool is additive.

"Write the REST request for an isolation trace from this main at the midpoint, stopping at operable valves, on version crew1.outage."

→ Complete request with percentAlong, filter barriers and gdbVersion, checked by a validator for the mistakes that make traces silently return nothing.

"Our dirty areas show Status 1, 9 and 40 — which ones matter?"

→ Decoded bitmask: 1 is a pending edit, 9 and 40 carry feature and subnetwork errors, with the next action for each.

"Hook Claude up to our electric UN so dispatch can ask what's downstream of a breaker."

→ Route recommendation (Esri's MCP beta vs. custom GP tools vs. this MCP server), tool list, auth, write-safety rails and licensing.

Quick start

Claude Code

claude plugin marketplace add sgdev279/esri-utility-network-skill
claude plugin install utility-network@esri-utility-network

Claude.ai / Claude desktop app — download utility-network.skill from the latest release and add it to your skills.

Any skills-aware agent — copy plugins/utility-network/skills/utility-network into its skills folder.

MCP server — see mcp-server/README.md:

pip install utility-network-mcp

What the skill knows

Shortened. The full README is on GitHub.