Agent Offset Clearinghouse

io.github.jdhart81由 GitHub 账号 jdhart81 发布v0.6.0更新于 Nov 2, 2026

Verified conservation credits matched to agent compute emissions — the conservation flywheel of the

发布方自己的服务:Energyai

已验证Streamable HTTP可网页运行金融安全与监控商业与电商

概览

AI 生成的概览

一个托管式保护碳信用清算 MCP 服务器,让助手列出、购买、注销并审计抵消额度,用于抵消智能体算力排放。

可以做什么
  • 列出、注册和下线保护信用与修复项目,且必须提供验证凭证
  • 按质量或按预算购买并注销抵消额度,支持试运行预览与幂等购买编号
  • 读取信用账簿、历史购买、结算批次以及买方的净碳位置
  • 验证抵消证书、注销记录与拨付哈希链
  • 预览、认证并审计项目拨付计划与资金台账
  • 返回机队标准的智能体自描述信息
适用场景
当助手需要用经过验证的保护信用来抵消或核算智能体算力排放时适用;也适合需要可审计的注销证书、结算对账单和项目拨付记录的买方。
运行要求
需要远程 streamable HTTP 端点;未声明任何软件包、环境变量或请求头。README 提到托管免费额度为每项服务每天 10 次调用,付费、席位与 SLA 属于托管侧。也可从开源仓库自行部署。
安装前请注意
购买会花钱:buy_offset 与 buy_offset_budget 通过托管结算付款,建议先用 dry_run 预览。上架、下线、注册项目和认证拨付都会改变状态,下线需要网关的状态变更认证。每笔注销会扣除 15% 市场抽成。托管服务层(含支付、签名授权与客户数据)为专有,不在开源仓库中。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Agent Offset Clearinghouse,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.jdhart81%2Fagent-offset-clearinghouse/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

工具

19

list_credit

List a conservation credit on the book. verification_ref (a D-Score / land-verification attestation) is REQUIRED — unverified credits cannot enter the book. To trade on the Verra network, pass registry="verra" with the VCS provenance (vcs_project_id, serial_number, vintage, methodology) so retirements are cross-referenceable on registry.verra.org.

输入参数issuer必填mass_g必填vintageregistryproject_id必填methodologyserial_numbervcs_project_idverification_ref必填price_minor_per_kg必填

delist_credit

Admin operation: remove a credit from the active fill path while retaining its listing and retirement history for audit. Idempotent for an already-delisted credit. Gateway state-change authentication is required.

输入参数reason必填credit_id必填

verra_supply

The tradeable Verra VCS book: verified credits carrying genuine Verra provenance (project id + serial + vintage), cross-referenceable on registry.verra.org. Read-only. Every retirement nets the project 85% and Viridis the 15% marketplace take.

无需输入参数。

verra_retirement_record

Generate the Verra-portal-ready retirement record(s) for a retirement made against Verra supply — VCS project id, serial, vintage, methodology, quantity (tCO2e), beneficiary, and the registry.verra.org cross-reference. Read-only. Submit these under the Viridis Verra account to finalize the on-registry retirement (portal today; auto-posts when Verra's transaction API is live).

输入参数purchase_id必填retirement_reason

buy_offset

Retire mass_g of verified credits for a buyer: cheapest-first matching, exactly-once (idempotent on purchase_id), returns a content-addressed offset certificate with per-fill costs. Payment settles via escrow. dry_run=true previews the exact fills/cost without mutating the book.

输入参数buyer必填mass_g必填dry_runpurchase_id必填

buy_offset_budget

Money-denominated offset purchase: retire the maximum cheapest-first verified mass whose exact cost fits inside budget_minor (never overspends). Built for callers whose restoration obligation is a currency amount — e.g. a revenue share accrued in a ledger. Idempotent on purchase_id; dry_run=true previews without mutating.

输入参数buyer必填dry_runpurchase_id必填budget_minor必填

settlement_batch

Read-only cash-settlement summary for a buyer: the list + exact sums (purchases, mass_g, cost_minor) of their retirements, optionally since an ISO-8601 timestamp — the statement a human settles in one transfer.

输入参数buyer必填since

net_position

Buyer's carbon position: emitted (from agent-compute-ledger) minus retired. carbon_accountable == true when fully offset.

输入参数buyer必填emitted_g必填

verify_certificate

Verify an offset certificate: recompute its hash and check the ledger.

输入参数certificate必填

book

The full credit book with per-credit and book-wide mass conservation totals.

无需输入参数。

get_purchase

Fetch a past purchase / offset certificate by id.

输入参数purchase_id必填

verify_retirement

x402-C C4 check: confirm a retirement (offset_ref = purchase_id) actually retires at least required_g grams of verified conservation credit — the check that lets a carbon receipt's neutrality claim be honored. Returns covered / retired_g / shortfall_g and the backing credits. Read-only.

输入参数required_gpurchase_id必填

register_project

Register a VERIFIED restoration project so retirements against its credits can be funded. verification_ref (D-Score / land-verification / registry id) is required — only verified conservation is funded. project_id is immutable once registered.

输入参数namelocationproject_id必填beneficiarymethodologyregistry_refverification_ref必填

project_funding

Supply-side disbursement ledger: how much each restoration project has earned from retirements and is owed (gross_proceeds_minor + retired_g). Pass a project_id for one project, else all. Read-only — the CEO settles the actual payout. This is what makes the clearinghouse fund restoration.

输入参数project_id

list_projects

List all registered restoration projects with their metadata.

无需输入参数。

disbursement_schedule

Automated disbursement preview: for each verified restoration project, splits its newly-accrued proceeds into the Viridis Conservation withhold (default 15%, seeds the software/business) and the project payout (85%). Read-only. Funded-but-unregistered projects are surfaced separately as pending_registration (can't pay an unverified project).

输入参数project_id

certify_disbursement

Freeze the current disbursement schedule into a certified, tamper-evident batch (content-addressed, hash-chained). Idempotent on batch_id; only newly-accrued proceeds for verified projects are certified (never disbursed twice). This is the certified investment record the CEO executes the actual Stripe transfers against.

输入参数batch_id必填

verify_disbursement

Recompute the disbursement certificate hash chain and confirm whole-book conservation of disbursed proceeds. Any party can audit disbursements.

无需输入参数。

describe_agent

Fleet-standard self-description.

无需输入参数。

版本历史

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

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

其他 Energyaisolution 集成