Koskamo

Journalize MCP

An agent-native double-entry accounting ledger that allows AI agents to perform accounting tasks, including budgeting and tax preparation, by storing and validating Beancount directives and generating financial reports like balance sheets and income statements.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Journalize MCP logo, by JournalizeVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-06Operated by Journalize
MCP endpoint (Streamable HTTP)
https://journalize.dev/mcp
Vendor documentation

What its tools do

11 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Not annotated (11)

11 of 11 have a description · 0 of 11 declare behavior hints · 0 of 10 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Passed Official MCP Registry namespace is tied to journalize.dev ·
  • Passed Endpoint is on the registry namespace domain ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Store double-entry accounting directives
  • Validate accounting entries against Beancount rules
  • Generate balance sheets and income statements
  • Manage multi-currency and cryptocurrency accounts

Source and maintenance

Vendor evidenceRegistry 1.0.0
mcp-registry: dev.journalize/journalize@1.0.0Project website

Protocol and capabilities

Server
agent-native-ledger 1.28.1
MCP protocol negotiated in check
2025-11-25
Tools
11 advertised
Resources
0 advertised
Resource templates
0 advertised
Prompts
0 advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": false
  },
  "prompts": {
    "listChanged": false
  },
  "resources": {
    "subscribe": false,
    "listChanged": false
  },
  "experimental": {}
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

A double-entry accounting ledger for AI agents. Every write and read is a paid x402 action except register and validate_directive. Call register once to get a keypair, then sign every subsequent call with it.

Tools

11 advertised

submit_directive
Advertised by the server during the last successful anonymous check.

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).

submit_directive input schema
{
  "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": null
    }
  }
}
validate_directive
Advertised by the server during the last successful anonymous check.

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).

validate_directive input schema
{
  "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"
    }
  }
}
submit_batch
Advertised by the server during the last successful anonymous check.

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.

submit_batch input schema
{
  "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": null
    }
  }
}
list_directives
Advertised by the server during the last successful anonymous check.

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).

list_directives input schema
{
  "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": null
    },
    "until": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Until",
      "default": null
    },
    "account": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Account",
      "default": null
    },
    "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": null
    }
  }
}
list_accounts
Advertised by the server during the last successful anonymous check.

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).

list_accounts input schema
{
  "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": null
    }
  }
}
get_account_balance
Advertised by the server during the last successful anonymous check.

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.

get_account_balance input schema
{
  "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": null
    }
  }
}
export_ledger
Advertised by the server during the last successful anonymous check.

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.

export_ledger input schema
{
  "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": null
    }
  }
}
get_balance_sheet
Advertised by the server during the last successful anonymous check.

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.

get_balance_sheet input schema
{
  "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": null
    }
  }
}
get_income_statement
Advertised by the server during the last successful anonymous check.

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.

get_income_statement input schema
{
  "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": null
    },
    "until": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Until",
      "default": null
    },
    "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": null
    }
  }
}
get_trial_balance
Advertised by the server during the last successful anonymous check.

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.

get_trial_balance input schema
{
  "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": null
    },
    "until": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Until",
      "default": null
    },
    "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": null
    }
  }
}
register
Advertised by the server during the last successful anonymous check.

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).

register input schema
{
  "type": "object",
  "title": "registerArguments",
  "properties": {}
}

Prompts

0 advertised

No prompt definitions available.

Resources

0 advertised

No resource definitions available.

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (3 of 3 answered).

  1. 2026-11-06: 1 of 1 checks answered
  2. 2026-11-07: 2 of 2 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
427 ms
95th percentile latency
427 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 427 ms · metadata changed · 11 tool(s), 0 resource(s), 0 resource template(s), 0 prompt(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http journalize-mcp https://journalize.dev/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add journalize-mcp --url https://journalize.dev/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable journalize-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "journalize-mcp": {
      "url": "https://journalize.dev/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "journalize-mcp": {
      "type": "streamableHttp",
      "url": "https://journalize.dev/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start journalize-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "journalize-mcp": {
      "type": "http",
      "url": "https://journalize.dev/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http journalize-mcp https://journalize.dev/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://journalize.dev/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "journalize-mcp": {
      "serverUrl": "https://journalize.dev/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Journalize MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 682

Do you run Journalize MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing