journalize
Agent-native double-entry accounting ledger with x402 micropayments
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"journalize": {
"url": "https://journalize.dev/mcp"
}
}
}Remote endpoints
https://journalize.dev/mcpstreamable-httpWhat it can do
Tool inventory
Tools (11)
🟡submit_directive(text, public_key, nonce, timestamp, signature, ...)
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).
Input Schema
{
"type": "object",
"properties": {
"text": {
"title": "Text",
"type": "string"
},
"public_key": {
"title": "Public Key",
"type": "string"
},
"nonce": {
"title": "Nonce",
"type": "string"
},
"timestamp": {
"title": "Timestamp",
"type": "string"
},
"signature": {
"title": "Signature",
"type": "string"
},
"payment_header": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Payment Header"
}
},
"required": [
"text",
"public_key",
"nonce",
"timestamp",
"signature"
],
"title": "submit_directiveArguments"
}⚪validate_directive(text, public_key, nonce, timestamp, signature)
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).
Input Schema
{
"type": "object",
"properties": {
"text": {
"title": "Text",
"type": "string"
},
"public_key": {
"title": "Public Key",
"type": "string"
},
"nonce": {
"title": "Nonce",
"type": "string"
},
"timestamp": {
"title": "Timestamp",
"type": "string"
},
"signature": {
"title": "Signature",
"type": "string"
}
},
"required": [
"text",
"public_key",
"nonce",
"timestamp",
"signature"
],
"title": "validate_directiveArguments"
}🟡submit_batch(directives, public_key, nonce, timestamp, signature, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"directives": {
"items": {
"type": "string"
},
"title": "Directives",
"type": "array"
},
"public_key": {
"title": "Public Key",
"type": "string"
},
"nonce": {
"title": "Nonce",
"type": "string"
},
"timestamp": {
"title": "Timestamp",
"type": "string"
},
"signature": {
"title": "Signature",
"type": "string"
},
"payment_header": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Payment Header"
}
},
"required": [
"directives",
"public_key",
"nonce",
"timestamp",
"signature"
],
"title": "submit_batchArguments"
}🟢list_directives(public_key, nonce, timestamp, signature, account, ...)
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).
Input Schema
{
"type": "object",
"properties": {
"public_key": {
"title": "Public Key",
"type": "string"
},
"nonce": {
"title": "Nonce",
"type": "string"
},
"timestamp": {
"title": "Timestamp",
"type": "string"
},
"signature": {
"title": "Signature",
"type": "string"
},
"account": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Account"
},
"since": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Since"
},
"until": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Until"
},
"limit": {
"default": 100,
"title": "Limit",
"type": "integer"
},
"payment_header": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Payment Header"
}
},
"required": [
"public_key",
"nonce",
"timestamp",
"signature"
],
"title": "list_directivesArguments"
}🟢list_accounts(public_key, nonce, timestamp, signature, 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).
Input Schema
{
"type": "object",
"properties": {
"public_key": {
"title": "Public Key",
"type": "string"
},
"nonce": {
"title": "Nonce",
"type": "string"
},
"timestamp": {
"title": "Timestamp",
"type": "string"
},
"signature": {
"title": "Signature",
"type": "string"
},
"payment_header": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Payment Header"
}
},
"required": [
"public_key",
"nonce",
"timestamp",
"signature"
],
"title": "list_accountsArguments"
}🟢get_account_balance(account, public_key, nonce, timestamp, signature, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"account": {
"title": "Account",
"type": "string"
},
"public_key": {
"title": "Public Key",
"type": "string"
},
"nonce": {
"title": "Nonce",
"type": "string"
},
"timestamp": {
"title": "Timestamp",
"type": "string"
},
"signature": {
"title": "Signature",
"type": "string"
},
"payment_header": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Payment Header"
}
},
"required": [
"account",
"public_key",
"nonce",
"timestamp",
"signature"
],
"title": "get_account_balanceArguments"
}🟢export_ledger(public_key, nonce, timestamp, signature, 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.
Input Schema
{
"type": "object",
"properties": {
"public_key": {
"title": "Public Key",
"type": "string"
},
"nonce": {
"title": "Nonce",
"type": "string"
},
"timestamp": {
"title": "Timestamp",
"type": "string"
},
"signature": {
"title": "Signature",
"type": "string"
},
"payment_header": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Payment Header"
}
},
"required": [
"public_key",
"nonce",
"timestamp",
"signature"
],
"title": "export_ledgerArguments"
}🟢get_balance_sheet(public_key, nonce, timestamp, signature, 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.
Input Schema
{
"type": "object",
"properties": {
"public_key": {
"title": "Public Key",
"type": "string"
},
"nonce": {
"title": "Nonce",
"type": "string"
},
"timestamp": {
"title": "Timestamp",
"type": "string"
},
"signature": {
"title": "Signature",
"type": "string"
},
"payment_header": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Payment Header"
}
},
"required": [
"public_key",
"nonce",
"timestamp",
"signature"
],
"title": "get_balance_sheetArguments"
}🟢get_income_statement(public_key, nonce, timestamp, signature, since, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"public_key": {
"title": "Public Key",
"type": "string"
},
"nonce": {
"title": "Nonce",
"type": "string"
},
"timestamp": {
"title": "Timestamp",
"type": "string"
},
"signature": {
"title": "Signature",
"type": "string"
},
"since": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Since"
},
"until": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Until"
},
"payment_header": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Payment Header"
}
},
"required": [
"public_key",
"nonce",
"timestamp",
"signature"
],
"title": "get_income_statementArguments"
}🟢get_trial_balance(public_key, nonce, timestamp, signature, since, ...)
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.
Input Schema
{
"type": "object",
"properties": {
"public_key": {
"title": "Public Key",
"type": "string"
},
"nonce": {
"title": "Nonce",
"type": "string"
},
"timestamp": {
"title": "Timestamp",
"type": "string"
},
"signature": {
"title": "Signature",
"type": "string"
},
"since": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Since"
},
"until": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Until"
},
"payment_header": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Payment Header"
}
},
"required": [
"public_key",
"nonce",
"timestamp",
"signature"
],
"title": "get_trial_balanceArguments"
}⚪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).
Input Schema
{
"type": "object",
"properties": {},
"title": "registerArguments"
}Community
Evidence