Agentic SWMM: Auditable and Reproducible Stormwater Modelling Workflow with Agent Skills and Model Context Protocol

Read full text
Authors: Zhonghao Zhang, Caterina Valeo
Cited by: 3
References: 48

Abstract

Configuring urban hydrological models, such as the Storm Water Management Model (SWMM), for operational use remains onerous for many modellers. We propose aiswmm, a SWMM-specialized agentic runtime, together with an Agentic SWMM workflow that embeds (Agent) Skills and Model Context Protocol (MCP) tools to automate QGIS preprocessing, SWMM configuration, execution, and postprocessing. We demonstrate this natural-language triggered workflow on the Tod Creek watershed (located on the Saanich Peninsula, British Columbia). We also validate the proposed Agentic SWMM workflow at three levels: (i) a QGIS-based watershed-pour-point detection that agrees with the commercial PCSWMM® method to within 0.88% of the watershed perimeter (approximately 7.5 pixels in the digital elevation model); (ii) byte-identical SWMM output files (Secure Hash Algorithm 256-bit identical) between the command-line execution and the MCP paths across 60 paired simulations, and (iii) peak inflow at the watershed outlet matching to three significant digits between the manual SWMM interface and Agentic SWMM workflows. The results confirm that Agentic SWMM workflow can produce the same outputs with the manual SWMM interface, as they are designed to use the same computational engine. We also propose a verification-first contract and byte-level audit chain that record the inputs, parameters, and outputs of each run, thereby supporting the auditability and reproducibility. The aiswmm runtime, Skills, MCP servers, and byte-level audit chain are released as open source and remain compatible with mainstream agentic runtimes (Codex, Claude Code, Hermes, and OpenClaw) to support reproducible SWMM modelling driven by natural language.

Fields of Study & Subjects

Hydrology and Watershed Management Studies Flood Risk Assessment and Management Urban Stormwater Management Solutions

Publication details

Journal / source
AI for Engineering
Publisher
MDPI AG
Volume
1
Issue
1
Pages
5–5
Publication date
9 June 2026
Language
EN