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_did and since/until filters.
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