Hive Agent Storage
Encrypted A2A object storage for autonomous agent state and artifacts
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
claude mcp add --transport http hive-agent-storage 'https://hive-mcp-agent-storage.onrender.com/mcp'
{
"mcpServers": {
"hive-agent-storage": {
"type": "http",
"url": "https://hive-mcp-agent-storage.onrender.com/mcp"
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
hive-mcp-agent-storage
Agent-native object storage MCP server. Per-agent DID isolation. x402 pay-per-byte. Real Base USDC.
https://hive-mcp-agent-storage.onrender.com/mcp
Hive Agent Storage
Agent-native object storage with per-agent DID isolation and x402 pay-per-byte metering.
hive-mcp-agent-storage is a Model Context Protocol (MCP) server that gives autonomous agents a first-class object-storage primitive. Each agent gets its own DID-isolated namespace; reads inside the namespace are free, writes are metered per KB in real Base USDC, and cross-DID reads are metered per KB. Storage is routed under the hood to Storj (hot), Filecoin (warm), or Arweave (cold) depending on retention class.
The differentiator is not a new storage backend. It is the agent-native shape: DID-scoped namespaces, x402 settlement, content-addressed receipts, and an MCP/A2A-compatible discovery surface.
- Protocol: MCP 2024-11-05 over Streamable-HTTP / JSON-RPC 2.0
- A2A: AgentCard at
/.well-known/agent.json - x402: every paid call settles in real Base USDC to
0x15184bf50b3d3f52b60434f8942b7d52f2eb436e - Rails: USDC on Base L2 — no mocks, no testnet, no dev-trust
- Author: Steve Rotzin · Hive Civilization · brand gold
#C08D23(Pantone 1245 C)
Backend status — pending
The MCP shim, registry manifests, AgentCard, and JSON-LD ship today as a discovery anchor. The upstream backend at hivemorph.onrender.com/v1/storage/* is not yet live. Until it ships, every storage tool returns a 503-shape body:
{
"error": "backend_pending",
"retry_after": 86400,
"detail": "Hive Agent Storage backend endpoints (/v1/storage/*) are not yet live...",
"brand": "#C08D23"
}
The shared hive_earn_* tools route to live /v1/earn/* endpoints and behave normally.
Tools
| Tool | Purpose | Pricing |
|---|---|---|
agent_storage_put | Upload bytes into an agent-isolated namespace. Choose hot/warm/cold retention class. | $0.0001/KB upload, real Base USDC |
agent_storage_get | Read an object. Free for own DID. | $0.00005/KB cross-DID, real Base USDC |
agent_storage_list | List object keys with prefix + pagination. | Free |
agent_storage_delete | Tombstone an object (owner-only). | Free |
agent_storage_quota | Bytes used / allocated / object count / lifetime spend. | Free |
Plus the standard Hive earn rails: hive_earn_register, hive_earn_me, hive_earn_leaderboard.
Endpoints
| Path | Purpose |
|---|---|
POST /mcp | JSON-RPC 2.0 / MCP 2024-11-05 |
GET / | HTML landing with comprehensive meta tags + JSON-LD |
GET /health | Health + telemetry |
GET /.well-known/mcp.json | MCP discovery descriptor |
GET /.well-known/agent.json | A2A AgentCard |
GET /.well-known/oac.json | Open Agent Card JSON-LD |
GET /.well-known/security.txt | RFC 9116 security contact |
GET /robots.txt | Allow-all crawl policy |
GET /sitemap.xml | Crawler sitemap |
GET /og.svg | 1200×630 Hive-gold OG image |
GET /seo.json | JSON-LD structured data (SoftwareApplication) |
Connect
Claude Desktop / Cursor / Manus and other MCP clients can mount the server via Streamable-HTTP:
{
"mcpServers": {
"hive-agent-storage": {
"url": "https://hive-mcp-agent-storage.onrender.com/mcp"
}
}
}
Smithery one-click install: https://smithery.ai/server/hivecivilization (server: hive-mcp-agent-storage).
Architecture
MCP / A2A clients
│
▼
hive-mcp-agent-storage (this repo)
│ per-agent DID isolation
│ x402 metering shim
▼
/v1/storage/* (hivemorph.onrender.com — pending)
│
├─ Storj (hot, frequent access)
├─ Filecoin (warm, periodic access)
└─ Arweave (cold, permanent)
Per-agent DID isolation means:
- The agent's DID is the namespace key. Reads/writes inside the namespace require an API key bound to that DID at HiveGate.
- Cross-DID reads are explicitly metered and audited; there is no implicit trust.
- Tombstone receipts are chain-attested; cold-tier (Arweave) deletes unlink from the namespace but the object remains on-chain by design.
License
MIT. © Steve Rotzin / Hive Civilization. Brand gold #C08D23 (Pantone 1245 C). Never #f5c518.
Agent-native (v1.0.0)
This shim ships the Hive Civilization agent-native bundle so any A2A or MCP-aware agent can discover, pay, and earn:
- A2A AgentCard —
GET /.well-known/agent.json(also at/agent.json). - Open Agent Card (OAC) JSON-LD — embedded inline at
/and/agent.html, with@type SoftwareApplication+@type AgentCardunder@contexthttps://schema.org+https://a2a-protocol.org/v1. - Earn rails —
hive_earn_register,hive_earn_me,hive_earn_leaderboardagainsthttps://hivemorph.onrender.com/v1/earn/*. Resilient to upstream cold-start. - x402 propagation — paid responses pass through the upstream 402 body untouched so the consuming agent can auto-pay.
- Pricing annotations — every paid tool descriptor carries a non-standard
pricingblock (amount / currency / chain / recipient) ahead of MCP-next. - Brand: Hive Civilization gold
#C08D23. Settlement: real Base USDC, recipient0x15184bf50b3d3f52b60434f8942b7d52f2eb436e. No mock, no testnet.
Hive Civilization Directory
Part of the Hive Civilization — agent-native financial infrastructure.
- Endpoint Directory: https://thehiveryiq.com
- Live Leaderboard: https://hive-a2amev.onrender.com/leaderboard
- Revenue Dashboard: https://hivemine-dashboard.onrender.com
- Other MCP Servers: https://github.com/srotzin?tab=repositories&q=hive-mcp
Brand: #C08D23
الأسئلة الشائعة
ما هو Hive Agent Storage؟
Encrypted A2A object storage for autonomous agent state and artifacts
كيف أثبّت Hive Agent Storage؟
يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http hive-agent-storage 'https://hive-mcp-agent-storage.onrender.com/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج Hive Agent Storage إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل Hive Agent Storage مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون Hive Agent Storage؟
ينشره srotzin. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.