Hive Agent Quota

hive-mcp-agent-quota

A2A ネットワーク向けのエージェントごとのクォータメーターです。quota_check を呼び出すたびに、エージェントの DID に対して 1 単位以上を消費し、x402 エンベロープを介して Base L2 上で 1 単位あたり $0.001 USDC で決済されます。インバウンドのみです。デフォルトでは ENABLE=true です。

ブランドカラー：#C08D23（Pantone 1245 C、Hive Civilization ゴールド）。

インターフェース

レイヤー	エンドポイント	説明
MCP	POST /mcp	JSON-RPC 2.0、Streamable-HTTP、プロトコル 2024-11-05。
検出	GET /.well-known/mcp.json	ツール一覧とトランスポートのメタデータ。
REST	POST /v1/quota/check	DID の単位を消費します。残高も支払い証明もない場合は 402 を返します。
REST	GET /v1/quota/balance?did=…	DID の残りクォータを読み取ります。
REST	GET /v1/quota/today	UTC 日次台帳のスナップショット。
REST	GET /v1/quota/estimate?units=N	N 単位の提示額と下限額を USDC で表示します。
ヘルス	GET /health	稼働状況、価格、受取アドレス。
ルート	GET /	ブラウザーには HTML、エージェントには JSON を返します（Accept ヘッダーを判定）。JSON-LD SoftwareApplication。

ツール

名前	ティア	コスト	説明
quota_check	1	$0.001/単位	x402 を介して DID の N 単位を消費します。
quota_balance	0	無料	DID の残りクォータ。
quota_topup_estimate	0	無料	N 単位の提示額と下限額。

価格設定と物々交換の下限額

価格設定は hivemorph の物々交換パターンを継承しています。各 402 エンベロープには amount_usd（提示額）と accept_min_usd（下限額）の両方が表示されます。クライアントは、オンチェーンの支払額が [floor, asking] の範囲内にある支払い証明を送信でき、シムはそれを受け入れます。

以下のデフォルト値は、すべて環境変数で上書きできます。

変数	デフォルト	備考
QUOTA_CHECK_PRICE_USDC	0.001	1 単位あたりの提示価格。
HIVE_X402_FLOOR_PCT_DEFAULT	0.70	提示額に対する下限額の割合。
HIVE_X402_FLOOR_MIN_PCT	0.30	下限のハードクランプ。
HIVE_X402_FLOOR_MAX_PCT	0.95	上限のハードクランプ。

そのため、デフォルト設定での 1 単位のチェックでは、提示額 $0.0010、受け入れ下限額 $0.0007 が表示されます。100 単位のチェックでは、提示額 $0.1000、受け入れ下限額 $0.0700 が表示されます。下限額は提示額の MIN_PCT を下回らず、MAX_PCT を上回りません。

決済

フィールド	値
チェーン	Base L2
資産	USDC
コントラクト	0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
受取先	WALLET_ADDRESS 環境変数。デフォルトは 0x15184bf50b3d3f52b60434f8942b7d52f2eb436e
検証	BASE_RPC_URL に対して provider.getTransactionReceipt(tx_hash) を実行し、受取先への USDC Transfer ログをデコードして、6 桁の小数単位で金額を合計し、accept_min_usd と比較します。
署名（任意）	ethers.verifyMessage(message, signature) で支払者を復元します。オンチェーンの from と一致しない場合は拒否されます。

モックはありません。オンチェーンのチェックでは Base メインネットに対して実際に RPC を読み取ります。

ストレージ

QUOTA_DB_PATH（デフォルトは /tmp/quota.db）にある SQLite。テーブルは 3 つです。

• quotas (did, units_purchased, units_consumed, first_seen, last_seen)
• checks (id, did, unit_count, granted, remaining, tx_hash, paid_usdc, ts)
• topups (id, did, units, paid_usdc, tx_hash UNIQUE, payer, ts)

topups の tx_hash は UNIQUE で、リプレイを 409 にします。

x402 エンベロープ

前払い残高も支払い証明もない状態で quota_check を呼び出すと、次の応答が返されます。

{
  "error": "payment_required",
  "x402_version": 1,
  "payment": {
    "nonce": "…",
    "amount_usd": 0.001,
    "accept_min_usd": 0.0007,
    "accepts": [{
      "chain": "base",
      "asset": "USDC",
      "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "decimals": 6,
      "recipient": "0x15184bf50b3d3f52b60434f8942b7d52f2eb436e",
      "scheme": "exact"
    }],
    "expires_at": 1761600000,
    "tier": 1,
    "product": "agent_quota_check",
    "unit_count": 1,
    "price_per_unit_usd": 0.001,
    "floor_pct": 0.70
  }
}

クライアントは Base 上の受取先に USDC を送信し、その後、支払い証明を含む X-Payment ヘッダーを付けて同じリクエストを再送信します。

X-Payment: {"nonce":"…","chain":"base","tx_hash":"0x…","payer":"0x…","signature":"0x…","message":"hive-quota:<nonce>"}

signature と message は任意です。指定されている場合、復元されたアドレスは payer およびオンチェーンの from と一致する必要があります。

環境

変数	デフォルト	備考
PORT	3000
ENABLE	true	tools/call を無効にするには false に設定します。
WALLET_ADDRESS	0x15184bf50b3d3f52b60434f8942b7d52f2eb436e	Base 上の USDC 受取先です。
QUOTA_CHECK_PRICE_USDC	0.001	1 単位あたりの請求額です。
HIVE_X402_FLOOR_PCT_DEFAULT	0.70
HIVE_X402_FLOOR_MIN_PCT	0.30
HIVE_X402_FLOOR_MAX_PCT	0.95
BASE_RPC_URL	https://mainnet.base.org
DEFAULT_QUOTA_UNITS	0	DID を初めて確認した際に付与される無料単位数です。
QUOTA_DB_PATH	/tmp/quota.db

ローカルでの実行

npm install
node server.js

次に：

curl -s http://localhost:3000/health
curl -s -X POST http://localhost:3000/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
curl -s 'http://localhost:3000/v1/quota/today'

厳守事項

• インバウンドのみです。このシムがアウトバウンド決済を開始することはありません。
• リポジトリに秘密鍵はありません。検証は読み取り専用です。
• 資産の保管は行いません。受取アドレスはシムではなく、運営者が所有します。
• BASE_RPC_URL によってオンチェーンの受領が確認されるまでは、返却値は参考情報です。

Council の来歴

Tier A ポジション 3。2026-04-27。インバウンドの従量課金インターフェースです。 hive-mcp-barter（アウトバウンドの対抗オファー）および hive-mcp-auction （インバウンドのリバース・ダッチ）と対称的です。

ライセンス

MIT。LICENSE を参照してください。

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