{
  "markdown": "# hive-mcp-vault\n\n[![srotzin/hive-mcp-vault MCP server](https://glama.ai/mcp/servers/srotzin/hive-mcp-vault/badges/score.svg)](https://glama.ai/mcp/servers/srotzin/hive-mcp-vault)\n\nMCP access to confirmed HiveVault FENR reads and an AES-256-GCM encrypted item store.\n\n## Live contract\n\nThe server exposes four read-only MCP tools backed by the live HiveVault service:\n\n| Tool | Live backend route |\n|---|---|\n| `vault.balance` | `GET /vault/balance` |\n| `vault.stats` | `GET /vault/stats` |\n| `vault.identity` | `GET /vault/identity` |\n| `vault.quantum_pubkey` | `GET /vault/quantum/pubkey` |\n\n`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.\n\nThe server also exposes an encrypted item store:\n\n| Method | Path | Description |\n|---|---|---|\n| `POST` | `/v1/vault/store` | Store an AES-256-GCM encrypted item after the x402 gate |\n| `GET` | `/v1/vault/store/:item_ref` | Confirm a stored item exists without returning plaintext |\n\nUnknown paths return HTTP 404. Upstream failures return explicit MCP errors. The service does not return fabricated success payloads.\n\n## Discovery and health\n\n| Method | Path | Description |\n|---|---|---|\n| `GET` | `/health` | Readiness. This process plus current upstream reachability. Returns 503 and `degraded` when the upstream is unreachable |\n| `GET` | `/livez` | Liveness only. This process, no upstream claim. This is the path platform health checks should use |\n| `POST` | `/mcp` | MCP JSON-RPC 2.0, protocol `2024-11-05` |\n| `GET` | `/.well-known/mcp.json` | MCP discovery manifest |\n| `GET` | `/.well-known/agent-card.json` | A2A agent card |\n| `GET` | `/.well-known/agent.json` | Agent card |\n| `GET` | `/.well-known/oac.json` | Open Agent Card JSON-LD |\n| `GET` | `/llms.txt` | Plain-text integration guide |\n\n## Persistence\n\nSet `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.\n\n## Environment variables\n\n| Variable | Required | Purpose |\n|---|---|---|\n| `PORT` | No, default `3000` | HTTP port |\n| `VAULT_BACKEND_URL` | No, default `https://hive-vault.onrender.com` | Live HiveVault backend |\n| `INTERNAL_KEY` | Yes in production | Derives the local encryption key and is sent to the backend as `x-vault-key` |\n| `BOGO_DB_PATH` | Yes in production | SQLite database path on durable storage. Local development defaults to `/tmp/bogo_vault.db` |\n| `BASE_RPC_URL` | No, default `https://mainnet.base.org` | Base RPC endpoint used for x402 payment verification |\n\nThe server refuses to start with `NODE_ENV=production` if `INTERNAL_KEY` or `BOGO_DB_PATH` is missing.\n\n## Testing\n\n```bash\nnpm install\nnpm test\n```\n\nTests cover health reporting, unknown-route handling, MCP tool discovery, upstream failure behavior, encrypted storage, and plaintext absence from the SQLite file.\n\n## Brand\n\nHive Civilization. Brand gold `#C08D23`. Steve Rotzin.\n\n## Directory\n\n- Endpoint directory: https://thehiveryiq.com\n- Other MCP servers: https://github.com/srotzin?tab=repositories&q=hive-mcp\n",
  "bytes": 3258,
  "sha": "cc3d4f79179942021aa410a2521486e44c874f5567bf5b3c42c97196c4a59f11",
  "repo_slug": "srotzin/hive-mcp-vault",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_srotzin_hive_mcp_vault_c383316c/readme"
}