Skip to content
Tresca

MODFLOW / GMS MCP servers and AI agent skills

MODFLOW has two community MCP servers and a research skill, none from USGS or Aquaveo. One server builds, edits and runs MODFLOW models exported from GMS or Visual MODFLOW through FloPy and the bundled USGS engines on Windows; MODFLOW-AI is a hosted, request-access documentation server for MODFLOW, PEST and FloPy. GMS projects themselves can't be opened directly, so export to MODFLOW files first.

  • No official USGS / Aquaveo server yet.
  • 2 MCP servers and 1 agent skill listed.
USGS / Aquaveo2 servers · 1 skillChecked 4 Nov 2026

Integrations for MODFLOW / GMS

Community and commercial servers

MCP serverCommunity

gms-vmod-grapher-mcpby chenzy0355

Builds, edits and runs MODFLOW models from GMS and Visual MODFLOW with FloPy, and plots results in Grapher.

LocalWindowsNeeds a MODFLOW / GMS licenceCan modify models0· updated 4 weeks ago
MCP serverCommunity

MODFLOW-AI MCP Serverby gwlabdev

A hosted docs server that searches MODFLOW, PEST, FloPy and ModelMuse docs and source for cited answers.

RemoteRead-only0· updated 7 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 MODFLOW / GMS

An MCP server or skill can only do what MODFLOW / GMS lets programs do. MODFLOW / GMS exposes 3 automation interfaces:

  • FloPy (Python): FloPy is the Python package for building, running and post-processing MODFLOW models, with tutorials for MODFLOW 6, 2005, NWT, USG, MT3DMS and PEST. MODFLOW 6's own example problems are constructed with it, and both the GMS server and the KISS skill use it to read and write packages, call the mf6 or mf2005 executable and read heads and budgets from the binary .hds and .cbc files. Documentation
  • MODFLOW input files and USGS executables (Input files): MODFLOW 6 reads a simulation name file, mfsim.nam, plus one text file per package; official USGS releases and nightly Windows, macOS and Linux builds are linked from the repository. Older MODFLOW-2000 and 2005 models use a .nam file listing packages such as .dis, .lpf and .wel. GMS and Visual MODFLOW ship these USGS engines in their install folders, which is how the GMS server runs models without opening either interface. Documentation
  • GMS client API (xms_api) (Python): According to the gms-vmod-grapher-mcp author, GMS's xms_api is a client API that needs a running GMS session and can't automate it on its own, and GMS .gpr projects are a private binary format. That's why agent tools work on exported MODFLOW text files rather than the GMS project. Documentation

What USGS / Aquaveo offers

Neither USGS nor Aquaveo has released an MCP server or AI assistant for MODFLOW or GMS. The MODFLOW 6 repository covers releases, nightly builds and FloPy examples, and Aquaveo's GMS pages cover conceptual modelling and pricing. MODFLOW-AI at modflow.ai is an independent hosted service that indexes MODFLOW, PEST and FloPy documentation and source.

Checked 4 Nov 2026. Sources: MODFLOW-ORG/modflow6 README, Aquaveo GMS introduction, gwlabdev/modflowai-mcp README

What you can do with MODFLOW / GMS and AI

  • Halve the hydraulic conductivity and raise pumping by half in an exported model, run it and map the drawdown.
  • Fit Theis or Cooper-Jacob curves to pumping test data to estimate transmissivity and storativity.
  • Parse a listing file for convergence, dry cells and the water budget error after a run.
  • Look up how a MODFLOW 6 package such as MAW or SFR is configured, with citations to the USGS documentation and FloPy source.
  • Build a MODFLOW 6 groundwater flow model for a basin with FloPy and share it as a browser viewer link.

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

Installing

The listings here document setup for ChatGPT, Claude Desktop, Claude Desktop (through mcp-remote), Cline, Codex, Cursor and VS Code. Install steps, copied from each project's own documentation, are on each listing's page. Most MODFLOW / GMS integrations run on your own computer next to MODFLOW / GMS, so you need MODFLOW / GMS installed and licensed on the same machine unless the listing says otherwise.

Questions

Is there a MODFLOW MCP server?

Two community ones. gms-vmod-grapher-mcp runs models on Windows through FloPy and the engines in GMS and Visual MODFLOW, and MODFLOW-AI answers documentation questions as a hosted service. USGS and Aquaveo have published none as of 4 November 2026.

Can Claude open my GMS project?

Not directly. GMS projects are a private binary format, so you export the model to MODFLOW text files in GMS first and point the server at those.

Does MODFLOW-AI run models for me?

No. It searches documentation and source code. The assistant runs MODFLOW 6 on your own machine with FloPy, and the server can then turn the run into a 30-day viewer link.

Which MODFLOW versions are covered?

The GMS server recognises 16 engines, including MODFLOW-2000, 2005, NWT and MF6, MT3DMS and MODPATH. The KISS skill and MODFLOW-AI focus on MODFLOW 6.

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

Sources (checked 4 Nov 2026): MODFLOW-ORG/modflow6 README · FloPy documentation · Aquaveo GMS introduction · chenzy0355/gms-vmod-grapher-mcp README · MODFLOW / GMS product page

MODFLOW / GMS is a trademark of USGS / Aquaveo. Tresca is independent and not affiliated with or endorsed by USGS / Aquaveo.