Hive Log

hive-mcp-log

インバウンド構造化ログ取り込みシム — Hive Civilization

x402 経由で NDJSON ログを 1 行あたり $0.0001 で取り込みます。保持期間のティア（1 日は無料、7 日は $0.005/MB、30 日は $0.02/MB）。テールおよび検索エンドポイント。純粋なプロトコルで、インバウンド専用です。アウトバウンド呼び出しはありません。

評議会の来歴：Tier A のインバウンド従量課金シムです。hive-mcp-auction および hive-mcp-barter のコンパニオンです。

---

概要

hive-mcp-log は、自律エージェント向けの従量課金ログ取り込み機能を公開する Model Context Protocol サーバーです。エージェントは構造化ログ（NDJSON）を POST し、Base L2 上の USDC で 1 行あたり $0.0001 を支払います。Tier 0（無料）では、テール／検索を通じて自身のログを読み戻せます。保持期間のティアによって行の保存期間が決まり、デフォルトの 1 日ティアは無料です。より長いティアには MB あたりの追加料金が発生します。

• プロトコル： Streamable-HTTP / JSON-RPC 2.0 上の MCP 2024-11-05
• トランスポート： POST /mcp
• 検出： GET /.well-known/mcp.json
• ヘルス： GET /health
• 決済： Base L2 上の USDC — 実際の決済レールであり、モックやシミュレーションではありません
• ブランドゴールド： Pantone 1245 C / #C08D23
• インバウンド専用： サービスから外部へ接続したり、DM を送信したり、データを取得したりすることはありません

MCP ツール

ツール	ティア	説明
log_ingest	従量課金	NDJSON バッチを取り込みます（最大 4 MB / 10k 行）。1 行あたり $0.0001 + 保持期間の追加料金。
log_tail	0（無料）	呼び出し元の DID の直近 N 件のログ行を返します。
log_search	0（無料）	時刻／重大度／タグ／フリーテキストで自身の DID のログを検索します。
log_retention_get	0（無料）	現在のティアと保存済みバイト数を返します。
log_retention_set	0（無料）	保持期間のティアを変更します（1d/7d/30d）。
log_today	0（無料）	今日の集計 — 取り込み数、行数、バイト数、charge_usd。

REST エンドポイント

メソッド	パス	用途
POST	/v1/log/ingest	NDJSON バッチを取り込みます。最初に 402 エンベロープを返し、決済には tx_hash を受け付けます。
GET	/v1/log/tail	did の直近 N 件の行。
GET	/v1/log/search	時刻／重大度／タグ／q で検索します。カーソルページネーションに対応します。
GET	/v1/log/retention	現在の保持期間ティアと月額費用の見積もり。
PATCH	/v1/log/retention	DID の保持期間ティアを変更します。
GET	/v1/log/today	今日の集計（Tier 0、無料）。
POST	/mcp	MCP JSON-RPC 2.0 インターフェース。
GET	/health	サービスのヘルス状態。

料金

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 取り込みの例

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" }
    ]
  }'

最初の呼び出しは、決済エンベロープ（Base L2 USDC）を含む 402 を返します。決済を完了した後、x-hive-tx: <hash> を付けて再送すると、同期検証されます。

テール／検索の例

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'

保持期間

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" }'

定期的なスイープ（デフォルトでは 1 時間ごと）により、各 DID の保持期間を超えた行が削除されます。

環境変数

変数	デフォルト	備考
PORT	3000
ENABLE	true	取り込みを無効にするには false に切り替えます（log_ingestion_disabled を伴う 503 を返します）。
WALLET_ADDRESS	0x15184bf50b3d3f52b60434f8942b7d52f2eb436e	Base L2 上の W1 MONROE。
SOLANA_WALLET	B1N61cuL35fhskWz5dw8XqDyP6LWi3ZWmq8CNA9L3FVn	B1 SPL 受取先。
USDC_BASE	canonical	Base 上の USDC コントラクト。
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 時間。

セキュリティと範囲

• v1 では DID をまたぐ読み取りは公開されていません（テール／検索は自身の DID のみ）。
• v1 では PII 検出を行いません。クライアント側での適切な取り扱いを前提としています。スキーマチェックは v1.1 の候補です。
• ZK カーディナリティ証明は別のシム（hive-mcp-zk-attestation）で提供され、同梱されていません。

ライセンス

MIT — Steve Rotzin / Hive Civilization

Hive Gamification

この MCP サーバーは、Hive Civilization のゲーミフィケーション機能の一部です（10 メカニズムの機能分類）。

• 機能分類：https://hive-gamification.onrender.com/.well-known/hive-gamification.json
• Centrifuge ダッシュボード：https://hive-gamification.onrender.com/.well-known/hive-centrifuge.json
• 統合 OpenAPI：https://hive-gamification.onrender.com/.well-known/openapi.json

サーフェスタグ： gamification.spec.v1 · gamification.surface.public · gamification.signal.read-only · gamification.settlement.real-rails

Base L2 上の実際の決済レール（USDC 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913）。読み取り専用のシグナルレイヤー。ブランドカラーのゴールド #C08D23。

Hive Civilization Directory

Hive Civilization の一部です — エージェントネイティブな金融インフラです。

• エンドポイントディレクトリ：https://thehiveryiq.com
• ライブリーダーボード：https://hive-a2amev.onrender.com/leaderboard
• 収益ダッシュボード：https://hivemine-dashboard.onrender.com
• その他の MCP サーバー：https://github.com/srotzin?tab=repositories&q=hive-mcp

ブランドカラー：#C08D23