# Hive Passport [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/srotzin/hive-mcp-passport  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/hive-passport

## Description
Hive Passport MCP

## Tools
Capabilities this server exposes over MCP:

- **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.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "hive-passport": {
    "command": "npx",
    "args": ["-y","hive-passport"]
  }
}
```

## Documentation & 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.

[![MCP](https://img.shields.io/badge/MCP-2024--11--05-FFB800)](https://modelcontextprotocol.io)
[![Hive](https://img.shields.io/badge/Hive-Civilization-FFB800)](https://thehiveryiq.com)
[![License](https://img.shields.io/badge/license-MIT-green)](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](https://github.com/srotzin/hive-mcp-passport/blob/HEAD/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`.