Skip to content

io.github.jdhart81/agent-compute-ledger

by jdhart81 · remote · no sign-in to list tools · v0.3.0 · published by GitHub user jdhart81

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

Changes · 8
CompareRegistry entry

12 tools: 8 change things and 4 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http agent-compute-ledger https://mcp.viridisconservation.com/compute-ledger/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

12 tools

Changes things 8Claude Code: ask
  • attestIssue a content-addressed attestation for a ledger entry (verifiable green-compute / energy claim).No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Issue a content-addressed attestation for a ledger entry (verifiable green-compute / energy claim).
  • carbon_receiptEmit 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 ca…No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    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.
  • footprintAggregate footprint for an agent: total J, kWh, gCO2e, cost, and mean Landauer efficiency.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Aggregate footprint for an agent: total J, kWh, gCO2e, cost, and mean Landauer efficiency. Totals are exact sums of the ledger entries.
  • record_inventoryRecord an audited GHG inventory in a separate append-only chain.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    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.
  • record_workRecord a unit of agent compute work.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    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.
  • verify_attestationVerify an attestation by recomputing the entry hash.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Verify an attestation by recomputing the entry hash.
  • verify_chainVerify the tamper-evident hash chain of an agent's ledger.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Verify the tamper-evident hash chain of an agent's ledger.
  • verify_inventory_chainVerify an agent's inventory hash chain independently of compute work.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Verify an agent's inventory hash chain independently of compute work.
Only reads 4Claude Code: allow
  • describe_agentFleet-standard self-description.No findings

    Why it is in this group

    • The name "describe_agent" says "describe": a word for reading.
    Description, as the server wrote it
    Fleet-standard self-description.
  • get_inventoryFetch one immutable inventory record by inventory_id.No findings

    Why it is in this group

    • The name "get_inventory" says "get": a word for reading.
    Description, as the server wrote it
    Fetch one immutable inventory record by inventory_id.
  • list_entriesList all ledger entries for an agent.No findings

    Why it is in this group

    • The name "list_entries" says "list": a word for reading.
    Description, as the server wrote it
    List all ledger entries for an agent.
  • list_inventoriesList the separate GHG inventory chain for an agent.No findings

    Why it is in this group

    • The name "list_inventories" says "list": a word for reading.
    Description, as the server wrote it
    List the separate GHG inventory chain for an agent.

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 0.3.0. Values in angle brackets are yours to fill in.

claude mcp add --transport http agent-compute-ledger https://mcp.viridisconservation.com/compute-ledger/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__agent-compute-ledger__list_entries",
      "mcp__agent-compute-ledger__get_inventory",
      "mcp__agent-compute-ledger__list_inventories",
      "mcp__agent-compute-ledger__describe_agent"
    ],
    "ask": [
      "mcp__agent-compute-ledger__record_work",
      "mcp__agent-compute-ledger__footprint",
      "mcp__agent-compute-ledger__attest",
      "mcp__agent-compute-ledger__verify_attestation",
      "mcp__agent-compute-ledger__verify_chain",
      "mcp__agent-compute-ledger__carbon_receipt",
      "mcp__agent-compute-ledger__record_inventory",
      "mcp__agent-compute-ledger__verify_inventory_chain"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as agent-compute-ledger. Review it before you use it.