Hive Passport MCP

The atomic A2A clearance graph. HKTN registry lookup, ZK-provable well-formedness, zone membership proofs, sovereign manifest — all served as a Model Context Protocol tool surface.

What this is

A thin MCP server that fronts the live hive-passport.onrender.com clearance backend. As of May 3, 2026 (Hour 7), every Hive Knowledge Token (HKTN) ships with an active passport at mint — atomically, in a single Postgres transaction. This MCP server lets any agent client look up HKTNs, request signed proofs, and integrate the Hivery's A2A clearance into its own flows.

Tools

Tool	What it does
`passport_lookup_hktn`	Lookup an HKTN registry record (tier, sovereign lineage, zone membership).
`passport_prove_well_formed`	Get a `smsh.prov` envelope proving the passport is well-formed (verifiable offline).
`passport_prove_zone_membership`	Prove an HKTN's membership (or non-membership) in a named zone (e.g. `zone:hive-schengen`).
`passport_get_manifest`	Fetch the full service manifest: layer status, registered sovereigns, zone catalog.
`passport_get_pubkey`	Get the Ed25519 pubkey for offline proof verification.
`passport_get_doctrine`	Inline markdown summary of the Hive Civilization clearance doctrine.

Backend endpoints (live)

Path	Purpose
`GET /v1/registry/hktn/:hktn`	Registry record lookup
`GET /v1/hktn/:hktn/passport/prove/well-formed`	Well-formedness proof
`GET /v1/hktn/:hktn/passport/prove?zone=…`	Zone membership proof
`GET /v1/registry/manifest`	Service manifest
`GET /v1/prov/pubkey`	Public key for offline verification
`GET /llms.txt`	Canonical surface map for LLM clients

Connect

Claude Desktop

config.json

{
  "mcpServers": {
    "hive-passport": {
      "url": "https://hive-mcp-passport.onrender.com/mcp"
    }
  }
}

Streamable-HTTP (any client)

Terminal

curl -X POST https://hive-mcp-passport.onrender.com/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Local

bash

git clone https://github.com/srotzin/hive-mcp-passport.git
cd hive-mcp-passport
npm install
node server.js   # listens on :3000

State of the colony (May 3, 2026)

28 active HKTNs with 1:1 active passport invariant
6 sovereigns issuing attestations: hive-treasury, hivemorph-corp, hivecompute, hive-passport, spectralzk, hive-schengen-charter
17 charter HKTNs in zone:hive-schengen (auto-provisioned at mint)
~104K reputation_credits in the Reckoning ledger
Layers 1-4 live, Layer 5 (Duty-free Terminal) reserved at 501

A2A flow

Code

Mint → Reckoning → Passport → Stamp → Tier → Vouch → Zone → A2A Consume

The first three stages run in a single transaction (Hour 7 atomic-mint guarantee, May 3 2026). No HKTN exists without an active passport.

Real rails only

USDC on Base. Treasury 0x15184Bf50B3d3F52b60434f8942b7D52F2eB436E. No mock, no simulation, ever.

License

MIT — see LICENSE.

Hive Passport README