Agent Compute Ledger

Working · 1.7 s

io.github.jdhart81/agent-compute-ledgerv0.3.0

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

Data & Databases

Source Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.viridisconservation.com/compute-ledger/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

attest

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

entry_idstring, required

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (12)

attest

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

Argument	Type	Description
entry_id*	string

Input schema (JSON)

{
  "type": "object",
  "title": "attestArguments",
  "required": [
    "entry_id"
  ],
  "properties": {
    "entry_id": {
      "type": "string",
      "title": "Entry Id"
    }
  }
}

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.

Argument	Type	Description
entry_id*	string
offset_ref	string

Input schema (JSON)

{
  "type": "object",
  "title": "carbon_receiptArguments",
  "required": [
    "entry_id"
  ],
  "properties": {
    "entry_id": {
      "type": "string",
      "title": "Entry Id"
    },
    "offset_ref": {
      "type": "string",
      "title": "Offset Ref",
      "default": ""
    }
  }
}

describe_agent

Fleet-standard self-description.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "title": "describe_agentArguments",
  "properties": {}
}

footprint

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

Argument	Type	Description
agent_id*	string

Input schema (JSON)

{
  "type": "object",
  "title": "footprintArguments",
  "required": [
    "agent_id"
  ],
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "Agent Id"
    }
  }
}

get_inventory

Fetch one immutable inventory record by inventory_id.

Argument	Type	Description
inventory_id*	string

Input schema (JSON)

{
  "type": "object",
  "title": "get_inventoryArguments",
  "required": [
    "inventory_id"
  ],
  "properties": {
    "inventory_id": {
      "type": "string",
      "title": "Inventory Id"
    }
  }
}

list_entries

List all ledger entries for an agent.

Argument	Type	Description
agent_id*	string

Input schema (JSON)

{
  "type": "object",
  "title": "list_entriesArguments",
  "required": [
    "agent_id"
  ],
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "Agent Id"
    }
  }
}

list_inventories

List the separate GHG inventory chain for an agent.

Argument	Type	Description
agent_id*	string

Input schema (JSON)

{
  "type": "object",
  "title": "list_inventoriesArguments",
  "required": [
    "agent_id"
  ],
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "Agent Id"
    }
  }
}

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.

Argument	Type	Description
mass_g*	integer
agent_id*	string
source_ids	any
inventory_id*	string
content_digest*	string
factor_pack_digest*	string
factor_pack_version*	string

Input schema (JSON)

{
  "type": "object",
  "title": "record_inventoryArguments",
  "required": [
    "agent_id",
    "inventory_id",
    "mass_g",
    "content_digest",
    "factor_pack_version",
    "factor_pack_digest"
  ],
  "properties": {
    "mass_g": {
      "type": "integer",
      "title": "Mass G"
    },
    "agent_id": {
      "type": "string",
      "title": "Agent Id"
    },
    "source_ids": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        {
          "type": "null"
        }
      ],
      "title": "Source Ids",
      "default": null
    },
    "inventory_id": {
      "type": "string",
      "title": "Inventory Id"
    },
    "content_digest": {
      "type": "string",
      "title": "Content Digest"
    },
    "factor_pack_digest": {
      "type": "string",
      "title": "Factor Pack Digest"
    },
    "factor_pack_version": {
      "type": "string",
      "title": "Factor Pack Version"
    }
  }
}

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.

Argument	Type	Description
task	string
bit_ops	any
power_w*	number
agent_id*	string
entry_id*	string
duration_s*	number
temperature_k	number
price_minor_per_kwh	any
grid_intensity_g_per_kwh	number

Input schema (JSON)

{
  "type": "object",
  "title": "record_workArguments",
  "required": [
    "agent_id",
    "entry_id",
    "power_w",
    "duration_s"
  ],
  "properties": {
    "task": {
      "type": "string",
      "title": "Task",
      "default": ""
    },
    "bit_ops": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Bit Ops",
      "default": null
    },
    "power_w": {
      "type": "number",
      "title": "Power W"
    },
    "agent_id": {
      "type": "string",
      "title": "Agent Id"
    },
    "entry_id": {
      "type": "string",
      "title": "Entry Id"
    },
    "duration_s": {
      "type": "number",
      "title": "Duration S"
    },
    "temperature_k": {
      "type": "number",
      "title": "Temperature K",
      "default": 300
    },
    "price_minor_per_kwh": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "title": "Price Minor Per Kwh",
      "default": null
    },
    "grid_intensity_g_per_kwh": {
      "type": "number",
      "title": "Grid Intensity G Per Kwh",
      "default": 400
    }
  }
}

verify_attestation

Verify an attestation by recomputing the entry hash.

Argument	Type	Description
attestation*	object

Input schema (JSON)

{
  "type": "object",
  "title": "verify_attestationArguments",
  "required": [
    "attestation"
  ],
  "properties": {
    "attestation": {
      "type": "object",
      "title": "Attestation",
      "additionalProperties": true
    }
  }
}

verify_chain

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

Argument	Type	Description
agent_id*	string

Input schema (JSON)

{
  "type": "object",
  "title": "verify_chainArguments",
  "required": [
    "agent_id"
  ],
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "Agent Id"
    }
  }
}

verify_inventory_chain

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

Argument	Type	Description
agent_id*	string

Input schema (JSON)

{
  "type": "object",
  "title": "verify_inventory_chainArguments",
  "required": [
    "agent_id"
  ],
  "properties": {
    "agent_id": {
      "type": "string",
      "title": "Agent Id"
    }
  }
}