Metadata-Version: 2.5
Name: deepmap-earth-grounding-mcp
Version: 0.1.0
Summary: MCP server for verifiable physical-world ground truth (water, hazard, ground stability, resource, space weather) from DeepMap AI, with Bitcoin-anchored provenance.
Project-URL: Homepage, https://deepmapai.com
Project-URL: Manifest, https://deepmapai.com/.well-known/mcp/mcp.json
Project-URL: Ledger, https://deepmapai.com/track-record
Author-email: DeepMap AI <info@deepmapai.com>
License: Proprietary
Keywords: ai-agents,earth,geophysics,grounding,mcp,model-context-protocol,seismic-hazard,verifiable,water
Requires-Python: >=3.10
Description-Content-Type: text/markdown

<!-- mcp-name: com.deepmapai/earth-grounding -->
# 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](https://modelcontextprotocol.io)
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

```bash
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):

```bash
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:

```bash
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):

```bash
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 |

## 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
