MOBYDB · INTEGRATION GUIDE

The spatial database that plugs into
what you already run.

MobyDB sits beside your SCADA, your MCP agents, your PostGIS warehouse — not in front of them. Its composite primary key (H3 · epoch · Ed25519) means every query returns a cryptographically verifiable, jurisdiction‑aware answer. Nothing about your existing pipeline has to move.

Point lookup
0.24ms
vs PostGIS
35×faster
Proof per record
Merkle / Blake3
Addressable cells
569T H3 res‑15
01WHERE IT SITS

MobyDB is the storage layer of the GNS stack.

Six layers, one composite key. Every row is addressed by where, when, and who — so every answer comes with a proof that it came from an authorized writer, inside a known jurisdiction, within a known moment.

L6

GCRUMBS · Enterprise apps

Operators, auditors, AI agents — whoever needs the answer.

CLIENTS
L5

GEIANT Hive

Distributed inference & tile rendering on identity‑verified workers.

COMPUTE
L4

GNS‑AIP

Agent delegation chains, proof‑of‑jurisdiction, territorial scoping.

AGENTS
L3

MobyDB

Storage. Composite key: (H3, epoch, Ed25519). Signed writes, Merkle epochs, MobyQL.

STORAGE
L2

GNS Protocol

Ed25519 identity, @handles, Proof‑of‑Trajectory breadcrumbs.

IDENTITY
L1

GeoEpoch Protocol (GEP)

Time partitioned across a geographic address space.

TIME
L0

H3 Grid

Uber's hexagonal hierarchical index — the geography.

GEOGRAPHY

MobyDB doesn't replace your systems. It's the verifiable record underneath them. A SCADA historian still ingests sensor telemetry. A PostGIS warehouse still runs your analyst dashboards. MobyDB holds the signed, jurisdictionally‑scoped version of truth that auditors and regulators ask for.

“Geography is not a column. Time is not a timestamp. Identity is not a row.” They are the address of every record.

The stack below MobyDB (GEP, GNS) gives it primitives nothing else has: every cell on Earth has an address; every address has an epoch chain; every writer has a cryptographic identity. The stack above (GNS‑AIP, Hive) makes MobyDB queryable by AI agents that carry proof of who authorized them and where they're allowed to act.

In operational terms: you write a sensor reading once, and the same record serves real‑time control, long‑term analytics, and the Art. 12 AI Act audit trail — without a separate compliance pipeline ever needing to exist.

02INTEGRATION PATTERNS

Five ways in. None of them ask you to rewrite anything.

Pick the shape that matches your team: a grid engineer already inside SCADA, an AI platform team wiring tool calls, an analyst used to psql, or a compliance officer who just wants the receipt.

For agent platforms

MCP · CLAUDE · GPT

MobyDB exposes its five primary tools over MCP. Drop the server URL into Claude.ai / Cursor / your orchestrator and your agent gains jurisdiction‑aware spatial memory, instantly.

// claude.ai connector config
{
  "type": "url",
  "url":  "https://mobydb-render-engine-production.up.railway.app/mcp",
  "name": "mobydb"
}

// your agent can now call
get_cell_state("871e8052affffff", epoch=2)
get_provenance("871e8052affffff", epoch=2,
                pubkey="...")
Returns signed state + Merkle proof — your agent can prove the answer without trusting the server.

For application teams

HTTP · RUST · PYTHON · TS

A thin HTTP surface. No ORM, no client library required. The Rust, Python, and TypeScript SDKs are sugar — useful, never necessary.

# curl — the reference client
$ curl https://.../v1/near/871e8052affffff?rings=2 \
       -H "x-api-key: $MOBYDB_KEY"

# Python — identical payload, ergonomic API
from mobydb import Client
db = Client(api_key=os.environ["MOBYDB_KEY"])
for cell in db.near("871e8052affffff", rings=2):
    print(cell.h3_cell, cell.epoch, cell.signed_by)
Same JSON everywhere. No hidden state. What you see on the wire is what you get in code.

For grid operators

SCADA · HISTORIAN · SIDECAR

MobyDB ships as a sidecar. Your SCADA keeps ingesting, your historian keeps its retention policy. The sidecar subscribes, signs, and writes a ct‑audit copy into MobyDB. No changes to the control path.

# scada-adapter.toml
[source.opcua]
endpoint = "opc.tcp://scada.internal:4840"
interval = "1s"

