Snapshot and restore service for agent state and DID-bound configuration.

Name: io.github.srotzin/hive-mcp-backup
Description: Snapshot and restore service for agent state and DID-bound configuration
Topics: hive-civilization, mcp, model-context-protocol, agent-commerce, x402
Readme excerpt: Provided in source data; describes content-addressed blobs with SHA-256 integrity, point-in-time list endpoint, and metered access

🛠️ Key Features

Stores agent payloads up to 10 MB per object as content-addressed blobs on disk
Verifies integrity for stored blobs using SHA-256
Point-in-time list endpoint for state snapshots
Metered access control via x402 pricing
Inbound-only MCP server for safety and isolation

🚀 Use Cases

Snapshotting and restoring agent state and DID-bound configurations
Content-addressed storage with integrity guarantees
Historical state enumeration for incident recovery or audits

⚡ Developer Benefits

Clear, README-friendly MCP server implementation
Grounded in standard MCP concepts (model-context-protocol)
Lightweight, inbound-only design suitable for backup pipelines

⚠️ Limitations

Inbound-only operation may require external triggers for restores
Storage and restore pricing indicated by readme excerpt; verify current terms
Thin readme excerpt; consult repository for detailed API schemas and endpoints

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.

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.

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.

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_..."

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

Install

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://hive-mcp-backup.onrender.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "hive-mcp-backup": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://hive-mcp-backup.onrender.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Hive Backup

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

hive-mcp-backup

What it does

MCP tools

REST endpoints

x402

Quick reference

Configuration

License

Hive Civilization Directory

Install

Remote endpoint

Related servers