Skip to main content

COSMOL HydroGeo Studio v2.1.0 - Multi-Physics Cloud Engine & MCP (cosmol-hydrogeo-mcp)

Live Web Studio MCP Protocol OpenAPI 3.1 License: MIT

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:4326 WGS84 GeoTIFF/TIFF -> local metric Auto-UTM warp, Civil 3D / 12d LWPOLYLINE code-38 DXF contour extraction, .geojson, .asc, .las, .xyz, and .zip bundles.
  • Vertical Units & CRS Overrides: Native elev_units ("auto", "m", or "ft") and crs_label across all 5 modules (M00-M04 + run_hydrogeo_m00..m04 aliases).
  • 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 when rainfall_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)
M01 2D SWE Flood Evolution M02 Coupled SW-GW Seepage Evolution
M03 · 2D Erosion & HESB SESC (31.6 mg/L Outlet < 50 mg/L) M04 · 1D/2D Urban Sewer & WSUD (86.4% Volume Capture)
M03 Sediment Morpho & HESB TSS M04 Urban LID & 1D/2D Street Flood

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 = 5 Full-Resolution Runs): Start with 2 anonymous runs, then unlock +3 bonus runs via claim_email_bonus_credits — or click Sign Up Free (5 Runs) at https://hydro.cosmolsesc.com (POST /api/global/auth/register) to obtain a persistent GLBH-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)

Source distribution for cosmol-hydrogeo-mcp 2.1.0
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)

Table of built distributions (wheels) for cosmol-hydrogeo-mcp 2.1.0
File Interpreter ABI Platform Actions
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 log

Release 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 log

Security 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.

Select from 2 files

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 log

A 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.

Release history Release notifications | RSS feed

This release

2.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page