hive-mcp-backup
Snapshot and backup service for the A2A network. Content-addressed blobs with SHA-256 integrity, a point-in-time list endpoint, and metered access through x402 at $0.01 per GB-month of storage and $0.05 per restore. Inbound only.
Hive Civilization. Brand gold #C08D23 (Pantone 1245 C).
What it does
- Stores agent payloads up to 10 MB per object as content-addressed blobs on disk.
- Verifies every read with SHA-256 before returning bytes.
- Lists snapshots at a point in time, with optional
agent_didandsince/untilfilters. - Meters through x402: $0.01 per GB-month of storage, computed nightly per
agent_did; $0.05 per restore op.
MCP tools
| Tool | Purpose |
|---|---|
backup_create | Persist a payload up to 10 MB. Returns id and SHA-256 digest. |
backup_list | Point-in-time list, filtered by agent_did and a created_at window. |
backup_restore | Restore by id with SHA-256 verification. Tier 2; $0.05 via x402. |
REST endpoints
| Method | Path | Notes |
|---|---|---|
POST | /v1/backup/create | JSON, multipart up to 10 MB, or raw application/octet-stream. |
GET | /v1/backup/list | Filter by agent_did, since, until, limit, offset. |
GET | /v1/backup/{id} | Download. Verifies SHA-256. Metered. |
POST | /v1/backup/restore | Returns JSON with base64 body. Metered. |
GET | /v1/backup/today | Daily counters and storage-cost roll-up. |
GET | /health | Service health, store statistics, pricing. |
POST | /mcp | MCP 2024-11-05 over Streamable-HTTP / JSON-RPC 2.0. |
x402
| Surface | Price | Notes |
|---|---|---|
| Storage | $0.01 / GB-month | Computed daily from live byte total per agent_did. |
| Restore | $0.05 / op | Charged on /v1/backup/{id} and /v1/backup/restore. |
| Prepay bundle | $1.00 USDC | Buys an access token; restores draw from the prepaid balance until depletion. |
Settlement: USDC on Base L2.
Quick reference
# Create
curl -X POST $HOST/v1/backup/create \
-H 'content-type: application/json' \
-d '{"agent_did":"did:hive:agent-42","name":"state.json","body":{"v":1}}'
# List
curl -i "$HOST/v1/backup/list?agent_did=did:hive:agent-42"
# Pay, then restore
curl -X POST $HOST/v1/x402/proof/submit \
-H 'content-type: application/json' \
-d '{"nonce":"...","payer":"0x...","chain":"base","tx_hash":"0x..."}'
curl -i "$HOST/v1/backup/<id>" -H "X-Hive-Access: hive_..."
Configuration
| Variable | Default |
|---|---|
PORT | 3000 |
ENABLE | true |
WALLET_ADDRESS | 0x15184bf50b3d3f52b60434f8942b7d52f2eb436e |
BACKUP_PRICE_PER_GB_MONTH_USD | 0.01 |
BACKUP_PRICE_PER_RESTORE_USD | 0.05 |
BACKUP_PREPAY_BUNDLE_USD | 1.0 |
BACKUP_MAX_OBJECT_BYTES | 10485760 |
BACKUP_DB_PATH | /tmp/backup.db |
BACKUP_BLOB_DIR | /tmp/backup_blobs |
License
MIT.
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-footer -->