Aethelgard Ledger MCP server

Aethelgard Ledger

A double-entry, multi-entity, tamper-evident ledger for AI agents.

Aethelgard Ledger is a local Model Context Protocol server. It gives your agent real accounting tools backed by an engine that enforces accounting rules. The agent can't talk its way past them. It is the same engine that runs the Aethelgard desktop ledger.

Evaluation build, for business use only. Licensed under the Aethelgard Ledger Evaluation Licence. The ledger file is not encrypted, and output must not be relied on without independent verification.

What it does

• Balanced journals or nothing. Every posting must balance. If debits don't equal credits, the engine rejects the posting and returns the reason, so the agent can't book it.
• Multi-entity. Companies, trusts and individuals across 9 jurisdictions, with subsidiaries linked to a parent and a combined group trial balance. This is a straight sum by account code, not a full consolidation; eliminations live in the Aethelgard desktop app.
• Tamper-evident. Every posting is linked into a per-entity SHA-256 hash-chain, so an entry edited outside the engine fails the integrity check. The chain is unkeyed. For independent assurance, record the latest chain hash (returned by verify_integrity) somewhere outside the ledger and compare it later.
• Local. The ledger lives in a file on your machine and is never sent to us.

Tools

Download

Get the latest build from Releases.

Quick start

1. Unzip it and put aethelgard-mcp somewhere permanent. Check it runs: aethelgard-mcp --version.
2. Add it to your MCP client as a local (stdio) server.

Claude Code

claude mcp add aethelgard-ledger -- /full/path/to/aethelgard-mcp

Claude Desktop, Cursor and other clients

{
     "mcpServers": {
       "aethelgard-ledger": { "command": "/full/path/to/aethelgard-mcp" }
     }
   }

On Windows, use the path to aethelgard-mcp.exe with doubled backslashes, e.g. "C:\\Tools\\aethelgard-mcp.exe".

"Create PropCo Ltd (GBP, GB, UkLtd) with a bank and a rental income account, then post October's £1,500 rent."

1. Ask your agent to keep some books. For example:

Where the ledger is kept

To keep it somewhere else, use --vault or set AETHELGARDLEDGERVAULT. Use --ephemeral for a throwaway ledger that is deleted when the server stops. Run aethelgard-mcp --help for every option.

Your data

Shortened. The full README is on GitHub.