# DeepMap AI -- Earth Grounding

> Verifiable Earth ground truth for AI agents: water, hazard, ground stability, resource, with proof.

- name: com.deepmapai/earth-grounding
- version: 0.3.0
- connection class: R0 (autonomous)
- trust: 80/100 flags: no-repository
- quality: 96/100 (strong)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.deepmapai%2Fearth-grounding
- tools: https://api.protogrid.dev/v1/servers/com.deepmapai%2Fearth-grounding/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "earth-grounding": {
      "type": "http",
      "url": "https://deepmapai.com/mcp",
      "headers": {
        "apiKey": "${APIKEY}"
      }
    }
  }
}
```

Placeholders to fill: `${APIKEY}`.

## Trust

- hygiene: 80
- liveness: 100
- freshness: 85
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-100% ~updated-38d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 96/100 (strong)

### protocol: 88 (weight 25)

- pass `protocol.modern`: supports 2026-07-28 (server/discover)
- pass `protocol.stateless`: answers without a session
- pass `protocol.transport`: streamable HTTP
- warn `protocol.list_ttl`: tools/list carries no ttlMs, so clients re-fetch it

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 11 of 11 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 1,191 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: 2 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: 100 (weight 15)

- pass `deps.known_vulns`: no known advisory in 1 resolved packages
- n/a `deps.mcp_sdk_version`: the official MCP SDK is not in the dependency graph
- pass `deps.resolvable`: deepmap-earth-grounding-mcp@0.3.0 resolved: 1 packages

- tools: 11, about 1,191 tokens to load them all
- tool set hash: bf9cf7149b3695ac5524447900e55b68
- tools last changed: 2026-10-20T05:31:41.819Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.deepmapai/earth-grounding.svg)](https://protogrid.dev/servers/com.deepmapai/earth-grounding)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-20 `resource_indication` changed (description)
  - before: Geothermal / mineral / gas / water indication (gated, honest null).
  - after: Geothermal / mineral / water indication (gated, honest null).
- 2026-10-20 `water_availability` changed (description)
  - before: Replenishable-water availability at a point. Free tier = public GRACE groundwater trend; authenticated tier adds a derived (non-locating) replenishable-atlas indication.
  - after: Water availability at a point. Free tier = public GRACE groundwater trend.

Full history: https://api.protogrid.dev/v1/servers/com.deepmapai%2Fearth-grounding/changes

## Dependencies

- pypi deepmap-earth-grounding-mcp@0.3.0: resolved, 0 dependencies

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0.

## Remotes

- https://deepmapai.com/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

- pypi deepmap-earth-grounding-mcp@0.3.0 secrets: DEEPMAP_API_KEY

## Tools (11)

- `capabilities`: What DeepMap can answer now + coverage counts (public aggregate; tracks the library, leaks no proprietary data).
- `check_hypothesis`: Has this Earth-science hypothesis been tested? Query the Null Museum + the Bitcoin-anchored hypothesis registry. A direct match returns the verdict + the positive control that proves the test was sensitive + the honest bound + the anchor -- so an agent never re-runs a dead idea.
- `ground_stability`: Subsidence / void / karst / fault risk from verified observations.
- `ground_truth`: The bundled five-question answer (water / stability / hazard / resource / provability) + one provenance record.
- `list_nulls`: List DeepMap's documented nulls / bounds / retractions (the Null Museum), optionally by domain -- each with the positive control that makes it trustworthy. We carry our own retractions; that is the credibility.
- `resource_indication`: Geothermal / mineral / water indication (gated, honest null).
- `run_controlled_test`: The Lab-as-an-API: run a REAL, bounded controlled test at a location and get an honest verdict. DeepMap fetches real data, runs a lock-in detection with a local-background null AND a positive control (a known reference line must be recovered, else UNTESTABLE) -- so an agent gets a grounded result it cannot fake. Free tier runs a synthetic demo; the live lab is the authenticated tier. v1 recipe: periodic-signal detection on the geomagnetic field.
- `seismic_hazard`: Seismic hazard via the public, outcome-excluded prediction ledger (no platform-wide accuracy figure).
- `space_weather_grid_risk`: GIC / space-weather exposure for infrastructure at a point.
- `verify`: Verify a claim / the ledger hash chain against the Bitcoin-anchored record.
- `water_availability`: Water availability at a point. Free tier = public GRACE groundwater trend.