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

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

Streamable-HTTP (any client)

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

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

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.

Links

• Live homepage: https://thehiveryiq.com/#hktn-provenance
• Passport backend: https://hive-passport.onrender.com
• Manifest: https://hive-passport.onrender.com/v1/registry/manifest
• Surface map: https://hive-passport.onrender.com/llms.txt

Brand gold: #FFB800.