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
