{
  "markdown": "# Hive Passport MCP\n\n> **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.\n\n[![MCP](https://img.shields.io/badge/MCP-2024--11--05-FFB800)](https://modelcontextprotocol.io)\n[![Hive](https://img.shields.io/badge/Hive-Civilization-FFB800)](https://thehiveryiq.com)\n[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)\n\n## What this is\n\nA 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.\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `passport_lookup_hktn` | Lookup an HKTN registry record (tier, sovereign lineage, zone membership). |\n| `passport_prove_well_formed` | Get a `smsh.prov` envelope proving the passport is well-formed (verifiable offline). |\n| `passport_prove_zone_membership` | Prove an HKTN's membership (or non-membership) in a named zone (e.g. `zone:hive-schengen`). |\n| `passport_get_manifest` | Fetch the full service manifest: layer status, registered sovereigns, zone catalog. |\n| `passport_get_pubkey` | Get the Ed25519 pubkey for offline proof verification. |\n| `passport_get_doctrine` | Inline markdown summary of the Hive Civilization clearance doctrine. |\n\n## Backend endpoints (live)\n\n| Path | Purpose |\n|---|---|\n| `GET /v1/registry/hktn/:hktn` | Registry record lookup |\n| `GET /v1/hktn/:hktn/passport/prove/well-formed` | Well-formedness proof |\n| `GET /v1/hktn/:hktn/passport/prove?zone=…` | Zone membership proof |\n| `GET /v1/registry/manifest` | Service manifest |\n| `GET /v1/prov/pubkey` | Public key for offline verification |\n| `GET /llms.txt` | Canonical surface map for LLM clients |\n\n## Connect\n\n### Claude Desktop\n```json\n{\n  \"mcpServers\": {\n    \"hive-passport\": {\n      \"url\": \"https://hive-mcp-passport.onrender.com/mcp\"\n    }\n  }\n}\n```\n\n### Streamable-HTTP (any client)\n```bash\ncurl -X POST https://hive-mcp-passport.onrender.com/mcp \\\n  -H 'Content-Type: application/json' \\\n  -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}'\n```\n\n### Local\n```bash\ngit clone https://github.com/srotzin/hive-mcp-passport.git\ncd hive-mcp-passport\nnpm install\nnode server.js   # listens on :3000\n```\n\n## State of the colony (May 3, 2026)\n\n- **28 active HKTNs** with 1:1 active passport invariant\n- **6 sovereigns** issuing attestations: `hive-treasury`, `hivemorph-corp`, `hivecompute`, `hive-passport`, `spectralzk`, `hive-schengen-charter`\n- **17 charter HKTNs** in `zone:hive-schengen` (auto-provisioned at mint)\n- **~104K reputation_credits** in the Reckoning ledger\n- **Layers 1-4 live**, Layer 5 (Duty-free Terminal) reserved at 501\n\n## A2A flow\n\n```\nMint → Reckoning → Passport → Stamp → Tier → Vouch → Zone → A2A Consume\n```\n\nThe first three stages run in a single transaction (Hour 7 atomic-mint guarantee, May 3 2026). No HKTN exists without an active passport.\n\n## Real rails only\n\nUSDC on Base. Treasury `0x15184Bf50B3d3F52b60434f8942b7D52F2eB436E`. No mock, no simulation, ever.\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\n## Links\n\n- **Live homepage:** https://thehiveryiq.com/#hktn-provenance\n- **Passport backend:** https://hive-passport.onrender.com\n- **Manifest:** https://hive-passport.onrender.com/v1/registry/manifest\n- **Surface map:** https://hive-passport.onrender.com/llms.txt\n\nBrand gold: `#FFB800`.\n",
  "bytes": 3665,
  "sha": "f775dc874f2140aae117ad251e4f2cafc2655c77116d78fe6b3cb6aeff12da56",
  "repo_slug": "srotzin/hive-mcp-passport",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_srotzin_hive_mcp_passport_757d6ee2/readme"
}