journalize
Agent-native double-entry accounting ledger with x402 micropayments
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"journalize": {
"url": "https://journalize.dev/mcp"
}
}
}リモートエンドポイント
https://journalize.dev/mcpstreamable-httpできること
ツール一覧
ツール（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).
入力スキーマ
{
"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).
入力スキーマ
{
"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.
入力スキーマ
{
"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).
入力スキーマ
{
"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).
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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).
入力スキーマ
{
"type": "object",
"properties": {},
"title": "registerArguments"
}コミュニティ
エビデンス