mcp server

journalize

Agent-native double-entry accounting ledger with x402 micropayments

Description as published by the maintainer. Source

• version 1.0.0
• active

active — Registry entry last updated 2026-07-09.

What this server can do

11 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

export_ledger(nonce, signature, timestamp, public_key, payment_header)

Export the full ledger as literal Beancount text — a portable snapshot for fava/bean-report/etc., not the live store. Shares a combined free allowance of 2 with get_balance_sheet, get_income_statement, and get_trial_balance (the "report tier") — not 2 free calls for each of those four separately. Required: public_key, nonce, timestamp, signature.

get_account_balance(nonce, account, signature, timestamp, public_key, payment_header)

Balance of a single account. Settles at the same fixed price whether the account exists or not — an "unknown account" answer is still a valid, billable response (no per-error pricing discount). No free-trial allowance for this specific tool, unlike list_directives (same price, but list_directives has 2 free calls and this doesn't) — the free tier applies to browsing (list_directives, list_accounts) and the report tier, not per-account lookups. Required: account, public_key, nonce, timestamp, signature.

get_balance_sheet(nonce, signature, timestamp, public_key, payment_header)

Full realize() balance sheet — often served from cache. Settles at the same fixed price regardless of cache hit/miss. Shares a combined free allowance of 2 with export_ledger, get_income_statement, and get_trial_balance (the "report tier") — not 2 free calls each. Required: public_key, nonce, timestamp, signature.

get_income_statement(nonce, since, until, signature, timestamp, public_key, payment_header)

Income statement, period-scoped by since/until (ISO date strings, both optional — omitted means whole history). Always books full history first, then clamps the output to the requested period (never filters input dates — see reports.py for why). Shares a combined free allowance of 2 with export_ledger, get_balance_sheet, and get_trial_balance (the "report tier") — not 2 free calls each. Required: public_key, nonce, timestamp, signature.

get_trial_balance(nonce, since, until, signature, timestamp, public_key, payment_header)

Trial balance, period-scoped same as income statement — same underlying compute, priced and audited as its own resource. Shares a combined free allowance of 2 with export_ledger, get_balance_sheet, and get_income_statement (the "report tier") — not 2 free calls each. Required: public_key, nonce, timestamp, signature.

list_accounts(nonce, signature, timestamp, public_key, payment_header)

List all opened accounts with their currency constraints and booking method. No booking pass involved. Your first 2 calls per registered key are free (a separate allowance from list_directives' and the report tier's — see those tools). Required: public_key, nonce, timestamp, signature.

list_directives(limit, nonce, since, until, account, signature, timestamp, public_key, payment_header)

List raw directives (optionally filtered by account/date range). No booking involved — cheapest paid tool. `since`/`until` are ISO date strings (YYYY-MM-DD). Your first 2 calls per registered key are free (independent of the write/accounts/report allowances — see list_accounts, get_balance_sheet). Required: public_key, nonce, timestamp, signature.

register

Generate a new Ed25519 keypair for ledger identity. Returns the private key exactly once — it is never stored server-side and cannot be recovered if lost. This is a SEPARATE keypair from whatever wallet you use to authorize x402 payments (payment auth and ledger identity are two independent signing domains — see payments.py).

submit_batch(nonce, signature, timestamp, directives, public_key, payment_header)

Submit up to 1000 directives atomically — all persist together or none do. Priced 10x a single write, regardless of batch size within the cap. Always paid — the free-trial allowance (see submit_directive) applies to single writes only, never to batches, even if you haven't used any free writes yet. Paid. Required: directives, public_key, nonce, timestamp, signature.

submit_directive(text, nonce, signature, timestamp, public_key, payment_header)

Submit one Beancount directive (open, transaction, close, balance, price, note, document — any type). Paid, except your first 20 accepted writes per registered key, which are free (this specific tool only — submit_batch is always paid, even for your first call). Call with no payment_header first: if free writes remain, this succeeds immediately; otherwise you'll get price/asset/recipient back, so you can retry with payment_header set to your signed X-PAYMENT-equivalent payload (fresh nonce required on the retry — each call is independently signed). Required: text, public_key, nonce, timestamp, signature.

validate_directive(text, nonce, signature, timestamp, public_key)

Free dry-run: parse+book text against your full history without persisting or charging anything. Still requires a valid signature (identity/replay protection is not a billing concern). Required: text, public_key, nonce, timestamp, signature.

Last successful function declaration observed on 2026-08-13. Source: https://journalize.dev/mcp. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://journalize.dev/mcp.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Website — https://journalize.dev
• Remote endpoint (streamable-http) — https://journalize.dev/mcp