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

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

hive-mcp-agent-storage