io.github.jdhart81/agent-offset-clearinghouse

io.github.jdhart81/agent-offset-clearinghouse · v0.6.0 · agents-and-memory

io.github.jdhart81/agent-offset-clearinghouse is healthy: it completed an MCP handshake in 1185 ms and exposes 19 tools.

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

Endpoint: https://mcp.viridisconservation.com/offsets/mcp (streamable-http)

Repository · JSON · Add to my inventory

Facts

Users (last 30 days)0
HandshakeHealthy
Auth neededNone
Tool count19
Latency1185 ms
Last checked (UTC)2026-10-15T04:20:47.168Z

Health history

Checked (UTC)StatusLatencyError
2026-10-15T04:20:47.168ZHealthy1185

Tools (19)

list_creditList 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)
delist_creditAdmin 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.
verra_supplyThe 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_recordGenerate 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 t
buy_offsetRetire 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.
buy_offset_budgetMoney-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;
settlement_batchRead-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.
net_positionBuyer's carbon position: emitted (from agent-compute-ledger) minus retired. carbon_accountable == true when fully offset.
verify_certificateVerify an offset certificate: recompute its hash and check the ledger.
bookThe full credit book with per-credit and book-wide mass conservation totals.
get_purchaseFetch a past purchase / offset certificate by id.
verify_retirementx402-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-on
register_projectRegister 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.
project_fundingSupply-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
list_projectsList all registered restoration projects with their metadata.
disbursement_scheduleAutomated 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
certify_disbursementFreeze 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
verify_disbursementRecompute the disbursement certificate hash chain and confirm whole-book conservation of disbursed proceeds. Any party can audit disbursements.
describe_agentFleet-standard self-description.