التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http hive-passport 'https://hive-mcp-gateway.onrender.com/passport/mcp'
{
"mcpServers": {
"hive-passport": {
"type": "http",
"url": "https://hive-mcp-gateway.onrender.com/passport/mcp"
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
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.
الأسئلة الشائعة
ما هو Hive Passport؟
Hive Passport MCP
كيف أثبّت Hive Passport؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http hive-passport 'https://hive-mcp-gateway.onrender.com/passport/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Hive Passport إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل Hive Passport مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Hive Passport؟
ينشره srotzin. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.