deepmap-earth-grounding-mcp

DeepMap AI -- Earth Grounding MCP

Verifiable physical-world ground truth for AI agents. Ask about subsurface water, seismic and space-weather hazard, ground stability, and resource indications for any point on Earth -- and every answer carries a Bitcoin-anchored, verifiable provenance record, so a physical-world claim can be trusted instead of hallucinated.

This package is a tiny stdio Model Context Protocol server. It ships stdlib-only and proxies your calls to DeepMap's hosted engine at https://deepmapai.com/mcp -- it contains no platform code and no proprietary data; the answers (and their provenance) come from the hosted service.

Install

uvx deepmap-earth-grounding-mcp        # run it (no install step needed)
# or
pip install deepmap-earth-grounding-mcp

Set your key (a free demo key works out of the box):

export DEEPMAP_API_KEY=demo-free       # or your DeepMap key

Add to any MCP client as a stdio server running deepmap-earth-grounding-mcp. For Claude Code:

claude mcp add deepmap-earth-grounding -e DEEPMAP_API_KEY=demo-free -- uvx deepmap-earth-grounding-mcp

Or connect the hosted server directly over HTTP (no install):

claude mcp add --transport http deepmap-earth-grounding https://deepmapai.com/mcp --header "apiKey: demo-free"

Tools

tool	what it answers
water_availability	replenishable-water availability at a point (free = public groundwater trend; paid adds a derived, non-locating atlas indication)
seismic_hazard	seismic hazard via the public, outcome-excluded prediction ledger
ground_stability	subsidence / void / karst / fault risk from verified observations
resource_indication	geothermal / mineral / gas / water indication (gated, low-confidence)
space_weather_grid_risk	live geomagnetic (Kp) activity as GIC / grid exposure
verify	verify a claim hash / the ledger hash chain against the Bitcoin anchor
ground_truth	the bundled five-question answer + one provenance record
capabilities	what DeepMap can answer now + public coverage counts
check_hypothesis	has this Earth-science hypothesis already been tested? Queries the Null Museum + the Bitcoin-anchored registry, and returns the verdict with the positive control that proves the test was sensitive
list_nulls	DeepMap's documented nulls, bounds and retractions, optionally by domain -- we carry our own retractions, and that is the point
run_controlled_test	Lab-as-an-API: fetches real data, runs a bounded controlled test with a local-background null and a positive control, and returns UNTESTABLE rather than a fabricated null

Why it's different

• Grounded on a proprietary geophysical sensor network + replenishable-water atlas + live feeds -- data that is not on the open web.
• Verifiable -- every answer references a Bitcoin-anchored, pre-registered prediction ledger. Call verify on any claim hash.
• Honest -- returns null rather than a fabricated value; no platform-wide accuracy headlines; proprietary coordinates, names, and rows are never returned (answers are derived).

Verify the public ledger: https://deepmapai.com/track-record · Contact: [e-mail]