About Hive Vault
Hive Vault is an MCP service connected to HiveVault, offering read-only balance, statistics, identity, and quantum public-key queries, plus AES-256-GCM encrypted item storage.
Key features
- 01Read balance, statistics, and identity
- 02Retrieve the quantum public key
- 03Store items with AES-256-GCM encryption
- 04Verify stored items without returning plaintext
Use cases
- 01Inspect read-only HiveVault data
- 02Retrieve the vault quantum public key
- 03Store encrypted items and confirm their presence
MCP support
The MCP service provides four read-only HiveVault query tools. Encrypted item storage is available through HTTP endpoints and gated by x402.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://hive-mcp-vault.onrender.com/mcpclaude mcp add --transport http srotzin-hive-mcp-vault https://hive-mcp-vault.onrender.com/mcp{"mcpServers":{"srotzin-hive-mcp-vault":{"type":"http","url":"https://hive-mcp-vault.onrender.com/mcp"}}}Open in Cursor{"servers":{"srotzin-hive-mcp-vault":{"type":"http","url":"https://hive-mcp-vault.onrender.com/mcp"}}}Open in VS Code{"mcpServers":{"srotzin-hive-mcp-vault":{"type":"http","url":"https://hive-mcp-vault.onrender.com/mcp"}}}{"mcpServers":{"srotzin-hive-mcp-vault":{"serverUrl":"https://hive-mcp-vault.onrender.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
4This tool takes no parameters.
Details
From the project READMEhive-mcp-vault
MCP access to confirmed HiveVault FENR reads and an AES-256-GCM encrypted item store.
Live contract
The server exposes four read-only MCP tools backed by the live HiveVault service:
| Tool | Live backend route |
|---|---|
vault.balance | GET /vault/balance |
vault.stats | GET /vault/stats |
vault.identity | GET /vault/identity |
vault.quantum_pubkey | GET /vault/quantum/pubkey |
vault.balance returns the backend response exactly as received. An unauthenticated response can be marked obfuscated: true; clients must not treat that value as a confirmed treasury balance.
The server also exposes an encrypted item store:
| Method | Path | Description |
|---|---|---|
POST | /v1/vault/store | Store an AES-256-GCM encrypted item after the x402 gate |
GET | /v1/vault/store/:item_ref | Confirm a stored item exists without returning plaintext |
Unknown paths return HTTP 404. Upstream failures return explicit MCP errors. The service does not return fabricated success payloads.
Discovery and health
| Method | Path | Description |
|---|---|---|
GET | /health | Readiness. This process plus current upstream reachability. Returns 503 and degraded when the upstream is unreachable |
GET | /livez | Liveness only. This process, no upstream claim. This is the path platform health checks should use |
POST | /mcp | MCP JSON-RPC 2.0, protocol 2024-11-05 |
GET | /.well-known/mcp.json | MCP discovery manifest |
GET | /.well-known/agent-card.json | A2A agent card |
GET | /.well-known/agent.json | Agent card |
GET | /.well-known/oac.json | Open Agent Card JSON-LD |
GET | /llms.txt | Plain-text integration guide |
Persistence
Set BOGO_DB_PATH to a path on durable storage in production. The default path, /tmp/bogo_vault.db, is suitable only for local development and tests. The server refuses to start in production unless an explicit database path is configured.
Environment variables
| Variable | Required | Purpose |
|---|---|---|
PORT | No, default 3000 | HTTP port |
VAULT_BACKEND_URL | No, default https://hive-vault.onrender.com | Live HiveVault backend |
INTERNAL_KEY | Yes in production | Derives the local encryption key and is sent to the backend as x-vault-key |
BOGO_DB_PATH | Yes in production | SQLite database path on durable storage. Local development defaults to /tmp/bogo_vault.db |
BASE_RPC_URL | No, default https://mainnet.base.org | Base RPC endpoint used for x402 payment verification |
The server refuses to start with NODE_ENV=production if INTERNAL_KEY or BOGO_DB_PATH is missing.
Testing
npm install
npm test
Tests cover health reporting, unknown-route handling, MCP tool discovery, upstream failure behavior, encrypted storage, and plaintext absence from the SQLite file.
Brand
Hive Civilization. Brand gold #C08D23. Steve Rotzin.
Directory
- Endpoint directory: https://thehiveryiq.com
- Other MCP servers: https://github.com/srotzin?tab=repositories&q=hive-mcp
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.