[sink.mobydb]
url = "https://mobydb.internal/v1/write"
h3_resolution = 9
signer = "hsm://substation-astalli"
facet  = "grid@terna"
Read path unchanged. Write path gains signed provenance and NIS2‑ready retention.

For AI governance

GNS‑AIP · DELEGATION · AUDIT

Every AI agent acting on the data carries a GNS identity scoped to specific H3 cells. Writes outside that territory are rejected at the database, not at application layer. The proof is persistent.

// delegation certificate (canonical JSON)
{
  "principal":  "@camilo.ayerbe",
  "agent":      "agent://terna-grid-ai",
  "territory":  ["871e80*", "871e81*"],
  "facet":      "grid@terna",
  "expires":    "2026-08-02T00:00:00Z",
  "constraints": { "ops": ["read", "write"] },
  "principal_signature": "ed25519:..."
}
The agent's every write is now traceable to a human signature under a scoped mandate.

For compliance officers

EU AI ACT · NIS2 · GDPR

Pull a signed attestation bundle for any cell / epoch / agent tuple. The bundle is self‑verifying: Merkle proof, public key, canonical payload. A regulator can verify offline, without hitting your API.

# regulator-friendly bundle
$ mobydb attest \
    --cell  871e8052affffff \
    --epoch 2 \
    --agent agent://terna-grid-ai \
    -o attestation_2026_04_22.json

# verifies offline, no server needed
$ mobydb verify attestation_2026_04_22.json
OK  epoch root  dfee521a09…d831
OK  signature   ed25519 valid
OK  delegation  chain complete
One file, three proofs. This is the audit artefact — in hand, not promised.

For PostGIS shops

MIGRATION · DUAL‑WRITE

Keep PostGIS for analytical joins and reporting. Add MobyDB as the system‑of‑record for trajectory & telemetry where provenance matters. Dual‑write from your existing pipeline; cut over by use case, not by big‑bang migration.

-- existing PostGIS query stays untouched
SELECT ST_AsGeoJSON(geom)
FROM sensor_readings
WHERE recorded_at > '2026-04-01';

-- same tuple, addressable & verifiable
GET /v1/near/871e8052affffff?rings=2
     &since_epoch=1
     &until_epoch=2
Analysts keep their SQL. Auditors get proofs. Nobody has to migrate anything on day one.
03COMPLIANCE PIPELINE

EU AI Act, end‑to‑end, without a separate pipeline.

The August 2 2026 enforcement deadline doesn't need a new compliance stack. Every record MobyDB stores is already the evidence Art. 12 (record‑keeping), Art. 26§6 (retention), Art. 50 (transparency), and Art. 72 (post‑market monitoring) ask for.

From sensor reading to regulator attestation

One write. Five gates. A single verifiable artefact at the end.

01 · Capture
Agent or sensor writes
Payload + H3 cell + Ed25519 signature from a GNS identity.
Art. 50
02 · Scope
Jurisdictional check
Delegation certificate bounds the agent to specific H3 cells.
Art. 25
03 · Seal
Epoch Merkle root
Hourly Blake3 tree; parent_root chains the full history.
Art. 12
04 · Retain
Immutable retention
Record + proof kept per operator‑specified policy window.
Art. 26§6
05 · Attest
Regulator bundle
Offline‑verifiable JSON: proof, signature, chain.
Art. 72
NIS2: sidecar ingest preserves full audit trail without touching the control path.
GDPR: H3 quantization means personal data can be coarsened before write, not after.
ISO 27001: every write is cryptographic evidence of who, where, when.
04WHAT EXISTING TOOLING DOES NOT COVER

The capability matrix, honestly drawn.

MobyDB is not a PostGIS killer. It covers a different axis — proof and jurisdiction — that mature spatial databases were never designed to carry. Use both.

Capability PostGIS Time‑series DB Blockchain L1 MobyDB
Geospatial joins & analytics YES limited NO partial (MobyQL)
Point‑in‑time telemetry via partitions YES NO YES
Per‑record signed provenance NO NO YES YES
Jurisdictional scoping NO NO indirect YES
Offline‑verifiable audit artefact NO NO YES YES
Sub‑ms spatial point lookup ~8 ms varies NO 0.24 ms
Runs on commodity infra YES YES no (or costly) YES
EU AI Act evidence out‑of‑the‑box NO NO partial YES

See it run on your map. Click a cell. Read the proof.

The live demo has ~1,000 cells seeded across Italian utility infrastructure. Pan to Rome, click any substation, inspect the audit trail, verify the Merkle proof in your browser. Nothing is hand‑waved.