hive-mcp-log

Inbound structured-log ingestion shim — Hive Civilization

NDJSON log ingestion at $0.0001/line via x402. Retention tiers (1d free, 7d $0.005/MB, 30d $0.02/MB). Tail + search endpoints. Pure protocol — inbound only, no outbound calls.

Council provenance: Tier A inbound metering shim. Companion to hive-mcp-auction and hive-mcp-barter.

---

What this is

hive-mcp-log is a Model Context Protocol server exposing a metered log ingestion surface for autonomous agents. Agents POST structured logs (NDJSON) and pay $0.0001/line in USDC on Base L2. They read their own logs back via tail/search at Tier 0 (free). Retention tier governs how long lines persist; the default 1-day tier is free, longer tiers carry a per-MB surcharge.

• Protocol: MCP 2024-11-05 over Streamable-HTTP / JSON-RPC 2.0
• Transport: POST /mcp
• Discovery: GET /.well-known/mcp.json
• Health: GET /health
• Settlement: USDC on Base L2 — real rails, no mock, no simulated
• Brand gold: Pantone 1245 C / #C08D23
• Inbound only: the service never reaches out, never DMs, never pulls

MCP tools

Tool	Tier	Description
log_ingest	metered	Ingest NDJSON batch (max 4 MB / 10k lines). $0.0001/line + retention surcharge.
log_tail	0 (free)	Return last N log lines for the calling DID.
log_search	0 (free)	Search own-DID logs by time/severity/tag/free-text.
log_retention_get	0 (free)	Return current tier + bytes stored.
log_retention_set	0 (free)	Change retention tier (1d/7d/30d).
log_today	0 (free)	Today aggregate — ingests, lines, bytes, charge_usd.

REST endpoints

Method	Path	Purpose
POST	/v1/log/ingest	Ingest NDJSON batch. Returns 402 envelope first, accepts tx_hash to settle.
GET	/v1/log/tail	Last N lines for did.
GET	/v1/log/search	Search by time/severity/tag/q. Cursor pagination.
GET	/v1/log/retention	Current retention tier + monthly cost projection.
PATCH	/v1/log/retention	Change retention tier for a DID.
GET	/v1/log/today	Today aggregate (Tier 0, free).
POST	/mcp	MCP JSON-RPC 2.0 surface.
GET	/health	Service health.

Pricing

Ingest:    $0.0001 per log line
Retention:
  1d   (default)   free
  7d               $0.005 / MB
  30d              $0.02  / MB
Tail / search (own-DID):  Tier 0 — free

NDJSON ingest example

curl -X POST https://hive-mcp-log.onrender.com/v1/log/ingest \
  -H 'content-type: application/json' \
  -H 'x-hive-did: did:hive:agent-foo' \
  -d '{
    "did": "did:hive:agent-foo",
    "retention_class": "7d",
    "lines": [
      { "ts": "2026-04-27T20:00:00Z", "severity": "info",  "tag": "tool", "msg": "tool_call ok" },
      { "ts": "2026-04-27T20:00:01Z", "severity": "error", "tag": "llm",  "msg": "rate_limited" }
    ]
  }'

The first call returns a 402 with the payment envelope (Base L2 USDC). Settle, then resend with x-hive-tx: <hash> for synchronous verification.

Tail / search example

curl 'https://hive-mcp-log.onrender.com/v1/log/tail?did=did:hive:agent-foo&n=20'
curl 'https://hive-mcp-log.onrender.com/v1/log/search?did=did:hive:agent-foo&severity=error&q=rate'

Retention

curl -X PATCH https://hive-mcp-log.onrender.com/v1/log/retention \
  -H 'content-type: application/json' \
  -d '{ "did": "did:hive:agent-foo", "tier": "7d" }'

A periodic sweep (default hourly) prunes lines older than each DID's retention window.

Environment

Var	Default	Notes
PORT	3000
ENABLE	true	Flip to false to disable ingestion (returns 503 with log_ingestion_disabled).
WALLET_ADDRESS	0x15184bf50b3d3f52b60434f8942b7d52f2eb436e	W

... View full README on GitHub