HEC-RAS MCP servers and AI agent skills

How AI connects to HEC-RAS

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

• HECRASController COM interface (COM automation): HEC-RAS on Windows registers a COM automation object, HECRASController, that external programs use to control a model. pyHMT2D drives HEC-RAS 2D through it with pywin32. The hecras-mcp author found it registered only for 32-bit Python, with array marshalling problems, so that server calls Ras.exe -c headless instead. Either way you need HEC-RAS installed on the same Windows machine. Documentation
• Project text files and HDF5 results (Input files): A project is a set of plain-text files, .prj for the project, .g01 for geometry, .f01 or .u01 for steady or unsteady flow and .p01 for plans, and each computed plan writes an HDF5 file. Tools that only read, such as RAS Commander MCP, parse the text files and need no HEC-RAS install. Fixed-width fields and CRLF line endings matter: a malformed plan file can make HEC-RAS silently compute a different plan. Documentation
• RAS Commander Python library (Python): ras-commander is a community Python API from CLB Engineering for running plans, editing projects and extracting HDF results from HEC-RAS 6.x and later. Its MCP server exposes only a bounded read-only slice of it; for geometry, results and execution, its skills tell the agent to write Python against the library directly. Documentation

What USACE Hydrologic Engineering Center offers

USACE's Hydrologic Engineering Center publishes no MCP server, agent skill or AI assistant for HEC-RAS. Its HEC-RAS pages cover the 7.0.2 download, the 2025 beta and documentation, and say HEC gives no phone or email support to non-USACE users. The community projects listed here state that they are independent of HEC.

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

What you can do with HEC-RAS and AI

• Compute a 1D steady, 1D unsteady or 2D plan headless, then confirm success from the plan HDF rather than the exit code, which is always 0.
• Read water surface elevations, velocities and 2D cell results from the plan HDF, and pull time series at a cross section.
• Calibrate Manning's n against observed stages, or run a Monte Carlo study on roughness and inflow, on a HEC-RAS 2D model.
• Answer quick questions about a project, such as its units and plan descriptions, without opening HEC-RAS.
• Convert a HEC-RAS 2D mesh and results to VTK for ParaView, or to SRH-2D for a model comparison.

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

Installing

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