Agent Offset Clearinghouse

io.github.jdhart81Published by GitHub account jdhart81v0.6.0Updated Nov 2, 2026

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

The publisher's own server: Energyai

VerifiedStreamable HTTPWeb executableFinanceSecurity & MonitoringBusiness & Commerce

Overview

AI-generated overview

A hosted clearinghouse MCP server for verified conservation carbon credits, letting an assistant list, buy, retire and audit offsets against agent compute…

What you can do
  • List, register and delist conservation credits and restoration projects, with verification references required
  • Buy and retire offsets by mass or by budget, with dry-run previews and idempotent purchase ids
  • Read the credit book, past purchases, settlement batches and a buyer's net carbon position
  • Verify offset certificates, retirements and disbursement hash chains
  • Preview, certify and audit project disbursement schedules and funding ledgers
  • Return a fleet-standard self-description of the agent
When to use it
Use it when an assistant needs to offset or account for agent compute emissions with verified conservation credits, or when a buyer wants auditable retirement certificates, settlement statements and project disbursement records.
Requirements
A remote streamable HTTP endpoint; no packages, environment variables or headers are declared. The README notes a hosted free tier of 10 calls per service per day, with payments, seats and SLA on the hosted side. Self-hosting is possible from the open-source repository.
Before you install
Purchases spend money: buy_offset and buy_offset_budget settle payment via escrow, so use dry_run first. Listing, delisting, registering projects and certifying disbursements change state, and delisting requires gateway state-change authentication. A 15% marketplace take is deducted from every retirement. The hosted service layer, including payment, signing authority and customer data, is proprietary.

Installation

In SourceWeft

  1. Open Agent Offset Clearinghouse in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.jdhart81%2Fagent-offset-clearinghouse/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "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.

Source: README.md at commit 350712c

Tools

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.

Parametersissuerrequiredmass_grequiredvintageregistryproject_idrequiredmethodologyserial_numbervcs_project_idverification_refrequiredprice_minor_per_kgrequired

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.

Parametersreasonrequiredcredit_idrequired

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.

Takes no parameters.

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

Parameterspurchase_idrequiredretirement_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.

Parametersbuyerrequiredmass_grequireddry_runpurchase_idrequired

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.

Parametersbuyerrequireddry_runpurchase_idrequiredbudget_minorrequired

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.

Parametersbuyerrequiredsince

net_position

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

Parametersbuyerrequiredemitted_grequired

verify_certificate

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

Parameterscertificaterequired

book

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

Takes no parameters.

get_purchase

Fetch a past purchase / offset certificate by id.

Parameterspurchase_idrequired

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.

Parametersrequired_gpurchase_idrequired

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.

Parametersnamelocationproject_idrequiredbeneficiarymethodologyregistry_refverification_refrequired

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.

Parametersproject_id

list_projects

List all registered restoration projects with their metadata.

Takes no parameters.

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

Parametersproject_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.

Parametersbatch_idrequired

verify_disbursement

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

Takes no parameters.

describe_agent

Fleet-standard self-description.

Takes no parameters.

Version history

1
  1. v0.6.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Energyaisolution integrations

Energyai

com.energyaisolutionOfficial publisher

Remote MCP server for US home-energy planning: solar production estimates, incentive guidance, Energy Node scores, cited guides and installer matching.

Streamable HTTPWeb executable
Location & Lifestyle30 toolsOct 25, 2026

Solar Home Incentives

com.energyaisolutionOfficial publisher

Remote MCP server for US home-energy planning: solar production estimates, incentive guidance, cited guides, contractor listings and consented installer…

Streamable HTTPWeb executable
Location & Lifestyle12 toolsNov 2, 2026

Eco Funding

Published by GitHub account jdhart81

Read-only MCP server that values a site's ecological complexity, issues re-runnable receipts, and simulates pledge-pool release rules.

Streamable HTTPWeb executable
Finance5 toolsNov 8, 2026

VergeCommon

Published by GitHub account jdhart81

VergeCommon lets an assistant browse public conservation co-ops and build hypothetical pooling and benefit-sharing drafts for community land projects.

Streamable HTTPWeb executable
Location & Lifestyle5 toolsNov 7, 2026

Wavefunction Search

Published by GitHub account jdhart81

A remote MCP field where AI agents post goals, sense open intents, route work to agents, and submit signed, verifiable results.

Streamable HTTPWeb executable
Knowledge & Memory9 toolsNov 8, 2026