Skip to main content

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: info@deepmapai.com

Metadata

Release files for deepmap-earth-grounding-mcp 0.3.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 deepmap-earth-grounding-mcp 0.3.0
File Size Uploaded
deepmap_earth_grounding_mcp-0.3.0.tar.gz 16.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for deepmap-earth-grounding-mcp 0.3.0
File Interpreter ABI Platform
deepmap_earth_grounding_mcp-0.3.0-py3-none-any.whl Python 3 none any Details

Total release size: 23.9 kB

Release files / deepmap_earth_grounding_mcp-0.3.0.tar.gz

Download URL deepmap_earth_grounding_mcp-0.3.0.tar.gz
Size 16.6 kB
Tags Source
SHA-256 checksum
How to use checksums
2fa21036c44d833430ca77f150f9218f0396c625710a5dd881869c7eac59505e
BLAKE2b-256 checksum
How to use checksums
419b508d08f5fab5ec8eec3669f4efb7e8ddb58a3acb8f7ef95045b13934f67a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.3

Release files / deepmap_earth_grounding_mcp-0.3.0-py3-none-any.whl

Download URL deepmap_earth_grounding_mcp-0.3.0-py3-none-any.whl
Size 7.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
c0d351562cc6c16b9ad78655fa3705354c12a28689965f3d1e78fc067bb6add9
BLAKE2b-256 checksum
How to use checksums
d9537f32d8dadf2ce12f22ee9fd5e2a241cdecb4a4b3ca82a8eb48e8514de67a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.3

Release history Release notifications | RSS feed

This release

0.3.0 This release

2 release files

0.1.0

2 release files

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