Hive Agent Quota

io.github.srotzin由 GitHub 帳號 srotzin 發布v1.0.0更新於 Nov 2, 2026

Per-agent rate limits and quota enforcement for the Hive A2A economy

已驗證Streamable HTTP可網頁執行金融開發者工具

概覽

AI 產生的概覽

遠端 MCP 端點，為 Hive A2A 網路依代理計量配額，每消耗一個配額單位以 Base 上的 USDC 結算。

可以做什麼
  • 依代理 DID 查詢並消耗配額單位，透過 x402 支付信封依單位付費
  • 讀取某個 DID 的剩餘配額餘額
  • 估算指定單位數的報價與可接受的最低金額（USDC）
  • 透過 REST 端點提供相同操作，包括 UTC 當日帳本快照與健康檢查
適用情境
適用於在 Hive A2A 網路上建置或營運代理、需要依代理做限流或配額核算並以 Base 上的 USDC 結算的情境。多數助理與一般用途並不需要它。
執行需求
遠端 streamable-HTTP 端點，無需本機安裝。消耗單位的呼叫需要一個有餘額的 Base L2 錢包，能向公布的收款地址發送 USDC 並回傳 X-Payment 證明標頭。伺服器本身透過 RPC 位址讀取 Base 主網。
安裝前請注意
quota_check 會實際花錢：每個單位以 Base 主網 USDC 支付給營運方錢包地址，支付證明會在鏈上核驗。公布的收款地址與價格屬第三方聲明，付款前請自行確認。此服務會在自己的資料庫中保存依 DID 的使用紀錄。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Hive Agent Quota，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.srotzin%2Fhive-mcp-agent-quota/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "hive-agent-quota": {
      "type": "http",
      "url": "https://hive-mcp-agent-quota.onrender.com/mcp"
    }
  }
}

README

hive-mcp-agent-quota

[srotzin/hive-mcp-agent-quota MCP server]

Per-agent quota meter for the A2A network. Each call to quota_check consumes one or more units against an agent's DID and is settled at $0.001 USDC per unit on Base L2 via the x402 envelope. Inbound only. ENABLE=true by default.

Brand color: #C08D23 (Pantone 1245 C, Hive Civilization gold).

Surface

LayerEndpointDescription
MCPPOST /mcpJSON-RPC 2.0, Streamable-HTTP, protocol 2024-11-05.
DiscoveryGET /.well-known/mcp.jsonTool list and transport metadata.
RESTPOST /v1/quota/checkConsume units for a DID. 402 if no balance and no proof.
RESTGET /v1/quota/balance?did=…Read remaining quota for a DID.
RESTGET /v1/quota/todayUTC-day ledger snapshot.
RESTGET /v1/quota/estimate?units=NAsking and floor in USDC for N units.
HealthGET /healthLiveness, pricing, recipient address.
RootGET /HTML for browsers, JSON for agents (Accept-header sniff). JSON-LD SoftwareApplication.

Tools

NameTierCostDescription
quota_check1$0.001/unitConsume N units for a DID via x402.
quota_balance0freeRemaining quota for a DID.
quota_topup_estimate0freeAsking and floor for N units.

Pricing and the barter floor

Pricing inherits the hivemorph barter pattern. Every 402 envelope advertises both amount_usd (asking) and accept_min_usd (floor). A client may submit a proof whose on-chain paid amount is anywhere in [floor, asking] and the shim accepts it.

Defaults, all overridable by environment variable:

VariableDefaultNotes
QUOTA_CHECK_PRICE_USDC0.001Per-unit asking price.
HIVE_X402_FLOOR_PCT_DEFAULT0.70Floor as fraction of asking.
HIVE_X402_FLOOR_MIN_PCT0.30Hard lower clamp.
HIVE_X402_FLOOR_MAX_PCT0.95Hard upper clamp.

So a 1-unit check at the defaults advertises asking $0.0010 and accept-min $0.0007. A 100-unit check advertises asking $0.1000 and accept-min $0.0700. The floor never falls below MIN_PCT of asking and never exceeds MAX_PCT.

Settlement

FieldValue
ChainBase L2
AssetUSDC
Contract0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
RecipientWALLET_ADDRESS env, default 0x15184bf50b3d3f52b60434f8942b7d52f2eb436e
Verificationprovider.getTransactionReceipt(tx_hash) against BASE_RPC_URL, decode USDC Transfer logs to recipient, sum amount in 6-decimal units, compare to accept_min_usd.
Signature (optional)ethers.verifyMessage(message, signature) recovers payer; rejected if it disagrees with the on-chain from.

No mocks. The on-chain check is a real RPC read against Base mainnet.

Storage

SQLite at QUOTA_DB_PATH (default /tmp/quota.db), three tables:

  • 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)

tx_hash is UNIQUE on topups to make replay a 409.

x402 envelope

A quota_check call with no prepaid balance and no proof returns:

json
{  "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  }}

The client sends USDC to the recipient on Base, then resubmits the same request with an X-Payment header containing the proof:

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

signature and message are optional. If supplied, the recovered address must match payer and the on-chain from.

Environment

VariableDefaultNotes
PORT3000
ENABLEtrueSet to false to disable tools/call.
WALLET_ADDRESS0x15184bf50b3d3f52b60434f8942b7d52f2eb436eUSDC recipient on Base.
QUOTA_CHECK_PRICE_USDC0.001Per-unit asking.
HIVE_X402_FLOOR_PCT_DEFAULT0.70
HIVE_X402_FLOOR_MIN_PCT0.30
HIVE_X402_FLOOR_MAX_PCT0.95
BASE_RPC_URLhttps://mainnet.base.org
DEFAULT_QUOTA_UNITS0Free units credited on first sight of a DID.
QUOTA_DB_PATH/tmp/quota.db

Running locally

npm installnode server.js

Then:

curl -s http://localhost:3000/healthcurl -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'

Hard rules

  • Inbound only. The shim never originates an outbound payment.
  • No private key in the repo. Verification is read-only.
  • No custody. The recipient address belongs to the operator, not the shim.
  • Returns are advisory until the on-chain receipt is confirmed by BASE_RPC_URL.

Council provenance

Tier A position 3. 2026-04-27. Inbound metering surface, symmetric to hive-mcp-barter (outbound counter-offer) and hive-mcp-auction (inbound reverse-Dutch).

License

MIT. See LICENSE.

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

來源：README.md，提交 8e8cd29

工具

0
SourceWeft 尚未讀取此伺服器的工具。

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分