MCP-Server

journalize

dev.journalize/journalize
Business & Betrieb Finanzen & Investieren Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

Maintains a signed double-entry Beancount ledger with transaction submission, validation, account management, financial reports, and ledger export.

export_ledger
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.
Eingabeschema
{'type': 'object', 'title': 'export_ledgerArguments', 'required': ['public_key', 'nonce', 'timestamp', 'signature'], 'properties': {'nonce': {'type': 'string', 'title': 'Nonce'}, 'signature': {'type': 'string', 'title': 'Signature'}, 'timestamp': {'type': 'string', 'title': 'Timestamp'}, 'public_key': {'type': 'string', 'title': 'Public Key'}, 'payment_header': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Payment Header', 'default': None}}}
get_account_balance
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.
Eingabeschema
{'type': 'object', 'title': 'get_account_balanceArguments', 'required': ['account', 'public_key', 'nonce', 'timestamp', 'signature'], 'properties': {'nonce': {'type': 'string', 'title': 'Nonce'}, 'account': {'type': 'string', 'title': 'Account'}, 'signature': {'type': 'string', 'title': 'Signature'}, 'timestamp': {'type': 'string', 'title': 'Timestamp'}, 'public_key': {'type': 'string', 'title': 'Public Key'}, 'payment_header': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Payment Header', 'default': None}}}
get_balance_sheet
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.
Eingabeschema
{'type': 'object', 'title': 'get_balance_sheetArguments', 'required': ['public_key', 'nonce', 'timestamp', 'signature'], 'properties': {'nonce': {'type': 'string', 'title': 'Nonce'}, 'signature': {'type': 'string', 'title': 'Signature'}, 'timestamp': {'type': 'string', 'title': 'Timestamp'}, 'public_key': {'type': 'string', 'title': 'Public Key'}, 'payment_header': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Payment Header', 'default': None}}}
get_income_statement
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.
Eingabeschema
{'type': 'object', 'title': 'get_income_statementArguments', 'required': ['public_key', 'nonce', 'timestamp', 'signature'], 'properties': {'nonce': {'type': 'string', 'title': 'Nonce'}, 'since': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Since', 'default': None}, 'until': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Until', 'default': None}, 'signature': {'type': 'string', 'title': 'Signature'}, 'timestamp': {'type': 'string', 'title': 'Timestamp'}, 'public_key': {'type': 'string', 'title': 'Public Key'}, 'payment_header': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Payment Header', 'default': None}}}
get_trial_balance
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.
Eingabeschema
{'type': 'object', 'title': 'get_trial_balanceArguments', 'required': ['public_key', 'nonce', 'timestamp', 'signature'], 'properties': {'nonce': {'type': 'string', 'title': 'Nonce'}, 'since': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Since', 'default': None}, 'until': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Until', 'default': None}, 'signature': {'type': 'string', 'title': 'Signature'}, 'timestamp': {'type': 'string', 'title': 'Timestamp'}, 'public_key': {'type': 'string', 'title': 'Public Key'}, 'payment_header': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Payment Header', 'default': None}}}
list_accounts
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).
Eingabeschema
{'type': 'object', 'title': 'list_accountsArguments', 'required': ['public_key', 'nonce', 'timestamp', 'signature'], 'properties': {'nonce': {'type': 'string', 'title': 'Nonce'}, 'signature': {'type': 'string', 'title': 'Signature'}, 'timestamp': {'type': 'string', 'title': 'Timestamp'}, 'public_key': {'type': 'string', 'title': 'Public Key'}, 'payment_header': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Payment Header', 'default': None}}}
list_directives
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).
Eingabeschema
{'type': 'object', 'title': 'list_directivesArguments', 'required': ['public_key', 'nonce', 'timestamp', 'signature'], 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 100}, 'nonce': {'type': 'string', 'title': 'Nonce'}, 'since': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Since', 'default': None}, 'until': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Until', 'default': None}, 'account': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Account', 'default': None}, 'signature': {'type': 'string', 'title': 'Signature'}, 'timestamp': {'type': 'string', 'title': 'Timestamp'}, 'public_key': {'type': 'string', 'title': 'Public Key'}, 'payment_header': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Payment Header', 'default': None}}}
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).
Eingabeschema
{'type': 'object', 'title': 'registerArguments', 'properties': {}}
submit_batch
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.
Eingabeschema
{'type': 'object', 'title': 'submit_batchArguments', 'required': ['directives', 'public_key', 'nonce', 'timestamp', 'signature'], 'properties': {'nonce': {'type': 'string', 'title': 'Nonce'}, 'signature': {'type': 'string', 'title': 'Signature'}, 'timestamp': {'type': 'string', 'title': 'Timestamp'}, 'directives': {'type': 'array', 'items': {'type': 'string'}, 'title': 'Directives'}, 'public_key': {'type': 'string', 'title': 'Public Key'}, 'payment_header': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Payment Header', 'default': None}}}
submit_directive
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).
Eingabeschema
{'type': 'object', 'title': 'submit_directiveArguments', 'required': ['text', 'public_key', 'nonce', 'timestamp', 'signature'], 'properties': {'text': {'type': 'string', 'title': 'Text'}, 'nonce': {'type': 'string', 'title': 'Nonce'}, 'signature': {'type': 'string', 'title': 'Signature'}, 'timestamp': {'type': 'string', 'title': 'Timestamp'}, 'public_key': {'type': 'string', 'title': 'Public Key'}, 'payment_header': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Payment Header', 'default': None}}}
validate_directive
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).
Eingabeschema
{'type': 'object', 'title': 'validate_directiveArguments', 'required': ['text', 'public_key', 'nonce', 'timestamp', 'signature'], 'properties': {'text': {'type': 'string', 'title': 'Text'}, 'nonce': {'type': 'string', 'title': 'Nonce'}, 'signature': {'type': 'string', 'title': 'Signature'}, 'timestamp': {'type': 'string', 'title': 'Timestamp'}, 'public_key': {'type': 'string', 'title': 'Public Key'}}}
Hinzugefügt
register
21. September 2026 02:40
Hinzugefügt
get_trial_balance
21. September 2026 02:40
Hinzugefügt
get_income_statement
21. September 2026 02:40
Hinzugefügt
get_balance_sheet
21. September 2026 02:40
Hinzugefügt
export_ledger
21. September 2026 02:40
Hinzugefügt
get_account_balance
21. September 2026 02:40
Hinzugefügt
list_accounts
21. September 2026 02:40
Hinzugefügt
list_directives
21. September 2026 02:40
Hinzugefügt
submit_batch
21. September 2026 02:40
Hinzugefügt
validate_directive
21. September 2026 02:40
Hinzugefügt
submit_directive
21. September 2026 02:40