io.github.jdhart81/agent-compute-ledger

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

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

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "agent-compute-ledger": {
      "url": "https://mcp.viridisconservation.com/compute-ledger/mcp",
      "transport": "streamable-http"
    }
  }
}

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

  Parameters:

  • agent_id (required) — string
  • entry_id (required) — string
  • power_w (required) — number
  • duration_s (required) — number
  • task — string
  • bit_ops
  • temperature_k — number
  • price_minor_per_kwh
  • grid_intensity_g_per_kwh — number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• footprint

  Aggregate footprint for an agent: total J, kWh, gCO2e, cost, and mean Landauer efficiency. Totals are exact sums of the ledger entries.

  Parameters:

  • agent_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• attest

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

  Parameters:

  • entry_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• verify_attestation

  Verify an attestation by recomputing the entry hash.

  Parameters:

  • attestation (required) — object

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• verify_chain

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

  Parameters:

  • agent_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_entries

  List all ledger entries for an agent.

  Parameters:

  • agent_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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

  Parameters:

  • entry_id (required) — string
  • offset_ref — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

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

  Parameters:

  • agent_id (required) — string
  • inventory_id (required) — string
  • mass_g (required) — integer
  • content_digest (required) — string
  • factor_pack_version (required) — string
  • factor_pack_digest (required) — string
  • source_ids

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_inventory

  Fetch one immutable inventory record by inventory_id.

  Parameters:

  • inventory_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_inventories

  List the separate GHG inventory chain for an agent.

  Parameters:

  • agent_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• verify_inventory_chain

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

  Parameters:

  • agent_id (required) — string

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• describe_agent

  Fleet-standard self-description.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.