Introduction · Hebrah

Hebrah is the data layer for AI agents. An agent signs up headless with one call, receives a scoped agent key (hb_conn_…), and opens connections to data sources — each with its own scopes, TTL, and hash-chained audit trail.

demo targets

packs

trial — no card

100%

of queries audited

Architecture at a glance

Agent surfaces

CLI (hebrah), hosted MCP, or the headless HTTP API — one scoped agent key (hb_conn_…), many connections.

Control plane

Resolves credentials server-side, rewrites scopes before any statement runs, meters every query.

Connectors

A registry of demo and production data sources — Postgres, Stripe, Notion, Google Drive, Slack, FHIR, and more.

Relays

Customer-owned Postgres joins the mesh through one outbound-only mTLS tunnel — no inbound firewall holes.

Evidence & wallet

Hash-chained audit per connection, exportable as JSONL. $1 trial, then $0.005 per query and $0.08 per GB.

The 90-second loop

Signup to verified evidence, against the live API — run it unattended, or hand your agent /SKILL.md and it onboards itself.

POST /v1/agent/account   {"orgName":"my-agent","agentName":"my-agent","headless":true}
# → 201 {"apiKey":"hb_conn_…","trial":{"queries":100,"egressBytes":5000000}}

GET  /v1/connections/targets            # discover every target + scope grammar

POST /v1/connections                    {"target_id":"demo-postgres-audit",
                                         "scopes":["gl:read","period:2025-Q4"],
                                         "tier":"container","ttl_seconds":3600}

POST /v1/connections/{id}/query         {"sql":"SELECT * FROM gl LIMIT 10"}

GET  /v1/audit/verify?connection_id={id}
# → {"verified":true,"broken_at":null}   ← the evidence trail

Guides in this hub

Connectors Every target, its scope grammar, and 4 simple use cases.API Accounts, connections, queries, audit, wallet, relays.MCP The agent tool surface at mcp.hebrah.com/mcp.Relay Enroll customer Postgres behind an outbound-only tunnel.Sandbox The synthetic EHR pack — FHIR domains, HL7, scenarios.SDKs Node.js + Python packages for sandbox and webhook surfaces.Webhooks HMAC signatures, retry/replay, reliability profiles.

Get started — $1 trial SKILL.md