@kirjapro/mcp-server 0.14.1 → 0.15.0

package/CHANGELOG.md

@@ -2,9 +2,47 @@
 
 ## [Unreleased]
 
+## [0.15.0] - 2026-10-06
+
+Uses the database migration `20261006140000` (AI-työtila HQ U-49/U-50). Only the
+`kirjapro_record_payment` definition and fingerprint change. 0.14.2 and every earlier
+published version keep working against the new database: their payments debit the
+receiving bank ledger account that the database derives, and an equal bank-matched
+receipt is refused with the database's Finnish reason after "Failed to record
+payment:". Against a database without the migration, a call without the two new
+inputs books as in 0.14.2, and a call with `bankAccountId` or `confirmDuplicate`
+fails with "Failed to record payment".
+
+- `kirjapro_record_payment` takes an optional `bankAccountId` (an id from
+  `kirjapro_list_bank_accounts`); pass it when known. The payment voucher debits
+  that bank account's ledger account (its mapped 2920–2999 account, else 2920); an
+  inactive bank account is refused with `INACTIVE_BANK_ACCOUNT: <Finnish reason>`. Without it the database debits the one ledger
+  account every active bank account of the company maps to, else 2920 as before. The result adds `bank_gl_account_number`, the debited account.
+- A payment equal to a receipt of the same invoice that is already matched or linked
+  from the bank statement (the bank line dated 120 days before to 31 days after the
+  payment) is refused with `DUPLICATE_BANK_RECEIPT: <reason> If the user confirms
+  this is a separate receipt, call again with confirmDuplicate: true and a new
+  idempotencyKey.` The optional `confirmDuplicate: true` books such a separate
+  receipt; use it only after this refusal and the user's confirmation.
+
+## [0.14.2] - 2026-10-06
+
+A maintenance release: no tool definition, fingerprint, input, command or result
+changes. 0.14.1 and every earlier published version keep working unchanged.
+
+- Internal: the bundled invoice-draft core (`src/shared/invoice-draft.ts`) is now
+  generated from the same source as Kirjapro's own invoice-draft core; no behaviour
+  change.
+- In Kirjapro (no client update needed): each invoice an API key creates, with
+  `kirjapro_create_invoice` or `kirjapro_convert_offer_to_invoice`, gets one
+  `mcp_invoice_created` audit entry naming the key. This applies to every published
+  version once Kirjapro's database has the change.
+
 ## [0.14.1] - 2026-10-05
 
-Uses the database migration `20261005210000` (AI-työtila 2.0 round 4, batch 7).
+Published on 2026-10-06 by tag `mcp-server/v0.14.1` from `7437e2a2` (the PR #426
+merge), after `db:deploy` of `20261005210000` and `20261005230000`. Uses the database
+migration `20261005210000` (AI-työtila 2.0 round 4, batch 7).
 Against a database without it the refusal keeps the 0.14.0 text. 0.14.0 keeps
 working against the new database and reports such a key as "Permission denied."
 Tool definitions are unchanged.

package/dist/index.js

