NEER AIP - Smart Infrastructure for Every Community

Find Hydraulic Model For Layer

Resolve a layer id to its HydraulicModel id. Polls Console after upload_hydraulic_model until the lambda-importer finishes. Returns one of four states: - importing — lambda still working; keep polling. - done — model created; ``model_id`` populated. - failed — lambda errored; ``error`` carries the message. - not_a_model — layer wasn't .inp-derived; stop polling.

Read Model Snapshot

One-shot bundle for reasoning about a HydraulicModel. Returns metadata, the editable ``data.json`` overlay (with etag), the canonical role layers, and recent simulations. Pass ``data_json_etag`` back to ``patch_data_json`` for optimistic concurrency.

Patch Data Json

Apply a batch of edits to a model's data.json overlay. Each op is ``{op: 'set'|'unset' (default 'set'), path, value?}`` where ``path`` is slash-delimited into the overlay (numeric segments index arrays; string segments index objects). Examples: {"path": "OPTIONS/FLOW_UNITS", "value": "CFS"} {"path": "JUNCTIONS/J-1/elevation", "value": 42.5} {"op": "unset", "path": "CONTROLS/Rule3"} Pass ``etag`` from the most recent ``read_

List Hydraulic Models

List HydraulicModels in a project. Resolves the "user said the model name, MCP client has no model_id" gap. Most chat references look like ``the wds-290 model`` or ``my Raytown network`` — names, not ids. Use this to map a name to its model_id before calling ``read_model_snapshot`` / ``patch_data_json`` / ``run_model_simulation``.

Run Model Simulation

Run a simulation against an existing HydraulicModel. Console re-renders the .inp from canonical state (features + data.json) before forwarding to the WRM API, so edits made via ``patch_data_json`` / ``update_features`` are picked up automatically — no need to re-upload the .inp. Returns immediately with a ``simulation_id``; poll the simulation row (or watch the project's Simulations panel) to see it transition to ``done``.

Update Features

Bulk-update feature attributes on a layer by predicate. ``where`` selects the rows to touch — supply at least one of: - ``fids``: numeric layer feature ids. - ``names``: matched against the ``name`` attribute (the canonical promote_id for HM layers). - ``attrs``: shallow attribute equality, e.g. ``{"role": "junction"}``. All keys must match (AND). - ``all``: true to select every feature (other fields must be omi

Upload Hydraulic Model

Import a SWMM/EPANET .inp into a project as a HydraulicModel. The .inp must already be staged on S3 — pass its ``s3_uri`` (``s3://bucket/key/path.inp``). Multipart uploads are not exposed through MCP; if the file is local, stage it via the Console UI's Upload action or pre-sign + PUT it to S3 first. ``srid`` overrides the project default for projection. Omit to fall back. ESRI codes (>=100000) are accepted. Returns immediately with the n

Check Simulation Status

Fetch the current state of a Simulation row. Returns the full Simulation record — ``status`` (``queued`` / ``running`` / ``done`` / ``failed``), ``type``, ``label``, ``createdAt``, ``finishedAt``, ``errorMessage``, etc. Poll this after ``run_model_simulation`` until ``status`` is ``done`` or ``failed`` before fetching reports / results.

List Model Simulations

List Simulations attached to a HydraulicModel. Newest first. Use this to discover prior runs of a model (e.g. compare two scenarios) without already knowing their ids. Each entry carries the same shape as ``check_simulation_status``.

Get Simulation Report

Fetch the structured report.json for a completed simulation. Returns the dict produced by ``epanet-utils`` / ``swmm-utils``' ``emit_report_json`` — per-feature stats (min/max/mean for nodes and links), continuity errors, and engine-level summary. Shape is engine-specific; the Results viewer in Console interprets it. Treat the output as opaque and explore keys. The simulation must be ``status: "done"`` — calling earlier returns 404

Get Simulation Report Text

Fetch the raw ``.rpt`` text for a completed simulation. Returns ``{"text": "<utf-8 contents of the .rpt file>"}``. This is the engine's own human-readable report — useful when you want to grep for a specific message or paste into a diagnosis.

Get Simulation Results

Get presigned download URLs for a simulation's artifacts. Returns ``{simulationId, artifacts: [{type, uri, presignedUrl, presignedExpiresAt, size}, ...]}``. ``type`` is ``inp`` / ``rpt`` / ``out`` / ``report_json`` / ``results_parquet`` / ``results_zarr``. Presigned URLs are short-lived (~1 hour); re-call this tool to get fresh URLs. For binary results (``out``, ``parquet``, ``zarr``) the client should fetch the URL directly — they're meg