MCP Server
agent-compute-ledger
io.github.jdhart81/agent-compute-ledger
What this MCP does
Records and verifies agent compute energy and carbon usage in tamper-evident ledgers, validates Landauer-limit claims, and produces carbon receipts and footprint aggregates.
Capabilities
Tools
12
tools
attest
Issue a content-addressed attestation for a ledger entry (verifiable
green-compute / energy claim).
Input schema
{'type': 'object', 'title': 'attestArguments', 'required': ['entry_id'], 'properties': {'entry_id': {'type': 'string', 'title': 'Entry Id'}}}
Output schema
{'type': 'object', 'title': 'attestOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Input schema
{'type': 'object', 'title': 'carbon_receiptArguments', 'required': ['entry_id'], 'properties': {'entry_id': {'type': 'string', 'title': 'Entry Id'}, 'offset_ref': {'type': 'string', 'title': 'Offset Ref', 'default': ''}}}
Output schema
{'type': 'object', 'title': 'carbon_receiptOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
describe_agent
Fleet-standard self-description.
Input schema
{'type': 'object', 'title': 'describe_agentArguments', 'properties': {}}
Output schema
{'type': 'object', 'title': 'describe_agentOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
footprint
Aggregate footprint for an agent: total J, kWh, gCO2e, cost, and mean
Landauer efficiency. Totals are exact sums of the ledger entries.
Input schema
{'type': 'object', 'title': 'footprintArguments', 'required': ['agent_id'], 'properties': {'agent_id': {'type': 'string', 'title': 'Agent Id'}}}
Output schema
{'type': 'object', 'title': 'footprintOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
get_inventory
Fetch one immutable inventory record by inventory_id.
Input schema
{'type': 'object', 'title': 'get_inventoryArguments', 'required': ['inventory_id'], 'properties': {'inventory_id': {'type': 'string', 'title': 'Inventory Id'}}}
Output schema
{'type': 'object', 'title': 'get_inventoryOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
list_entries
List all ledger entries for an agent.
Input schema
{'type': 'object', 'title': 'list_entriesArguments', 'required': ['agent_id'], 'properties': {'agent_id': {'type': 'string', 'title': 'Agent Id'}}}
Output schema
{'type': 'object', 'title': 'list_entriesOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
list_inventories
List the separate GHG inventory chain for an agent.
Input schema
{'type': 'object', 'title': 'list_inventoriesArguments', 'required': ['agent_id'], 'properties': {'agent_id': {'type': 'string', 'title': 'Agent Id'}}}
Output schema
{'type': 'object', 'title': 'list_inventoriesOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Input schema
{'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': None}, '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'}}}
Output schema
{'type': 'object', 'title': 'record_inventoryOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
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.
Input schema
{'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': None}, '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.0}, 'price_minor_per_kwh': {'anyOf': [{'type': 'number'}, {'type': 'null'}], 'title': 'Price Minor Per Kwh', 'default': None}, 'grid_intensity_g_per_kwh': {'type': 'number', 'title': 'Grid Intensity G Per Kwh', 'default': 400.0}}}
Output schema
{'type': 'object', 'title': 'record_workOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
verify_attestation
Verify an attestation by recomputing the entry hash.
Input schema
{'type': 'object', 'title': 'verify_attestationArguments', 'required': ['attestation'], 'properties': {'attestation': {'type': 'object', 'title': 'Attestation', 'additionalProperties': True}}}
Output schema
{'type': 'object', 'title': 'verify_attestationOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
verify_chain
Verify the tamper-evident hash chain of an agent's ledger.
Input schema
{'type': 'object', 'title': 'verify_chainArguments', 'required': ['agent_id'], 'properties': {'agent_id': {'type': 'string', 'title': 'Agent Id'}}}
Output schema
{'type': 'object', 'title': 'verify_chainOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
verify_inventory_chain
Verify an agent's inventory hash chain independently of compute work.
Input schema
{'type': 'object', 'title': 'verify_inventory_chainArguments', 'required': ['agent_id'], 'properties': {'agent_id': {'type': 'string', 'title': 'Agent Id'}}}
Output schema
{'type': 'object', 'title': 'verify_inventory_chainOutput', 'required': ['result'], 'properties': {'result': {'type': 'string', 'title': 'Result'}}}
History
Recent tool changes
Added
describe_agent
Sept. 17, 2026, 12:42 p.m.
Added
verify_inventory_chain
Sept. 17, 2026, 12:42 p.m.
Added
list_inventories
Sept. 17, 2026, 12:42 p.m.
Added
get_inventory
Sept. 17, 2026, 12:42 p.m.
Added
record_inventory
Sept. 17, 2026, 12:42 p.m.
Added
carbon_receipt
Sept. 17, 2026, 12:42 p.m.
Added
list_entries
Sept. 17, 2026, 12:42 p.m.
Added
verify_chain
Sept. 17, 2026, 12:42 p.m.
Added
verify_attestation
Sept. 17, 2026, 12:42 p.m.
Added
attest
Sept. 17, 2026, 12:42 p.m.
Added
footprint
Sept. 17, 2026, 12:42 p.m.
Added
record_work
Sept. 17, 2026, 12:42 p.m.
Discover
Similar MCP servers
Clink Forge
com.clinkforge/clink-forge
Provides pay-per-call access to attested government datasets, primarily CDC and HHS health data plus EPA air-quality observations.
Algenta MCP Server
io.github.thyn-ai/algenta
Provides governed data onboarding, connector browsing, deterministic simulations, agent-run lifecycles, capability routing, deplo…
osint
build.exascale/osint
Provides source-cited US data and schemas for power systems, AI infrastructure, semiconductor production and trade, robotics, and…
Scalix Cloud
world.scalix/cloud
Provides managed databases, SQL tools, container builds, persistent Linux machines, domains, scheduled functions, storage, and pr…
RationalBloks
io.github.rationalbloks/rationalbloks-mcp
Creates, deploys, manages, and searches schema-based REST API projects and Neo4j knowledge graphs across staging and production e…
RationalBloks
com.rationalbloks/mcp
Creates, deploys, manages, and queries REST API and Neo4j graph projects from JSON schemas, including graph data modeling, versio…
whatif
xyz.pflow.sim/whatif
Builds, validates, calibrates, compares, and simulates Petri-net process models using event logs, scenarios, invariants, and diag…
Us Iso Grid
io.github.pipeworx-io/us-iso-grid
Provides real-time and recent electricity grid data for CAISO, ERCOT, and NYISO, including demand, forecasts, fuel mix, emissions…