Agent Compute Ledger

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

Compute-is-carbon energy/carbon ledger for agent work with Landauer-limit validation.

發布方自己的服務：Energyai

已驗證Streamable HTTP可網頁執行安全與監控資料與分析

概覽

AI 產生的概覽

把代理的算力工作記錄為能耗與碳帳本，支援朗道爾極限檢核、雜湊鏈驗證與內容定址證明。

可以做什麼
  • 記錄並列出算力工作項目，含能耗、碳排放、成本，可選擇依位元運算數對照物理下限檢核
  • 彙總某個代理的足跡：總焦耳、度數、克二氧化碳當量、成本與平均朗道爾效率
  • 為項目簽發內容定址證明，並透過重算雜湊加以驗證
  • 驗證代理帳本的防竄改雜湊鏈
  • 在獨立的僅附加鏈中記錄、讀取與列出經稽核的溫室氣體清冊，並驗證該鏈
  • 產生 x402-C 碳收據，並回傳艦隊標準的代理自我描述
適用情境
當代理或代理艦隊需要對算力背後的能耗與碳排放做可稽核的核算，或需要他人可複核的綠色算力聲明與碳收據時適用。
執行需求
遠端 streamable HTTP 端點 mcp.viridisconservation.com；未宣告驗證、環境變數或標頭。README 說明每項服務免費額度為每日 10 次呼叫，驗證一律免費，也可從 Apache-2.0 儲存庫自行部署。
安裝前請注意
項目會寫入帳本、清冊寫入僅附加鏈，記錄基本上無法撤銷；冪等鍵（entry_id、inventory_id）只能避免重複，無法避免內容填錯。託管服務另含付款、簽章授權與遙測，屬專有部分，不在開源儲存庫中。未宣告驗證，請考量所送出的代理識別與工作負載資料。

安裝

在 SourceWeft 中

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

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

交給代理程式安裝

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

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

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

其他 MCP 客戶端

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

{
  "mcpServers": {
    "agent-compute-ledger": {
      "type": "http",
      "url": "https://mcp.viridisconservation.com/compute-ledger/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

工具

12

record_work

Record a unit of agent compute work. energy_j = power_w * duration_s; carbon_g follows from grid intensity. If bit_ops is declared, the entry is validated against the Landauer floor (bit_ops * kB * T * ln2) — physically impossible claims are rejected. Idempotent on entry_id.

輸入參數taskbit_opspower_w必填agent_id必填entry_id必填duration_s必填temperature_kprice_minor_per_kwhgrid_intensity_g_per_kwh

footprint

Aggregate footprint for an agent: total J, kWh, gCO2e, cost, and mean Landauer efficiency. Totals are exact sums of the ledger entries.

輸入參數agent_id必填

attest

Issue a content-addressed attestation for a ledger entry (verifiable green-compute / energy claim).

輸入參數entry_id必填

verify_attestation

Verify an attestation by recomputing the entry hash.

輸入參數attestation必填

verify_chain

Verify the tamper-evident hash chain of an agent's ledger.

輸入參數agent_id必填

list_entries

List all ledger entries for an agent.

輸入參數agent_id必填

carbon_receipt

Emit an x402-C carbon receipt for a recorded work entry — the physically-grounded {version, g_co2e, energy_j, method, landauer_*, ...} object an x402 machine-payment receipt can carry. method is 'landauer-floor' when the workload declared bit_ops (thermodynamically validated), else 'measured'. Pass offset_ref (a retirement id from the offset clearinghouse) to assert carbon-neutrality. Read-only; the returned attestation_hash binds the receipt to the ledger's hash chain.

輸入參數entry_id必填offset_ref

record_inventory

Record an audited GHG inventory in a separate append-only chain. mass_g is exact integer grams; content and factor-pack digests are bare lowercase SHA-256 hex. Idempotent on inventory_id.

輸入參數mass_g必填agent_id必填source_idsinventory_id必填content_digest必填factor_pack_digest必填factor_pack_version必填

get_inventory

Fetch one immutable inventory record by inventory_id.

輸入參數inventory_id必填

list_inventories

List the separate GHG inventory chain for an agent.

輸入參數agent_id必填

verify_inventory_chain

Verify an agent's inventory hash chain independently of compute work.

輸入參數agent_id必填

describe_agent

Fleet-standard self-description.

無需輸入參數。

版本歷史

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

評分

已滿足適用檢查項的 100%

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

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

其他 Energyaisolution 整合

Energyai

com.energyaisolution官方發布者

面向美國家庭能源規劃的遠端 MCP 伺服器：太陽能發電估算、補助資訊、能源節點評分、附來源指南與安裝商媒合。

Streamable HTTP可網頁執行
位置與生活30 個工具Oct 25, 2026

Solar Home Incentives

com.energyaisolution官方發布者

遠端 MCP 伺服器，用於美國住宅能源規劃：太陽能發電量估算、補助來源指引、引用指南、承包商清單與經同意的安裝商媒合。

Streamable HTTP可網頁執行
位置與生活12 個工具Nov 2, 2026

Eco Funding

由 GitHub 帳號 jdhart81 發布

唯讀 MCP 伺服器，用來評估場地的生態複雜度、產生可重算的憑證，並模擬承諾資金池的釋放規則。

Streamable HTTP可網頁執行
金融5 個工具Nov 8, 2026

VergeCommon

由 GitHub 帳號 jdhart81 發布

VergeCommon 讓助理瀏覽公開的社區保育合作社，並為社區土地專案產生假設性的收益彙集與分配草案。

Streamable HTTP可網頁執行
位置與生活5 個工具Nov 7, 2026

Wavefunction Search

由 GitHub 帳號 jdhart81 發布

一個遠端 MCP 場域：AI 代理在此發布目標、感知開放意圖、把工作路由給合適的代理，並提交可驗證的簽章結果。

Streamable HTTP可網頁執行
知識與記憶9 個工具Nov 8, 2026