srotzin

hive-mcp-log

Community srotzin
Updated

Structured log ingestion for the A2A network

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 W1 MONROE on Base L2.
SOLANA_WALLET B1N61cuL35fhskWz5dw8XqDyP6LWi3ZWmq8CNA9L3FVn B1 SPL recipient.
USDC_BASE canonical USDC contract on Base.
BASE_RPC https://mainnet.base.org
PUBLIC_BASE_URL https://hive-mcp-log.onrender.com
MAX_LINES_PER_INGEST 10000
MAX_BYTES_PER_INGEST 4194304 4 MB.
RETENTION_SWEEP_MS 3600000 1 hour.

Security & scope

  • Cross-DID reads are not exposed in v1 (own-DID only via tail/search).
  • No PII detection in v1; client-side discipline assumed. Schema check is a v1.1 candidate.
  • ZK cardinality attestation is a separate shim (hive-mcp-zk-attestation); not bundled.

License

MIT — Steve Rotzin / Hive Civilization

Hive Gamification

This MCP server is part of the Hive Civilization gamification surface (10-mechanic capability taxonomy).

Surface tags: gamification.spec.v1 · gamification.surface.public · gamification.signal.read-only · gamification.settlement.real-rails

Real rails on Base L2 (USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913). Read-only signal layer. Brand gold #C08D23.

Hive Civilization Directory

Part of the Hive Civilization — agent-native financial infrastructure.

Brand: #C08D23

MCP Server · Populars

MCP Server · New

    basementstudio

    xmcp

    The TypeScript MCP framework

    Community basementstudio
    MCP-Manager

    MCP Security Checklists

    MCP Server

    Community MCP-Manager
    mozarkai

    Optics Framework

    Open-source test automation for Android, iOS, web, smart TV (Android TV, Tizen, webOS) and Bluetooth (BLE) devices. Write tests as CSV/YAML, record them live, or let an AI agent build them over MCP. Self-healing locators: XPath, text, OCR, image.

    Community mozarkai
    baronunread

    rdyrct

    Open-source URL shortener for teams: branded short links, QR codes, and custom domains on Cloudflare Workers.

    Community baronunread
    ExpeditedProjects

    HutchDB

    A database for AI agents. No schema, SQL, or structure required. Claude Code, Codex, Cursor, Hermes, Claw, Grokbot, and other MCP clients store, query, and share the same records. Open source (AGPLv3) or cloud.

    Community ExpeditedProjects