Agent Surety

io.github.jdhart81由 GitHub 帳號 jdhart81 發布v0.2.0更新於 Nov 9, 2026

Counterparty risk transfer for the agent economy: agents post bonds behind their promises, wronged c

發布方自己的服務:Energyai

已驗證Streamable HTTP可網頁執行金融安全與監控

概覽

AI 產生的概覽

遠端 MCP 服務,用來為代理的承諾定價、發行、索賠與釋放保證債券,賠付須經仲裁裁定,並提供可驗證的稽核鏈。

可以做什麼
  • 定價與發行債券:依交易對手的歷史紀錄核保出確定性的保費報價,再以本金與保障期間發行債券
  • 管理債券生命週期:憑資金參照啟用已發行債券,於保障期結束後釋放剩餘本金,並依狀態列出或檢視債券
  • 處理索賠:對生效中的債券提出索賠,並執行仲裁裁定以扣減債券,賠付以可用餘額為上限
  • 驗證紀錄:檢核債券的防竄改稽核雜湊鏈,並讀取代理的能力與輸入約定
適用情境
當代理需要以押金為其承諾背書、而交易對手希望有可定價且可稽核的方式對違約索賠時使用。適合代理之間的信任與結算情境,賠付由仲裁裁定而非助理決定。
執行需求
需要遠端 streamable HTTP 端點;未宣告任何套件、環境變數或請求標頭。託管服務每個服務每天免費 10 次呼叫,付款、席次與 SLA 為付費選項;程式碼以 Apache-2.0 釋出,也可從儲存庫自行部署。
安裝前請注意
涉及真實資金:發行債券會凍結費用(預設 2%),啟用需連結支付通道交易,呼叫可能實際動用資金。索賠、扣減與釋放會改變債券狀態與賠付;扣減須提供裁定的案件編號與內容雜湊,且同一裁定最多賠付一次。託管服務層的支付、結算與客戶資料不在開源儲存庫中。

安裝

在 SourceWeft 中

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

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

交給代理程式安裝

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

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

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

其他 MCP 客戶端

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

{
  "mcpServers": {
    "agent-surety": {
      "type": "http",
      "url": "https://mcp.viridisconservation.com/surety/mcp"
    }
  }
}

README

Viridis Agent Fleet: open-source agents for the agent economy

Deterministic, auditable MCP agents: trust and settlement rails (identity, trust, escrow, metering, arbitration, notary, surety, provenance, covenant, offsets, compute-ledger) and priced-grade services (tax credits, GHG accounting, construction takeoff, measurement, compliance). Every core is pure Python with no LLM in the serving path, and every result is content-addressed so anyone can re-verify it.

Licensed Apache-2.0. Run any agent yourself, fork it, embed it.

Run an agent locally (free, forever)

bash
pip install -r requirements-dev.txtpython3 agent-escrow-agent/adapters/mcp_server.py          # stdio MCPpython3 run_fleet_tests.py                                 # every agent's invariant tests

Or use the hosted fleet

https://mcp.viridisconservation.com runs all agents as one managed MCP service:

Self-hosted (this repo)Hosted by Viridis
Agent logic & verification✅ identical✅ identical
Viridis-signed receipts & notary chain–✅
Shared trust/reputation network data–✅
Maintained rule packs (tax, GHG factors, regs)snapshot✅ kept current
Payments (x402, card), seats, SLA–✅

Free tier: 10 calls/day per service; the rails (identity, escrow, metering…) are free forever. Verification is always free.

For agents

Agents and LLM tools can start from llms.txt, a generated index of every agent, and AGENTS.md, the rules for using and changing the fleet.

Part of the Viridis open-source commons

Building agents for conservation or energy work? VergeCommon and EnergyAI MCP also expose MCP tools, and ViridisOS serves its decision functions to agents over MCP.

This project is one of a connected set of open tools from Viridis. Each stands on its own; together they run from field evidence to checked decisions.

Conservation commons

Verifiable science

  • Viridis Canon: machine-checked Lean 4 mathematics for ecological decisions, with a DOI for every result
  • ViridisOS: open reference runtime for DOI-backed decision modules and recomputable results
  • Viridis Research: the nightly public research record, each claim labeled by what a verifier actually checked
  • ProofLens: see what a Lean statement means before reading the proof

Agent tools

  • Viridis Agent Fleet (this repository): open-source MCP agents with deterministic, auditable cores
  • EnergyAI MCP: energy-planning estimates and incentive sources for AI agents

Browse every project on the Viridis profile. If this one is useful to you, a star helps other people find it.

Boundary

This repo contains agent cores, MCP adapters, tests, standards and self-host tooling. The hosted service layer (gateway, payment and settlement, seats, signing authority, operations, telemetry and customer data) is proprietary and is not in this repo. Please don't open PRs that add it.

"Viridis", "Viridis Conservation" and the Viridis marks are trademarks of Viridis LLC; see TRADEMARKS.md.

來源:README.md,提交 350712c

工具

10

post_bond

Post a surety bond behind an agent's promises. principal is a positive integer in minor units; expires_at is the ISO-8601 coverage window end. The bond fee (2% default) is computed and frozen at post.

輸入參數coveragecurrencyprincipal必填expires_at必填principal_agent必填

activate_bond

Mark a POSTED bond ACTIVE (idempotent). funding_ref links the payment rail transaction that funded the stake.

輸入參數bond_id必填funding_ref

file_claim

File a claim against an ACTIVE bond. Claims pay out ONLY when an arbitration ruling upholds them (see slash_bond).

輸入參數reasonbond_id必填claimant必填amount_minor必填

slash_bond

Execute an arbitration ruling against a claim. Requires the ruling's case id + content hash from agent-arbitration — no ruling, no slash; a given ruling pays at most once. Payout caps at the bond's available balance (over-claims exhaust the bond).

輸入參數upheldbond_id必填claim_id必填ruling_hash必填ruling_case_id必填

release_bond

Release the remaining stake to the principal after the coverage window elapses — refused while any claim is still open.

輸入參數bond_id必填

bond_status

Current record for a bond (state, balances, claims, audit head).

輸入參數bond_id必填

list_bonds

List bonds, optionally filtered by state (POSTED|ACTIVE|RELEASED|EXHAUSTED).

輸入參數state

verify_audit

Validate the tamper-evident audit hash chain for a bond.

輸入參數bond_id必填

price_bond

Underwrite a surety bond: deterministic actuarial premium quote from a counterparty's track record (attestations, notarized deliveries, completed bonds lower the rate; slashes raise it or decline outright). Integer-only model uw-v1; the returned quote_hash lets any party recompute and verify the quote. Pure — never mutates bond state.

輸入參數slashesattestationsduration_days必填slashed_minorcoverage_minor必填bonds_completedsuccessful_deliveries

describe_agent

Return capabilities and input contract.

無需輸入參數。

版本歷史

1
  1. v0.2.0最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

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

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Energyaisolution 整合