@@ -35679,7 +35679,7 @@ var StdioServerTransport = class {
 import { createClient } from "@supabase/supabase-js";
 
 // src/version.ts
-var VERSION = "0.14.1";
+var VERSION = "0.15.0";
 
 // src/auth.ts
 var SUPABASE_PROJECT_URL = "https://tifewzsimmyoiepblhld.supabase.co";
@@ -37990,7 +37990,7 @@ function registerInvoiceTools(server2) {
   server2.registerTool(
     "kirjapro_record_payment",
     {
-      description: 'Record a payment against an invoice after signed payments and finalized credits. Rejects credit notes and invoices with no payable balance. Returns the actual cash-derived status and signed remaining balance; credit plus cash settlement can remain "partial". Returns posting warnings if the receivable\u2192bank journal is skipped.',
+      description: 'Record a payment against an invoice after signed payments and finalized credits. Rejects credit notes and invoices with no payable balance. Returns the actual cash-derived status and signed remaining balance; credit plus cash settlement can remain "partial". The receivable\u2192bank journal debits the ledger account of the receiving bank account (bank_gl_account_number): pass the id of the receiving bank account as bankAccountId when known (from kirjapro_list_bank_accounts). Refuses with DUPLICATE_BANK_RECEIPT when an equal receipt of the invoice is already matched or linked from the bank statement. Returns posting warnings if the journal is skipped.',
       inputSchema: {
         invoiceId: external_exports.string().uuid().describe("Invoice UUID"),
         paymentDate: ISO_DATE_SCHEMA.describe("Payment date (YYYY-MM-DD)"),
@@ -38001,6 +38001,12 @@ function registerInvoiceTools(server2) {
         paymentMethod: external_exports.enum(["bank_transfer", "cash", "card", "other"]).default("bank_transfer").describe("Payment method (one of: bank_transfer, cash, card, other)"),
         reference: external_exports.string().max(140).optional().describe("Payment reference"),
         notes: external_exports.string().max(2e3).optional().describe("Payment notes"),
+        bankAccountId: external_exports.string().uuid().optional().describe(
+          "The receiving bank account's id, when known (from kirjapro_list_bank_accounts). Its ledger account is debited; an inactive bank account is refused. Without it the database derives the ledger account."
+        ),
+        confirmDuplicate: external_exports.boolean().optional().describe(
+          "Set true only after this tool reported DUPLICATE_BANK_RECEIPT (an equal bank-matched receipt) and the user confirmed this is a separate payment. Use a new idempotencyKey."
+        ),
         idempotencyKey: IDEMPOTENCY_KEY_SCHEMA
       },
       annotations: WRITE_ANNOTATIONS
@@ -38074,7 +38080,11 @@ function registerInvoiceTools(server2) {
               p_amount: params.amount,
               p_payment_method: params.paymentMethod,
               p_reference: params.reference || void 0,
-              p_notes: params.notes || void 0
+              p_notes: params.notes || void 0,
+              // Sent only when set: the original seven arguments keep working
+              // against a database without the receiving bank account.
+              ...params.bankAccountId ? { p_bank_account_id: params.bankAccountId } : {},
+              ...params.confirmDuplicate ? { p_confirm_duplicate: true } : {}
             }
           );
           if (isWriteOutcomeUnknown(payError, payStatus)) {
@@ -38083,6 +38093,14 @@ function registerInvoiceTools(server2) {
               "kirjapro_get_invoice (its payments and remaining_balance)"
             );
           }
+          if (payError?.hint === "confirm_duplicate") {
+            return toErrorContent(
+              `DUPLICATE_BANK_RECEIPT: ${payError.message} If the user confirms this is a separate receipt, call again with confirmDuplicate: true and a new idempotencyKey.`
+            );
+          }
+          if (payError?.message?.startsWith("Pankkitili ei ole k\xE4yt\xF6ss\xE4")) {
+            return toErrorContent(`INACTIVE_BANK_ACCOUNT: ${payError.message}`);
+          }
           if (payError || !paymentResult) {
             return toErrorContent(
               payError ? sanitizeDbError("Failed to record payment", payError) : "Failed to record payment."
@@ -38097,6 +38115,7 @@ function registerInvoiceTools(server2) {
             remaining_balance: result.remaining_balance,
             journal_entry_id: result.journal_entry_id ?? null,
             journal_entry_skipped: journalSkipped,
+            bank_gl_account_number: result.bank_gl_account_number ?? null,
             ...journalSkipped && {
               warning: `Payment recorded, but the general-ledger journal entry was SKIPPED (reason: ${journalSkipped}). The subledger reflects the payment; the GL does not. Review the accounting setup and the missing posting.`
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kirjapro/mcp-server",
-  "version": "0.14.1",
+  "version": "0.15.0",
   "description": "MCP server for Finnish accounting — exposes Kirjapro bookkeeping, invoicing, and reporting tools to Claude, ChatGPT, Mistral, and other MCP clients.",
   "type": "module",
   "bin": {

package/server.json

@@ -2,7 +2,7 @@
   "name": "@kirjapro/mcp-server",
   "displayName": "Kirjapro - Finnish Accounting",
   "description": "Finnish double-entry bookkeeping, invoicing, and financial reporting for growing businesses. Create transactions, generate invoices with VAT calculation, produce income statements and balance sheets, and validate Finnish business identifiers.",
-  "version": "0.14.1",
+  "version": "0.15.0",
   "homepage": "https://kirjapro.fi",
   "repository": "https://github.com/Jaollo/kirja-pro",
   "license": "MIT",

package/tool-fingerprints.json

@@ -178,7 +178,7 @@
     },
     {
       "name": "kirjapro_record_payment",
-      "hash": "271c3895f65db17e"
+      "hash": "d330f22c10187dca"
     },
     {
       "name": "kirjapro_search_transactions",