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.