Agent Compute Ledger

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

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

The publisher's own server: Energyai

VerifiedStreamable HTTPWeb executableSecurity & MonitoringData & Analytics

Overview

AI-generated overview

Records agent compute work as an energy and carbon ledger, with Landauer-limit checks, hash-chain verification and attestations.

What you can do
  • Record and list compute work entries with energy, carbon, cost and optional bit-operation validation against a physical floor
  • Aggregate an agent's footprint into total joules, kWh, gCO2e, cost and mean Landauer efficiency
  • Issue content-addressed attestations for entries and verify them by recomputing hashes
  • Verify the tamper-evident hash chain of an agent's ledger
  • Record, fetch and list audited GHG inventories in a separate append-only chain, and verify that chain
  • Emit x402-C carbon receipts and return a fleet-standard agent self-description
When to use it
Useful when an assistant or agent fleet needs auditable accounting of the energy and carbon behind compute work, or verifiable green-compute claims and carbon receipts that others can re-check.
Requirements
Remote streamable HTTP endpoint at mcp.viridisconservation.com; no authentication, environment variables or headers are declared. The README notes a free tier of 10 calls per day per service, with verification always free, and that the code can also be self-hosted from the Apache-2.0 repository.
Before you install
Entries are written to a ledger and inventories to an append-only chain, so recorded data is effectively permanent; idempotency keys (entry_id, inventory_id) prevent duplicates but not mistaken content. The hosted service adds payments, signing authority and telemetry that are proprietary and not in the open repository. No authentication is declared, so consider what agent identifiers and workload data you send.

Installation

In SourceWeft

  1. Open Agent Compute Ledger 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-compute-ledger/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-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.

Source: README.md at commit 350712c

Tools

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.

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

Parametersagent_idrequired

attest

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

Parametersentry_idrequired

verify_attestation

Verify an attestation by recomputing the entry hash.

Parametersattestationrequired

verify_chain

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

Parametersagent_idrequired

list_entries

List all ledger entries for an agent.

Parametersagent_idrequired

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.

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

Parametersmass_grequiredagent_idrequiredsource_idsinventory_idrequiredcontent_digestrequiredfactor_pack_digestrequiredfactor_pack_versionrequired

get_inventory

Fetch one immutable inventory record by inventory_id.

Parametersinventory_idrequired

list_inventories

List the separate GHG inventory chain for an agent.

Parametersagent_idrequired

verify_inventory_chain

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

Parametersagent_idrequired

describe_agent

Fleet-standard self-description.

Takes no parameters.

Version history

1
  1. v0.3.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