Skip to main content

COSMOL HydroGeo Studio™ v2.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).


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.0.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.0.0
File Size Uploaded Provenance Actions
cosmol_hydrogeo_mcp-2.0.0.tar.gz 10.8 kB With provenance Details for cosmol_hydrogeo_mcp-2.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for cosmol-hydrogeo-mcp 2.0.0
File Interpreter ABI Platform Actions
cosmol_hydrogeo_mcp-2.0.0-py3-none-any.whl Python 3 none any Details for cosmol_hydrogeo_mcp-2.0.0-py3-none-any.whl

Total release size: 22.8 kB

Release files / cosmol_hydrogeo_mcp-2.0.0.tar.gz

Download URL cosmol_hydrogeo_mcp-2.0.0.tar.gz
Size 10.8 kB
Tags Source
SHA-256 checksum
How to use checksums
fa07c7c7803854d43134366d376364942985835e7c7d679edcdd9a941f57bb54
BLAKE2b-256 checksum
How to use checksums
897055b933caf7187511a024ee24c875f12b82f108c1cd6f60842bc827de2654
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 19, 2026.

Transparency log

Release files / cosmol_hydrogeo_mcp-2.0.0-py3-none-any.whl

Download URL cosmol_hydrogeo_mcp-2.0.0-py3-none-any.whl
Size 12.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b342ca6d20905069b23fc48eb3afaa23d9da76ced2ca79cf4a5638a4e6387bee
BLAKE2b-256 checksum
How to use checksums
ba4582589f5dbdb234fb3a1d313ea4ce135b1eab019035cf710edf2b62813d49
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 19, 2026.

Transparency log

Security for cosmol-hydrogeo-mcp 2.0.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.0.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 19, 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.0.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