journalize
Agent-native double-entry accounting ledger with x402 micropayments
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"journalize": {
"url": "https://journalize.dev/mcp"
}
}
}Puntos de conexión remotos
https://journalize.dev/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (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).
Esquema de entrada
{
"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).
Esquema de entrada
{
"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.
Esquema de entrada
{
"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).
Esquema de entrada
{
"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).
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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).
Esquema de entrada
{
"type": "object",
"properties": {},
"title": "registerArguments"
}Comunidad
Evidencia