COSMOL HydroGeo Studio v2.1.0 - Multi-Physics Cloud Engine & MCP (cosmol-hydrogeo-mcp)
Zero-dependency Model Context Protocol (MCP) server, Python stdio bridge, CLI client, and SKILL.md / AGENTS.md pack connecting Claude, Cursor, VS Code, OpenAI Codex, and custom AI agents directly to COSMOL HydroGeo Studio (https://hydro.cosmolsesc.com).
What's New in v2.1.0 (Universal Global Survey & Climate Engine)
- Universal Survey & CAD Ingestion: Automatic
EPSG:4326WGS84 GeoTIFF/TIFF -> local metric Auto-UTM warp, Civil 3D / 12dLWPOLYLINEcode-38 DXF contour extraction,.geojson,.asc,.las,.xyz, and.zipbundles. - Vertical Units & CRS Overrides: Native
elev_units("auto","m", or"ft") andcrs_labelacross all 5 modules (M00-M04+run_hydrogeo_m00..m04aliases). - 5-Jurisdiction Statutory Auto-Adapter & Koppen-Geiger IDF: Automatic regional statutory framing (
US/CA,UK,EU,AU/NZ,Global) and Koppen-Geiger climate IDF design rainfall whenrainfall_mm = 0.
Live Australian Benchmark Showcases (Upper Coomera & Oxenford-Coomera, QLD · GDA2020 / MGA56)
All 5 physics modules run genuine numerical solvers on real Australian elevation tiles and satellite imagery — zero synthetic placeholders:
M01 · 2D SWE Flood & Rev 5 Earthwork (731.7 m³/s Inflow) |
M02 · Coupled 2D SWE + MODFLOW 6 Seepage (Fs = 3.20) |
|---|---|
M03 · 2D Erosion & HESB SESC (31.6 mg/L Outlet < 50 mg/L) |
M04 · 1D/2D Urban Sewer & WSUD (86.4% Volume Capture) |
- M00 GlobalGeo CRS & D8 Mesh Animation: 03_Module00_Dynamic_Evolution.gif
- Sample 4-Page Compliance PDFs: M01 Flood & Earthwork Report · M03 Erosion & HESB Report
Five Integrated Modules & 9 MCP Tools
| Module | MCP Tool | Governing Physics & Outputs |
|---|---|---|
| M00 GlobalGeo CRS | run_m00_globalgeo_crs_mesh |
Auto-UTM (EPSG:326xx/327xx & GDA2020), Priority-Flood D8 catchment & 3-tier breakline mesh |
| M01 2D SWE Flood | run_2d_flood_simulation |
Explicit 2D SWE flood routing, spillway/culvert sizing & Design Rev 5 mass-haul earthwork |
| M02 SWE + MODFLOW 6 | run_m02_coupled_swe_modflow6 |
Two-way 2D SWE + 3D MODFLOW 6 DISV+XT3D seepage, cutoff walls & Terzaghi/Sellmeijer piping |
| M03 Erosion & SESC | run_m03_sediment_morpho_sesc |
Grid-RUSLE, Wu (2007) 4-fraction morphodynamics, Exner bed change & PACl+PAM HESB sizing |
| M04 Urban LID & Sewer | run_m04_urban_stormwater_lid_sewer |
Preissmann 1D trunk pipe + 2D urban SWE, MUSIC WSUD/LID capture & AIDR H1-H6 hazard |
Utility MCP tools: get_quota_and_pricing, claim_email_bonus_credits, upload_terrain_base64, and get_simulation_deliverables (returns 4-page .pdf, .docx, .dxf CAD, .xlsx BOQ, 300-DPI atlases, animated .gif, interactive .html, and .zip archive).
Quickstart (0 Dependencies Required)
1. Remote Streamable HTTP MCP (Fastest — Cursor / Claude / Codex)
Connect directly to the hosted MCP endpoint (Protocol 2025-06-18 / 2025-03-26 / 2024-11-05):
{
"mcpServers": {
"cosmol-hydrogeo": {
"url": "https://hydro.cosmolsesc.com/mcp"
}
}
}
2. Local stdio MCP Direct from GitHub (uvx / pip, Works Immediately)
{
"mcpServers": {
"cosmol-hydrogeo": {
"command": "uvx",
"args": ["--from", "git+https://github.com/jc155699/cosmol-hydro-mcp", "cosmol-hydrogeo-mcp"],
"env": { "COSMOL_HYDRO_URL": "https://hydro.cosmolsesc.com", "COSMOL_API_TOKEN": "" }
}
}
}
Or install directly with pip: pip install git+https://github.com/jc155699/cosmol-hydro-mcp.git (or uvx cosmol-hydrogeo-mcp / npx -y @cosmol/hydrogeo-mcp).
3. 10-Second Australian Coomera CLI Run (Bundled Sample Survey)
git clone https://github.com/jc155699/cosmol-hydro-mcp.git && cd cosmol-hydro-mcp
python3 scripts/hydro_cloud_cli.py quota
python3 scripts/hydro_cloud_cli.py run --module m00 --file examples/upper_coomera_qld/upper_coomera_catchment_survey.geojson --lon 153.215 --lat -28.055 --out-dir ./outputs
4. OpenAI Codex CLI (~/.codex/config.toml) & ChatGPT Custom GPT Actions
[mcp_servers.cosmol_hydrogeo]
url = "https://hydro.cosmolsesc.com/mcp"
ChatGPT GPT Action OpenAPI 3.1.0 URL: https://hydro.cosmolsesc.com/openapi-global.json · AI Discovery Index: https://hydro.cosmolsesc.com/llms.txt
Free Trial, Account Key & USD Pricing
- Free Trial (
2 + 3 = 5Full-Resolution Runs): Start with2anonymous runs, then unlock+3bonus runs viaclaim_email_bonus_credits— or click Sign Up Free (5 Runs) at https://hydro.cosmolsesc.com (POST /api/global/auth/register) to obtain a persistentGLBH-USR-*API/MCP key synced across devices. - Pay-As-You-Go USD Packs (Stripe): Starter 4-Pack (
$39) · Pro 15-Pack ($99) · Consultancy 60-Pack ($299). - Subscriptions (Stripe USD): Pro (
$79/mo·$759/yr) · Team + White-Label PDFs ($249/mo·$2,390/yr).
Licence
Released under the MIT Licence — see LICENSE.
Metadata
Release files for cosmol-hydrogeo-mcp 2.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| cosmol_hydrogeo_mcp-2.1.0.tar.gz | 12.0 kB | With provenance | Details for cosmol_hydrogeo_mcp-2.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| cosmol_hydrogeo_mcp-2.1.0-py3-none-any.whl | Python 3 | none | any | Details for cosmol_hydrogeo_mcp-2.1.0-py3-none-any.whl |
Total release size: 24.9 kB
Release files / cosmol_hydrogeo_mcp-2.1.0.tar.gz
| Download URL | cosmol_hydrogeo_mcp-2.1.0.tar.gz |
|---|---|
| Size | 12.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
8f80c806affd2d6fe1dde1fc35d4992bdc432969c6a9b2ecc438a4d3457ee63e
|
|
BLAKE2b-256 checksum How to use checksums |
49de676874fed61fd128707fd5a4a7945087e3dd027e2d13e011c5429996766b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 22, 2026.
Transparency logRelease files / cosmol_hydrogeo_mcp-2.1.0-py3-none-any.whl
| Download URL | cosmol_hydrogeo_mcp-2.1.0-py3-none-any.whl |
|---|---|
| Size | 12.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d597a4bb2e0442e3780f52853ce930f4a94f01b152ba8db516dde1d38b3172ef
|
|
BLAKE2b-256 checksum How to use checksums |
7854f5a3f9aa0cb3353a4475dc404195c43f11b3c8dcd50ee5b1bec45d705e37
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 22, 2026.
Transparency logSecurity for cosmol-hydrogeo-mcp 2.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for cosmol_hydrogeo_mcp-2.1.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 22, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.