Hive Passport
Hive Passport MCP
Open source Repository Open in the app JSON README (API)
About
Hive Passport MCP
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- srotzin
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-08-04T20:52:02Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 04:01:27
- Updated
- 2026-08-29 04:01:27
- Origin id
io.github.srotzin/hive-mcp-passport
README
# 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.
[](https://modelcontextprotocol.io)
[](https://thehiveryiq.com)
[](LICENSE)
## What this is
A thin MCP server that fronts the live [`hive-passport.onrender.com`](https://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
```json
{
"mcpServers": {
"hive-passport": {
"url": "https://hive-mcp-passport.onrender.com/mcp"
}
}
}
```
### Streamable-HTTP (any client)
```bash
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
```
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](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`.