Codeledger MCP Server

Deterministic context selection for AI coding agents. Local memory that compounds across sessions.

Local serverstdioPython

What is the Codeledger MCP Server?

Deterministic context selection for AI coding agents. Local memory that compounds across sessions.

The short version

CodeLedger turns every coding action into a persistent, compounding asset.

  • Append-only memory of engineering activity
  • Outcome-linked learning (what worked vs what failed)
  • Cross-agent continuity
  • Deterministic context selection

The tools it exposes

The server publishes 13 tools. What each one is for:

  • query_ledger — Search for verified patterns before coding
  • get_active_context — Get the task-specific context bundle
  • record_interaction — Report outcomes for memory compounding
  • Append — only memory of engineering activity
  • Outcome — linked learning (what worked vs what failed)
  • Cross — agent continuity
  • Remember — Verify
  • Feature — Individual (Free)
  • Hook — When
  • SessionStart — Session opens
  • PreToolUse — Before edit/write
  • PreCompact — Before compression

Getting it running

The server ships on npm as @codeledger/cli, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Recorded tools

  • query_ledger — Search for verified patterns before coding
  • get_active_context — Get the task-specific context bundle
  • record_interaction — Report outcomes for memory compounding

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
query_ledgerSearch for verified patterns before coding
get_active_contextGet the task-specific context bundle
record_interactionReport outcomes for memory compounding

How to install the Codeledger MCP Server

{
  "mcpServers": {
    "codeledger": {
      "command": "npx",
      "args": ["-y", "@codeledger/cli"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Example prompts to try

  • “Use Codeledger to query ledger.”
  • “Use Codeledger to get active context.”
  • “Use Codeledger to record interaction.”

Frequently asked questions

Deterministic context selection for AI coding agents. Local memory that compounds across sessions. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.