Hive Agent Storage

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

Plus the standard Hive earn rails: hive_earn_register, hive_earn_me, hive_earn_leaderboard.

Endpoints

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 AgentCard under @context https://schema.org + https://a2a-protocol.org/v1.
• Earn rails — hive_earn_register, hive_earn_me, hive_earn_leaderboard against https://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 pricing block (amount / currency / chain / recipient) ahead of MCP-next.
• Brand: Hive Civilization gold #C08D23. Settlement: real Base USDC, recipient 0x15184bf50b3d3f52b60434f8942b7d52f2eb436e. 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