@kirjapro/mcp-server 0.5.8 → 0.5.9

package/dist/index.js

@@ -34012,50 +34012,6 @@ var ACCOUNTS = {
   VAKUUTUKSET: "7970"
 };
 
-// src/compliance/rates.ts
-var FINNISH_RATES_2026 = {
-  year: 2026,
-  validFrom: "2026-01-01",
-  validUntil: "2026-12-31",
-  sourcesVerifiedAt: "2026-03-15",
-  source: "AVL 1501/1993, ETK 2026, Elo 2026, vero.fi 2026",
-  vat: {
-    standard: 25.5,
-    reduced: 13.5,
-    secondReduced: 10,
-    zero: 0
-  },
-  social: {
-    tyelEmployee: 7.3,
-    tyelEmployer: 17.55,
-    tyelEmployerAverage: 17.1,
-    tyelKeskimaarainen: 24.4,
-    tyelPerusmaksu: 24.85,
-    sotu: 1.91,
-    ttvEmployer: 0.31,
-    ttvEmployerLarge: 1.23,
-    ttvEmployerLargeThreshold: 2509500,
-    ttvEmployee: 0.89,
-    tapaturmaAverage: 0.51,
-    ryhmahenki: 0.06
-  }
-};
-function freshnessMeta(rates = FINNISH_RATES_2026, today = /* @__PURE__ */ new Date()) {
-  const validUntil = /* @__PURE__ */ new Date(`${rates.validUntil}T23:59:59Z`);
-  const msPerDay = 864e5;
-  const daysUntilExpiry = Math.ceil(
-    (validUntil.getTime() - today.getTime()) / msPerDay
-  );
-  return {
-    published_at: rates.sourcesVerifiedAt,
-    valid_from: rates.validFrom,
-    valid_through: rates.validUntil,
-    sources_verified_at: rates.sourcesVerifiedAt,
-    stale: daysUntilExpiry < 0,
-    days_until_expiry: daysUntilExpiry
-  };
-}
-
 // src/tools/templates.ts
 function splitVat(gross, vatRate) {
   if (vatRate === 0) return { net: roundCents(gross), vat: 0 };
@@ -34279,36 +34235,6 @@ var TEMPLATES = [
       opts?.accountOverrides
     )
   },
-  // Salary
-  {
-    id: "salary_payment",
-    description: "Palkanmaksu (bruttopalkka, ennakonpid\xE4tys, TyEL)",
-    vatRate: null,
-    expand: (amount, opts) => {
-      const gross = roundCents(amount);
-      const withholdingRate = opts?.withholdingRate ?? 20;
-      const tyelEmployeeRate = opts?.tyelRate ?? FINNISH_RATES_2026.social.tyelEmployee;
-      const tyelEmployerRate = FINNISH_RATES_2026.social.tyelEmployer;
-      const withholding = roundCents(gross * withholdingRate / 100);
-      const tyelEmployee = roundCents(gross * tyelEmployeeRate / 100);
-      const tyelEmployer = roundCents(gross * tyelEmployerRate / 100);
-      const netPay = roundCents(gross - withholding - tyelEmployee);
-      return applyOverrides(
-        [
-          { accountNumber: ACCOUNTS.PALKAT, debitAmount: gross, creditAmount: 0 },
-          { accountNumber: ACCOUNTS.ELAKEKULUT, debitAmount: tyelEmployer, creditAmount: 0 },
-          { accountNumber: ACCOUNTS.PANKKITILI, debitAmount: 0, creditAmount: netPay },
-          { accountNumber: ACCOUNTS.ENNAKONPIDATYSVELKA, debitAmount: 0, creditAmount: withholding },
-          {
-            accountNumber: ACCOUNTS.TYEL_VELKA,
-            debitAmount: 0,
-            creditAmount: roundCents(tyelEmployee + tyelEmployer)
-          }
-        ],
-        opts?.accountOverrides
-      );
-    }
-  },
   // Bank transfer
   {
     id: "bank_transfer",
@@ -34477,8 +34403,6 @@ function registerTemplateTools(server2) {
         amount: external_exports.number().finite().positive().max(1e9).describe("Gross amount in EUR"),
         description: external_exports.string().min(1).max(500).describe("Transaction description"),
         documentNumber: external_exports.string().optional().describe("Document/receipt number"),
-        withholdingRate: external_exports.number().min(0).max(100).optional().describe("Withholding tax % for salary_payment (default 20)"),
-        tyelRate: external_exports.number().min(0).max(100).optional().describe("TyEL employee % for salary_payment (default 7.30)"),
         accountOverrides: external_exports.record(external_exports.string(), external_exports.string()).optional().describe('Account number swaps, e.g. {"2320": "2330"}'),
         idempotencyKey: IDEMPOTENCY_KEY_SCHEMA
       },
@@ -34499,8 +34423,6 @@ function registerTemplateTools(server2) {
             if ("error" in ov) return toErrorContent(ov.error);
           }
           const result = expandTemplate(params.template, params.amount, {
-            withholdingRate: params.withholdingRate,
-            tyelRate: params.tyelRate,
             accountOverrides: params.accountOverrides
           });
           if ("error" in result) {
@@ -34542,8 +34464,6 @@ function registerTemplateTools(server2) {
             amount: external_exports.number().finite().positive().max(1e9).describe("Gross amount in EUR"),
             description: external_exports.string().min(1).max(500),
             documentNumber: external_exports.string().optional(),
-            withholdingRate: external_exports.number().min(0).max(100).optional(),
-            tyelRate: external_exports.number().min(0).max(100).optional(),
             accountOverrides: external_exports.record(external_exports.string(), external_exports.string()).optional()
           })
         ).min(1).max(50).describe("Array of template transactions to create (max 50)"),
