@eternal-roman/ledger-mcp (MCP Server)

This MCP server is an adapter for @eternal-roman/ledger, exposing the ledger engine over stdio. It provides exact-decimal double-entry accounting for agents, where “the kernel does the math.” Agents are expected to call MCP tools rather than computing money in tokens.

🛠️ Key Features

Exact-decimal double-entry for agents
Deterministic and exact arithmetic behavior
Operates as an MCP adapter over stdio
Math performed by the ledger kernel

🚀 Use Cases

AI-agent bookkeeping workflows
Audit-oriented ledger processing
Double-entry accounting integrations for MCP hosts
Tool catalog access via ledger://tools/catalog

⚡ Developer Benefits

Standard MCP server shape for stdio hosts
Startup reads ledger://canon/rules and ledger://canon/workflow
Repository-aligned TypeScript ecosystem integration
Avoids token-based money calculations

⚠️ Limitations

Designed to be used by agents that do not compute money in tokens
Tooling details beyond the catalog/run instructions are not specified in the provided excerpt

Run

bash

npx -y @eternal-roman/ledger-mcp

json

{
  "mcpServers": {
    "ledger": {
      "command": "npx",
      "args": ["-y", "@eternal-roman/ledger-mcp"]
    }
  }
}

Same shape in Cursor, Windsurf, and other stdio MCP hosts.

On start, read ledger://canon/rules, then ledger://canon/workflow. Catalog: ledger://tools/catalog.

Tools

Tool

Use when

money_compute

Any arithmetic (add/sub/mul/div/allocate/convert/compare)

entry_validate

Before posting

ledger_post

Validate then apply; fail-closed

ledger_balance

One account (pass currency if mixed)

ledger_trial_balance

Every account

ledger_verify_equation

Assets + Expenses = Liabilities + Equity + Income

ledger_audit_hash

Tamper-evident digest (ledger-audit-v2)

ledger_verify_determinism

Rebuild twice; byte-identical

trace_run

Replay with per-step checkpoints

cite_lookup

IFRS/GAAP from the graph

artifact_make

Proof bundle; hash must be session-issued or recomputable

periods_create_lock

Create a hard-close lock

periods_guarded_post

Post, rejected if the period is locked

closing_generate_entries

Income/Expense → RE

fx_compute_translation

Reporting currency + CTA

depreciation_build_schedule

Straight-line or declining

cashflow_statement

Direct method from cash accounts

reconcile_positions

Ledger vs external snapshot

portfolio_relief

FIFO/LIFO/HIFO lots

settlement_build_entries

Trade date vs T+N

Stateless: ledger JSON in, ledger JSON out. Prompts: post_entry, audit_ledger, cite_treatment.

io.github.eternal-roman/ledger

@eternal-roman/ledger-mcp (MCP Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

@eternal-roman/ledger-mcp

Run

Tools

Not advice

Install

Related servers