Skip to content
Tresca

HEC-HMS MCP servers and AI agent skills

HEC-HMS has a small set of community options and no official server. HMS Commander MCP reads basin, gage and run settings from project text without HEC-HMS installed, the RAS Commander plugin packages it with HMS skills for Claude Code, and a KISS research skill runs the 4.14 Linux engine headless through the Jython API. None of the MCP tools computes a run or reads DSS results yet.

  • No official USACE Hydrologic Engineering Center server yet.
  • 2 MCP servers and 1 agent skill listed.
USACE Hydrologic Engineering Center2 servers · 1 skillChecked 4 Nov 2026

Integrations for HEC-HMS

Community and commercial servers

PluginCommunity

RAS Commander pluginby CLB Engineering (gpt-cmdr)

A Claude Code and Codex plugin with RAS and HMS Commander skills plus guarded read-only text servers.

LocalWindows, macOS, LinuxRead-only0· updated 8 days ago
MCP serverCommunity

HMS Commander MCPby CLB Engineering (gpt-cmdr)

A read-only MCP server that reads HEC-HMS project, basin, gage and run text through hms-commander.

LocalWindows, macOS, LinuxRead-only0· updated 3 weeks ago

Agent skills

SkillCommunity

KISS knowledge infrastructure skillsby lzwei196

Per-model SKILL.md packages with tools, checks and failure fixes for EPANET, SWMM, HEC-RAS, HEC-HMS and MODFLOW 6.

187· updated 2 days ago

Listings are sorted by origin, then by recent activity. GitHub data is refreshed nightly. Nothing here is ranked.

How AI connects to HEC-HMS

An MCP server or skill can only do what HEC-HMS lets programs do. HEC-HMS exposes 2 automation interfaces:

  • Jython and Java scripting API (Java): HEC-HMS is written in Java and exposes public API methods for scripts, with separate Jython and Java references linked from the 4.14 user manual. The KISS HEC-HMS package uses this route, opening a project and computing a run headless on the official Linux build, then checking the run log and a fresh results file. It's the only route in the listings that actually runs the engine. Documentation
  • Project, basin and meteorologic text files (Input files): A project keeps its basin models, meteorologic models, control specifications and gages as text files, while computed results go to HEC-DSS. HMS Commander MCP reads only this text layer: scalar parameters, gage configuration and which control and meteorologic model each run uses. DSS, HDF and SQLite files, geometry and gridded data are outside it. Documentation

What USACE Hydrologic Engineering Center offers

HEC offers no MCP server, skill or AI assistant for HEC-HMS. Its pages cover the 4.14 release for Windows, macOS and Linux, the user manual with its scripting section, and a support policy that excludes non-Corps users. HMS Commander MCP describes itself as an independent CLB Engineering project with no HEC affiliation.

Checked 4 Nov 2026. Sources: HEC-HMS home page, HEC-HMS downloads

What you can do with HEC-HMS and AI

  • Report a subbasin's loss, transform and baseflow parameters, or a reach's routing settings, from the basin file.
  • List the runs in a project and say which control specification and meteorologic model each one uses.
  • Check gage configuration, such as which precipitation and discharge gages a project defines, before a calibration.
  • Convert gridded forcing and soil data into HEC-HMS inputs and run the 4.14 engine headless, then export DSS results to CSV.

Taken from the listings' own documentation. Check each listing for exactly what it supports.

Installing

The listings here document setup for Claude Code and Codex. Install steps, copied from each project's own documentation, are on each listing's page. Most HEC-HMS integrations run on your own computer next to HEC-HMS, so you need HEC-HMS installed and licensed on the same machine unless the listing says otherwise.

Questions

Is there an HEC-HMS MCP server?

Yes, one community server: HMS Commander MCP from CLB Engineering, on PyPI as hms-commander-mcp. It reads project text only. HEC itself has not published one as of 4 November 2026.

Can Claude run an HEC-HMS simulation?

Not through an MCP tool yet. The KISS research skill shows an agent running the HEC-HMS 4.14 Linux build headless through the Jython API, but it's a research package, not a supported product.

Do I need HEC-HMS installed to use HMS Commander MCP?

No. It reads the project's text files through the hms-commander library and needs no Java, HEC executable, GIS or DSS libraries. You do need Python 3.10 or newer.

Is HEC-HMS free?

Yes. HEC distributes it without charge and without use restrictions, for Windows, macOS and Linux, but provides no support to users outside the Corps of Engineers.

AI-generated models, drawings and results must be checked by a qualified engineer before use.

Sources (checked 4 Nov 2026): HEC-HMS home page · HEC-HMS downloads (4.14) · HEC-HMS user manual, Scripting · gpt-cmdr/hms-commander-mcp README · HEC-HMS product page

HEC-HMS is a trademark of USACE Hydrologic Engineering Center. Tresca is independent and not affiliated with or endorsed by USACE Hydrologic Engineering Center.