@@ -34600,8 +34520,6 @@ function registerTemplateTools(server2) {
           for (let i = 0; i < params.transactions.length; i++) {
             const tx = params.transactions[i];
             const result2 = expandTemplate(tx.template, tx.amount, {
-              withholdingRate: tx.withholdingRate,
-              tyelRate: tx.tyelRate,
               accountOverrides: tx.accountOverrides
             });
             if ("error" in result2) {
@@ -34705,6 +34623,50 @@ function registerTemplateTools(server2) {
   );
 }
 
+// src/compliance/rates.ts
+var FINNISH_RATES_2026 = {
+  year: 2026,
+  validFrom: "2026-01-01",
+  validUntil: "2026-12-31",
+  sourcesVerifiedAt: "2026-03-15",
+  source: "AVL 1501/1993, ETK 2026, Elo 2026, vero.fi 2026",
+  vat: {
+    standard: 25.5,
+    reduced: 13.5,
+    secondReduced: 10,
+    zero: 0
+  },
+  social: {
+    tyelEmployee: 7.3,
+    tyelEmployer: 17.55,
+    tyelEmployerAverage: 17.1,
+    tyelKeskimaarainen: 24.4,
+    tyelPerusmaksu: 24.85,
+    sotu: 1.91,
+    ttvEmployer: 0.31,
+    ttvEmployerLarge: 1.23,
+    ttvEmployerLargeThreshold: 2509500,
+    ttvEmployee: 0.89,
+    tapaturmaAverage: 0.51,
+    ryhmahenki: 0.06
+  }
+};
+function freshnessMeta(rates = FINNISH_RATES_2026, today = /* @__PURE__ */ new Date()) {
+  const validUntil = /* @__PURE__ */ new Date(`${rates.validUntil}T23:59:59Z`);
+  const msPerDay = 864e5;
+  const daysUntilExpiry = Math.ceil(
+    (validUntil.getTime() - today.getTime()) / msPerDay
+  );
+  return {
+    published_at: rates.sourcesVerifiedAt,
+    valid_from: rates.validFrom,
+    valid_through: rates.validUntil,
+    sources_verified_at: rates.sourcesVerifiedAt,
+    stale: daysUntilExpiry < 0,
+    days_until_expiry: daysUntilExpiry
+  };
+}
+
 // src/tools/bookings.ts
 var DEFAULTS = {
   tyelEmployee: FINNISH_RATES_2026.social.tyelEmployee,
@@ -34802,131 +34764,6 @@ function registerBookingTools(server2) {
       );
     }
   );
-  server2.registerTool(
-    "kirjapro_book_salary",
-    {
-      description: "Book salary payment (palkanmaksu). Creates salary + employer cost transactions with withholding, TyEL, TTV, sotu. Default rates are 2026 Finnish social insurance rates.",
-      inputSchema: {
-        grossSalary: external_exports.number().finite().positive().max(1e8).describe("Gross salary EUR"),
-        employeeName: external_exports.string().min(1).describe("Employee name (for description)"),
-        date: ISO_DATE_SCHEMA.describe("Payment date (YYYY-MM-DD)"),
-        withholdingRate: external_exports.number().min(0).max(100).describe("Withholding tax % (ennakonpid\xE4tys)"),
-        tyelEmployeeRate: external_exports.number().min(0).max(100).default(DEFAULTS.tyelEmployee).describe("TyEL employee % (default 7.30)"),
-        tyelEmployerRate: external_exports.number().min(0).max(100).default(DEFAULTS.tyelEmployer).describe("TyEL employer % (default 17.55)"),
-        sotuRate: external_exports.number().min(0).max(100).default(DEFAULTS.sotu).describe("Sairausvakuutusmaksu employer % (default 1.91)"),
-        ttvEmployerRate: external_exports.number().min(0).max(100).default(DEFAULTS.ttvEmployer).describe("Ty\xF6tt\xF6myysvakuutus employer % (default 0.31)"),
-        ttvEmployeeRate: external_exports.number().min(0).max(100).default(DEFAULTS.ttvEmployee).describe("Ty\xF6tt\xF6myysvakuutus employee % (default 0.89)"),
-        fiscalYearId: external_exports.string().uuid().optional().describe("Fiscal year UUID (auto-resolved if omitted)"),
-        paymentAccount: external_exports.string().default(ACCOUNTS.PANKKITILI).describe(`Bank account (default "${ACCOUNTS.PANKKITILI}" Pankkitili)`),
-        idempotencyKey: IDEMPOTENCY_KEY_SCHEMA,
-        dryRun: DRY_RUN_SCHEMA
-      },
-      annotations: WRITE_ANNOTATIONS
-    },
-    async (params) => {
-      const gross = roundCents(params.grossSalary);
-      const withholding = roundCents(gross * params.withholdingRate / 100);
-      const tyelEmployee = roundCents(gross * params.tyelEmployeeRate / 100);
-      const ttvEmployee = roundCents(gross * params.ttvEmployeeRate / 100);
-      const netPay = roundCents(gross - withholding - tyelEmployee - ttvEmployee);
-      const tyelEmployer = roundCents(gross * params.tyelEmployerRate / 100);
-      const sotuAmount = roundCents(gross * params.sotuRate / 100);
-      const ttvEmployer = roundCents(gross * params.ttvEmployerRate / 100);
-      if (netPay < 0) {
-        return toErrorContent(
-          `Net pay is negative (${netPay.toFixed(2)}). Check withholding rate (${params.withholdingRate}%) and deduction rates.`
-        );
-      }
-      const supabase2 = getSupabase();
-      const companyId2 = getCompanyId();
-      let fiscalYearId = params.fiscalYearId;
-      if (!fiscalYearId) {
-        const resolved = await resolveOpenFiscalYear(supabase2, companyId2);
-        if ("isError" in resolved) return resolved;
-        fiscalYearId = resolved.id;
-      }
-      const fy = await validateFiscalYearForDate(fiscalYearId, params.date);
-      if ("isError" in fy) return fy;
-      const salaryEntries = [
-        { accountNumber: ACCOUNTS.PALKAT, debitAmount: gross, creditAmount: 0 },
-        { accountNumber: params.paymentAccount, debitAmount: 0, creditAmount: netPay },
-        { accountNumber: ACCOUNTS.ENNAKONPIDATYSVELKA, debitAmount: 0, creditAmount: withholding },
-        { accountNumber: ACCOUNTS.TYEL_VELKA, debitAmount: 0, creditAmount: tyelEmployee },
-        { accountNumber: ACCOUNTS.TTV_VELKA, debitAmount: 0, creditAmount: ttvEmployee }
-      ];
-      const employerSotuTtv = roundCents(sotuAmount + ttvEmployer);
-      const employerEntries = [
-        { accountNumber: ACCOUNTS.ELAKEKULUT, debitAmount: tyelEmployer, creditAmount: 0 },
-        { accountNumber: ACCOUNTS.SOSIAALITURVAMAKSUT, debitAmount: employerSotuTtv, creditAmount: 0 },
-        { accountNumber: ACCOUNTS.TYEL_VELKA, debitAmount: 0, creditAmount: tyelEmployer },
-        { accountNumber: ACCOUNTS.SOTU_VELKA, debitAmount: 0, creditAmount: sotuAmount },
-        { accountNumber: ACCOUNTS.TTV_VELKA, debitAmount: 0, creditAmount: ttvEmployer }
-      ];
-      if (params.dryRun) {
-        return toDryRunResponse("kirjapro_book_salary", {
-          action: "book_salary",
-          employee: params.employeeName,
-          date: params.date,
-          salary_entries: salaryEntries,
-          employer_entries: employerEntries,
-          summary: {
-            gross,
-            withholding,
-            tyelEmployee,
-            ttvEmployee,
-            netPay,
-            tyelEmployer,
-            sotu: sotuAmount,
-            ttvEmployer,
-            totalEmployerCost: roundCents(gross + tyelEmployer + sotuAmount + ttvEmployer)
-          }
-        });
-      }
-      const accountMap = await resolveAccountNumbers(
-        [...salaryEntries, ...employerEntries].map((e) => e.accountNumber)
-      );
-      if ("isError" in accountMap) return accountMap;
-      return withIdempotency(
-        supabase2,
-        companyId2,
-        "kirjapro_book_salary",
-        params.idempotencyKey,
-        params,
-        async () => {
-          const { data, error: error51 } = await supabase2.rpc("book_salary_atomic", {
-            p_company_id: companyId2,
-            p_fiscal_year_id: fiscalYearId,
-            p_transaction_date: params.date,
-            p_employee_name: params.employeeName,
-            p_salary_entries: toJournalEntries(salaryEntries, accountMap),
-            p_employer_entries: toJournalEntries(employerEntries, accountMap)
-          });
-          if (error51 || !data) {
-            return toErrorContent(
-              error51 ? sanitizeDbError("Failed to book salary", error51) : "Failed to book salary: no response from RPC"
-            );
-          }
-          const result = data;
-          return toResult({
-            message: "Salary booked (2 transactions, atomic)",
-            salary_transaction_id: result.salary_transaction_id,
-            employer_costs_transaction_id: result.employer_costs_transaction_id,
-            summary: {
-              gross,
-              withholding,
-              tyelEmployee,
-              ttvEmployee,
-              netPay,
-              tyelEmployer,
-              sotu: sotuAmount,
-              ttvEmployer,
-              totalEmployerCost: roundCents(gross + tyelEmployer + sotuAmount + ttvEmployer)
-            }
-          });
-        }
-      );
-    }
-  );
   server2.registerTool(
     "kirjapro_book_vat_settlement",
     {
@@ -36251,7 +36088,7 @@ function resolveSurface(explicit) {
   if (env === "core") return "core";
   if (env && env !== "core") {
     console.error(
-      `[kirjapro-mcp] Unknown KIRJAPRO_MCP_SURFACE="${env}" \u2014 falling back to "core". Valid values: "core" (default, 26 tools), "full" (53 tools).`
+      `[kirjapro-mcp] Unknown KIRJAPRO_MCP_SURFACE="${env}" \u2014 falling back to "core". Valid values: "core" (default, 26 tools), "full" (52 tools).`
     );
   }
   return "core";
@@ -36286,7 +36123,7 @@ function registerTools(server2, options = {}) {
     );
   } else {
     console.error(
-      `[kirjapro-mcp] surface=full \u2014 registered all 53 tools (CORE_TOOL_NAMES bypass active).`
+      `[kirjapro-mcp] surface=full \u2014 registered all 52 tools (CORE_TOOL_NAMES bypass active).`
     );
   }
 }
@@ -36800,7 +36637,7 @@ function registerResources(server2) {
 }
 
 // src/version.ts
-var VERSION = "0.5.8";
+var VERSION = "0.5.9";
 
 // src/index.ts
 var INSTRUCTIONS_COMMON = `
@@ -36907,7 +36744,8 @@ var INSTRUCTIONS_CORE_ADDENDUM = `
 The following workflows are NOT exposed in the current (core) surface. When a user asks for them, redirect to the web UI rather than reaching for the closest available tool:
 
 - **Recurring invoice templates** \u2014 created and managed in the web app; cron generates the issued invoices
-- **Booking shortcuts** (book_purchase / book_sale / book_salary / book_vat_settlement) \u2014 for these, you CAN compose the journal entries manually via \`kirjapro_create_transaction\` with explicit debit/credit lines if the user prefers; otherwise redirect
+- **Booking shortcuts** (book_purchase / book_sale / book_vat_settlement) \u2014 for these, you CAN compose the journal entries manually via \`kirjapro_create_transaction\` with explicit debit/credit lines if the user prefers; otherwise redirect
+- **Payroll (palkanlaskenta)** \u2014 Kirjapro does NOT calculate or book payroll. Direct the user to Palkkaus.fi or Palkka.fi for the calculation, then bring the resulting payslip back and book it via \`kirjapro_create_transaction\` with explicit debit/credit lines
 - **Transaction templates** \u2014 manual journal entries via \`kirjapro_create_transaction\`
 - **Manual offer status changes** \u2014 the customer's email-link click sets status server-side; just wait for the user to confirm acceptance
 - **Listing or fetching past offers** \u2014 the user can view them in the web UI
@@ -36926,8 +36764,8 @@ var INSTRUCTIONS_FULL_ADDENDUM = `
 ### Booking Shortcuts
 Faster than composing journal entries via \`kirjapro_create_transaction\`:
 - \`kirjapro_book_sale\` / \`kirjapro_book_purchase\` \u2014 one-liner with auto VAT splitting
-- \`kirjapro_book_salary\` \u2014 creates 2 atomic transactions (salary + employer costs), 2026 rates as defaults
 - \`kirjapro_book_vat_settlement\` \u2014 reads ALV-saamiset/ALV-velka, creates settlement entry. Call \`kirjapro_get_alv_summary\` first to preview.
+- **Payroll is intentionally NOT exposed.** Direct users to Palkkaus.fi / Palkka.fi for salary calculation; the payslip can then be booked manually via \`kirjapro_create_transaction\`.
 - \`kirjapro_list_templates\` \u2192 \`kirjapro_create_from_template\` for common patterns (13 built-in templates)
 
 ### Manual Offer Status
@@ -36946,7 +36784,7 @@ Faster than composing journal entries via \`kirjapro_create_transaction\`:
 
 ### Destructive Operations (always dryRun first)
 - \`kirjapro_delete_invoice\`, \`kirjapro_delete_offer\`, \`kirjapro_delete_recurring_invoice\` \u2014 drafts only; sent/paid must be cancelled first
-- \`kirjapro_book_purchase\`, \`kirjapro_book_sale\`, \`kirjapro_book_salary\` \u2014 call with \`dryRun: true\` to preview the journal entries before commit
+- \`kirjapro_book_purchase\`, \`kirjapro_book_sale\` \u2014 call with \`dryRun: true\` to preview the journal entries before commit
 `.trim();
 function buildInstructions(surface) {
   return surface === "full" ? `${INSTRUCTIONS_COMMON}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kirjapro/mcp-server",
-  "version": "0.5.8",
+  "version": "0.5.9",
   "description": "MCP server for Finnish accounting — exposes Kirjapro bookkeeping, invoicing, and reporting tools to Claude Code, Claude Desktop, and any MCP client.",
   "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.5.7",
+  "version": "0.5.9",
   "homepage": "https://kirjapro.fi",
   "repository": "https://github.com/Jaollo/kirja-pro",
   "license": "MIT",

package/tool-fingerprints.json

@@ -4,10 +4,6 @@
       "name": "kirjapro_book_purchase",
       "hash": "ddb30ea742fd64ef"
     },
-    {
-      "name": "kirjapro_book_salary",
-      "hash": "d60f5e3af5b9814c"
-    },
     {
       "name": "kirjapro_book_sale",
       "hash": "9ce00f1687fc23e0"
@@ -26,11 +22,11 @@
     },
     {
       "name": "kirjapro_create_from_template",
-      "hash": "fa88f94f0b73f3f5"
+      "hash": "d5544fb7b65148b4"
     },
     {
       "name": "kirjapro_create_from_template_batch",
-      "hash": "7530621d165be94b"
+      "hash": "a6290b31dc0a430e"
     },
     {
       "name": "kirjapro_create_invoice",