journalize
Agent-native double-entry accounting ledger with x402 micropayments
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"journalize": {
"url": "https://journalize.dev/mcp"
}
}
}Remote-Endpunkte
https://journalize.dev/mcpstreamable-httpWas es kann
Tool-Inventar
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).
Eingabe-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).
Eingabe-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.
Eingabe-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).
Eingabe-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).
Eingabe-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.
Eingabe-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.
Eingabe-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.
Eingabe-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.
Eingabe-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.
Eingabe-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).
Eingabe-Schema
{
"type": "object",
"properties": {},
"title": "registerArguments"
}Community
Nachweis