Ledger MCP

Double-entry accounting for AI agents. An MCP server over the Ledger API — create a chart of accounts, post balanced journal entries, and pull trial-balance / general-ledger reports, all from inside your agent.

Ledger is agent-native: it's paid per call via x402 micropayments (USDC on the Base network), so an agent can use real double-entry bookkeeping without an account, API key, or subscription — it just pays a fraction of a cent per call from its own wallet.

Install

uvx ledger-mcp

Or add it to your MCP client (claude-code-config.json / Claude Desktop):

{
  "mcpServers": {
    "ledger": {
      "command": "uvx",
      "args": ["ledger-mcp"],
      "env": {
        "LEDGER_X402_PRIVATE_KEY": "0xYOUR_FUNDED_BASE_WALLET_KEY"
      }
    }
  }
}

Related MCP server: HLedger MCP Server

Payment

Most tools are paid per call (reads ~$0.002, writes ~$0.01, in USDC on Base):

• Set LEDGER_X402_PRIVATE_KEY to the private key of a funded Base wallet (holding USDC). The server signs the x402 (EIP-3009) payment automatically on each call — gasless, you only spend the USDC the call costs.

• Without a key, health and discover still work, and paid tools return the exact price plus how to enable payment (nothing is spent).

• Use a dedicated low-balance wallet for your agent — never your main key. The balance is the blast radius.

Run discover to see every endpoint and its current price before spending.

Tools

The one rule: entries sum to zero

Every transaction is two or more entries whose signed amounts sum to exactly 0. Amounts are integers in minor units (cents): a debit is positive, a credit is negative.

Record a $500 cash sale (debit Cash, credit Sales Revenue):

{
  "date": "2026-06-19",
  "description": "Cash sale",
  "entries": [
    {"account_id": 1, "amount": 50000, "memo": "cash in"},
    {"account_id": 2, "amount": -50000, "memo": "sales revenue"}
  ]
}

The server rejects an unbalanced transaction before spending.

Links

• Docs & API: https://ledger.novadyne.ai

• API base: https://ledger-api.novadyne.ai

• x402 discovery: https://ledger-api.novadyne.ai/.well-known/x402

MIT licensed. By Novadyne. The API backend is operated by Novadyne; this package is the open client that talks to it.