e-arveldaja-mcp 0.3.1 → 0.3.2

package/dist/index.js

@@ -93,7 +93,7 @@ async function main() {
     const api = createScopedApiContext(connectionState, connectionContexts, invocationStorage);
     const server = new McpServer({
         name: "e-arveldaja",
-        version: "0.3.1",
+        version: "0.3.2",
         description: "EXPERIMENTAL, UNOFFICIAL MCP server for the Estonian e-arveldaja (e-Financials) API. " +
             "NOT affiliated with or endorsed by RIK. Use entirely at your own risk — " +
             "this software interacts with live financial data and can create, modify, and delete accounting records. " +
@@ -102,17 +102,22 @@ async function main() {
             "PDF invoice extraction, supplier resolution with business registry lookup, " +
             "and smart booking suggestions based on past invoices.",
     }, {
-        instructions: `Call get_vat_info first — VAT status affects purchase invoice booking.
-PDF workflow: extract_pdf_invoice → validate_invoice_data → resolve_supplier → suggest_booking → create_purchase_invoice_from_pdf → upload_invoice_document → confirm_purchase_invoice.
-Pass EXACT vat_price and gross_price from original invoices — never recalculate.
-Check detect_duplicate_purchase_invoice before creating purchase invoices.
-Use list_purchase_articles to find article IDs for expense accounts.
-Foreign suppliers (non-Estonian): check if reversed_vat_id=1 applies (reverse charge VAT).
-Bank reconciliation: reconcile_transactions first, then auto_confirm_exact_matches with dry_run before executing.
-Financial reports require all journals/invoices confirmed first for accurate results.
-Multi-company: list_connections / switch_connection. Caches cleared on switch.
-Batch operations (import, auto-confirm, recurring invoices) default to dry_run — preview before executing.
-Monetary amounts are EUR unless cl_currencies_id specifies otherwise.`,
+        instructions: `Purchase invoices:
+- Before booking, call get_vat_info to check VAT registration status.
+- Before creating, call detect_duplicate_purchase_invoice.
+- Pass original vat_price and gross_price exactly — do not recalculate.
+- Use list_purchase_articles to resolve cl_purchase_articles_id.
+- For non-Estonian suppliers, check if reverse charge applies (reversed_vat_id=1).
+- PDF flow: extract_pdf_invoice → validate_invoice_data → resolve_supplier → suggest_booking → create_purchase_invoice_from_pdf → upload_invoice_document → confirm_purchase_invoice.
+
+Bank reconciliation:
+- Run reconcile_transactions first, then auto_confirm_exact_matches with dry_run before executing.
+
+Reporting:
+- Confirm all journals/invoices/transactions first for accurate financial reports.
+- list_connections / switch_connection for multi-company; switching clears caches.
+- Batch tools default to dry_run — preview before execute=true.
+- Amounts are EUR unless cl_currencies_id specifies otherwise.`,
     });
     // --- Multi-account tools ---
     server.tool("list_connections", "List all available e-arveldaja connections (API key files). " +

package/dist/tools/account-balance.js

@@ -62,10 +62,7 @@ async function computeAccountBalance(api, accountId, clientId, dateFrom, dateTo,
     };
 }
 export function registerAccountBalanceTools(server, api) {
-    server.tool("compute_account_balance", "Compute account balance from journal postings (D/C logic). " +
-        "For liability accounts (C-type): balance = credits - debits. " +
-        "For asset accounts (D-type): balance = debits - credits. " +
-        "Can filter by client and date range.", {
+    server.tool("compute_account_balance", "Compute an account balance from journal postings, with optional client and date filters. Applies the account's debit/credit direction automatically.", {
         account_id: z.number().describe("Account number (e.g. 2110 for short-term loans)"),
         client_id: z.number().optional().describe("Filter by client ID"),
         date_from: z.string().optional().describe("Start date (YYYY-MM-DD)"),
@@ -88,12 +85,10 @@ export function registerAccountBalanceTools(server, api) {
         };
         return { content: [{ type: "text", text: JSON.stringify(summary, null, 2) }] };
     });
-    server.tool("compute_client_debt", "Compute how much the company owes to a specific client (or vice versa). " +
-        "Checks accounts 2110 (short-term loans), 2310 (accounts payable), 1210 (accounts receivable) by default. " +
-        "Override account_ids for other accounts. Uses journal D/C postings.", {
+    server.tool("compute_client_debt", "Compute how much the company owes the client and vice versa across selected accounts (default: 2110, 2310, 1210). Uses journal D/C postings.", {
         client_id: z.number().describe("Client ID"),
         account_ids: z.string().optional().describe("Comma-separated account IDs to check (default: 2110,2310,1210)"),
-    }, { ...readOnly, title: "Compute Client Debt" }, async ({ client_id, account_ids }) => {
+    }, { ...readOnly, title: "Compute Client Net Position" }, async ({ client_id, account_ids }) => {
         const ids = account_ids
             ? account_ids.split(",").map(s => parseInt(s.trim()))
             : [2110, 2310, 1210]; // short-term loans, accounts payable, accounts receivable

package/dist/tools/bank-reconciliation.js

@@ -136,11 +136,10 @@ export function registerBankReconciliationTools(server, api) {
                 }],
         };
     });
-    server.tool("auto_confirm_exact_matches", "Automatically confirm bank transactions that have a single high-confidence match (>=90). " +
-        "DRY RUN by default - set execute=true to actually confirm.", {
+    server.tool("auto_confirm_exact_matches", "Batch-confirm bank transactions with a single high-confidence match (>=90). DRY RUN by default — set execute=true to confirm.", {
         execute: z.boolean().optional().describe("Actually confirm transactions (default false = dry run)"),
         min_confidence: z.number().optional().describe("Minimum confidence (default 90)"),
-    }, { ...batch, title: "Auto-Confirm Matches" }, async ({ execute, min_confidence }) => {
+    }, { ...batch, title: "Auto-Confirm Bank Matches" }, async ({ execute, min_confidence }) => {
         const threshold = min_confidence ?? 90;
         const dryRun = execute !== true;
         // Get all unconfirmed transactions across pages

package/dist/tools/crud-tools.js

@@ -126,7 +126,7 @@ export function registerCrudTools(server, api) {
         const result = await api.clients.deactivate(id);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
     });
-    server.tool("restore_client", "Reactivate a deleted client", idParam.shape, { ...mutate, title: "Restore Client" }, async ({ id }) => {
+    server.tool("restore_client", "Reactivate a deactivated client", idParam.shape, { ...mutate, title: "Restore Client" }, async ({ id }) => {
         const result = await api.clients.restore(id);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
     });
@@ -136,9 +136,9 @@ export function registerCrudTools(server, api) {
         const results = await api.clients.findByName(name);
         return { content: [{ type: "text", text: JSON.stringify(results, null, 2) }] };
     });
-    server.tool("find_client_by_code", "Find client by registry code", {
+    server.tool("find_client_by_code", "Find a client by business registry code or personal ID", {
         code: z.string().describe("Business registry code or personal ID"),
-    }, { ...readOnly, title: "Find Client by Code" }, async ({ code }) => {
+    }, { ...readOnly, title: "Find Client by Registry Code" }, async ({ code }) => {
         const result = await api.clients.findByCode(code);
         return { content: [{ type: "text", text: result ? JSON.stringify(result, null, 2) : "Not found" }] };
     });
@@ -175,7 +175,7 @@ export function registerCrudTools(server, api) {
         const result = await api.products.deactivate(id);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
     });
-    server.tool("restore_product", "Reactivate a deleted product", idParam.shape, { ...mutate, title: "Restore Product" }, async ({ id }) => {
+    server.tool("restore_product", "Reactivate a deactivated product", idParam.shape, { ...mutate, title: "Restore Product" }, async ({ id }) => {
         const result = await api.products.restore(id);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
     });
@@ -252,7 +252,7 @@ export function registerCrudTools(server, api) {
         });
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
     });
-    server.tool("confirm_transaction", "Confirm a transaction with distribution rows", {
+    server.tool("confirm_transaction", "Confirm a bank transaction by providing distribution rows", {
         id: z.number().describe("Transaction ID"),
         distributions: z.string().optional().describe("JSON array of distribution rows: [{related_table, related_id?, amount}]"),
     }, { ...destructive, title: "Confirm Transaction" }, async ({ id, distributions }) => {
@@ -319,7 +319,7 @@ export function registerCrudTools(server, api) {
         const result = await api.saleInvoices.confirm(id);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
     });
-    server.tool("get_sale_invoice_delivery_options", "Get delivery options for a sales invoice", idParam.shape, { ...readOnly, title: "Get Delivery Options" }, async ({ id }) => {
+    server.tool("get_sale_invoice_delivery_options", "Get available delivery methods for a sales invoice (e-invoice or email)", idParam.shape, { ...readOnly, title: "Get Sale Invoice Delivery Options" }, async ({ id }) => {
         const result = await api.saleInvoices.getDeliveryOptions(id);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
     });
@@ -349,10 +349,7 @@ export function registerCrudTools(server, api) {
         const result = await api.purchaseInvoices.get(id);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
     });
-    server.tool("create_purchase_invoice", "Create a purchase invoice. Pass the EXACT vat_price and gross_price from the original invoice " +
-        "to ensure amounts match for payment reconciliation. " +
-        "Items require cl_purchase_articles_id (use list_purchase_articles). " +
-        "cl_fringe_benefits_id defaults to 1 (not a fringe benefit).", {
+    server.tool("create_purchase_invoice", "Create a draft purchase invoice with line items. Requires cl_purchase_articles_id (use list_purchase_articles). Pass EXACT vat_price and gross_price from the original invoice.", {
         clients_id: z.number().describe("Supplier client ID"),
         client_name: z.string().describe("Supplier name"),
         number: z.string().describe("Invoice number"),
@@ -399,13 +396,12 @@ export function registerCrudTools(server, api) {
         const result = await api.purchaseInvoices.delete(id);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
     });
-    server.tool("confirm_purchase_invoice", "Confirm a purchase invoice. IRREVERSIBLE — locks the invoice for editing. " +
-        "Automatically fixes vat_price/gross_price if they are missing or inconsistent with the item totals.", idParam.shape, { ...destructive, title: "Confirm Purchase Invoice" }, async ({ id }) => {
+    server.tool("confirm_purchase_invoice", "Confirm and lock a purchase invoice. Automatically fixes vat_price/gross_price if missing or inconsistent with item totals.", idParam.shape, { ...destructive, title: "Confirm Purchase Invoice" }, async ({ id }) => {
         const isVatReg = await isCompanyVatRegistered(api);
         const result = await api.purchaseInvoices.confirmWithTotals(id, isVatReg);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
     });
-    server.tool("invalidate_purchase_invoice", "Invalidate (reverse) a confirmed purchase invoice. Returns it to PROJECT status for editing.", idParam.shape, { ...mutate, title: "Invalidate Purchase Invoice" }, async ({ id }) => {
+    server.tool("invalidate_purchase_invoice", "Return a confirmed purchase invoice to draft status for editing.", idParam.shape, { ...mutate, title: "Invalidate Purchase Invoice" }, async ({ id }) => {
         const result = await api.purchaseInvoices.invalidate(id);
         return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
     });

package/dist/tools/document-audit.js

@@ -82,11 +82,11 @@ export function registerDocumentAuditTools(server, api) {
                 }],
         };
     });
-    server.tool("detect_duplicate_purchase_invoice", "Check for potential duplicate purchase invoices based on supplier, invoice number, amount, and date.", {
+    server.tool("detect_duplicate_purchase_invoice", "Check for duplicate purchase invoices by supplier + invoice number, and by supplier + amount + date.", {
         clients_id: z.number().optional().describe("Filter by supplier ID"),
         date_from: z.string().optional().describe("Start date"),
         date_to: z.string().optional().describe("End date"),
-    }, { ...readOnly, title: "Detect Duplicate Invoices" }, async ({ clients_id, date_from, date_to }) => {
+    }, { ...readOnly, title: "Detect Duplicate Purchase Invoices" }, async ({ clients_id, date_from, date_to }) => {
         const allPurchases = await api.purchaseInvoices.listAll();
         const filtered = allPurchases.filter((inv) => {
             if (inv.status === "DELETED" || inv.status === "INVALIDATED")

package/dist/tools/estonian-tax.js

@@ -48,10 +48,7 @@ async function computeRetainedEarningsBalance(api, accountId, asOfDate) {
     return roundMoney(credit - debit);
 }
 export function registerEstonianTaxTools(server, api) {
-    server.tool("prepare_dividend_package", "Calculate dividend distribution and create draft journal entries. " +
-        "Estonian CIT on dividends: 22/78 (from 2025). " +
-        "Creates a debit to retained earnings and credit to payable + tax liability. " +
-        "Validates accounts exist and checks retained earnings balance before posting.", {
+    server.tool("prepare_dividend_package", "Calculate dividend tax (22/78 CIT) and create draft journal entries for dividend payable and tax liability. Validates retained earnings balance and net assets.", {
         net_dividend: z.number().describe("Net dividend amount to shareholder (EUR)"),
         shareholder_client_id: z.number().describe("Shareholder client ID"),
         effective_date: z.string().describe("Distribution date (YYYY-MM-DD)"),
@@ -60,7 +57,7 @@ export function registerEstonianTaxTools(server, api) {
         tax_payable_account: z.number().optional().describe("CIT payable account (default 2540)"),
         share_capital_account: z.number().optional().describe("Share capital account for ÄS §157 net-assets check (default 3000)"),
         force: z.boolean().optional().describe("Create journal even if retained earnings are insufficient (default false)"),
-    }, { ...create, title: "Prepare Dividend Package" }, async ({ net_dividend, shareholder_client_id, effective_date, retained_earnings_account, dividend_payable_account, tax_payable_account, share_capital_account, force }) => {
+    }, { ...create, title: "Prepare Dividend Distribution" }, async ({ net_dividend, shareholder_client_id, effective_date, retained_earnings_account, dividend_payable_account, tax_payable_account, share_capital_account, force }) => {
         const retainedAccount = retained_earnings_account ?? 3020;
         const payableAccount = dividend_payable_account ?? 2370;
         const taxAccount = tax_payable_account ?? 2540;
@@ -172,9 +169,7 @@ export function registerEstonianTaxTools(server, api) {
                 }],
         };
     });
-    server.tool("create_owner_expense_reimbursement", "Book an owner-paid business expense: expense account + VAT + payable to owner. " +
-        "Common for micro-OÜs where the owner pays with personal funds. " +
-        "Books input VAT separately only for VAT-registered companies and validates accounts in chart of accounts.", {
+    server.tool("create_owner_expense_reimbursement", "Create a journal for a business expense paid personally by the owner. Splits input VAT for VAT-registered companies.", {
         owner_client_id: z.number().describe("Owner/shareholder client ID"),
         effective_date: z.string().describe("Expense date (YYYY-MM-DD)"),
         description: z.string().describe("Expense description"),
@@ -185,7 +180,7 @@ export function registerEstonianTaxTools(server, api) {
         vat_account: z.number().optional().describe("Input VAT account (default 1510)"),
         payable_account: z.number().optional().describe("Payable to owner account (default 2110)"),
         document_number: z.string().optional().describe("Receipt/document number"),
-    }, { ...create, title: "Book Owner Expense" }, async ({ owner_client_id, effective_date, description, net_amount, vat_rate, vat_amount, expense_account, vat_account, payable_account, document_number }) => {
+    }, { ...create, title: "Book Owner-Paid Expense" }, async ({ owner_client_id, effective_date, description, net_amount, vat_rate, vat_amount, expense_account, vat_account, payable_account, document_number }) => {
         const vatRegistered = await isCompanyVatRegistered(api);
         const vatAcc = vat_account ?? 1510;
         const payAcc = payable_account ?? 2110;

package/dist/tools/lightyear-investments.js

@@ -305,7 +305,7 @@ export function registerLightyearTools(server, api) {
         "distributions, deposits, withdrawals. Filters out BRICEKSP money market fund trades. " +
         "Pairs foreign currency trades with their FX conversion entries.", {
         file_path: z.string().describe("Absolute path to Lightyear AccountStatement CSV file"),
-    }, { ...readOnly, title: "Parse Lightyear Statement" }, async ({ file_path }) => {
+    }, { ...readOnly, title: "Parse Lightyear Account Statement" }, async ({ file_path }) => {
         const csv = await readCsvFile(file_path);
         const rows = parseAccountStatement(csv);
         const { trades, warnings: fxWarnings } = extractTrades(rows);
@@ -378,7 +378,7 @@ export function registerLightyearTools(server, api) {
     server.tool("parse_lightyear_capital_gains", "Parse a Lightyear Capital Gains Statement CSV (FIFO method). " +
         "Shows cost basis, proceeds, and realized capital gains per sale.", {
         file_path: z.string().describe("Absolute path to Lightyear CapitalGainsStatement CSV file"),
-    }, { ...readOnly, title: "Parse Capital Gains" }, async ({ file_path }) => {
+    }, { ...readOnly, title: "Parse Lightyear Capital Gains" }, async ({ file_path }) => {
         const csv = await readCsvFile(file_path);
         const gains = parseCapitalGains(csv);
         const totalGains = gains.reduce((s, g) => s + g.capital_gains_eur, 0);
@@ -661,11 +661,7 @@ export function registerLightyearTools(server, api) {
                 }],
         };
     });
-    server.tool("book_lightyear_distributions", "Create journal entries for Lightyear dividend/interest distributions. " +
-        "Checks for duplicates using reference IDs. " +
-        "Books: Debit broker account (net received), Credit income account. " +
-        "Income = gross (net + tax + fee). " +
-        "Withheld tax (tax_amount) booked to tax_account. Platform fee booked to fee_account (default 8610).", {
+    server.tool("book_lightyear_distributions", "Create journal entries for Lightyear dividend and interest distributions, including withheld tax. DRY RUN by default.", {
         file_path: z.string().describe("Absolute path to Lightyear AccountStatement CSV file"),
         broker_account: z.number().describe("Broker cash account (e.g. 1120 Lightyear konto)"),
         broker_dimension_id: z.number().optional().describe("Dimension ID for broker account (accounts_dimensions_id)"),
@@ -789,9 +785,7 @@ export function registerLightyearTools(server, api) {
                 }],
         };
     });
-    server.tool("lightyear_portfolio_summary", "Compute current portfolio holdings and cost basis from Lightyear account statement. " +
-        "Uses weighted average cost method. Properly reduces cost basis on sells. " +
-        "Useful for verifying investment account balance.", {
+    server.tool("lightyear_portfolio_summary", "Compute current holdings and cost basis from a Lightyear account statement. Useful for verifying investment account balance.", {
         file_path: z.string().describe("Absolute path to Lightyear AccountStatement CSV file"),
     }, { ...readOnly, title: "Lightyear Portfolio Summary" }, async ({ file_path }) => {
         const csv = await readCsvFile(file_path);

package/dist/tools/pdf-workflow.js

@@ -46,12 +46,9 @@ function extractPdfHints(text) {
     return result;
 }
 export function registerPdfWorkflowTools(server, api) {
-    server.tool("extract_pdf_invoice", "Extract text and machine-readable identifiers from a PDF invoice. " +
-        "Returns raw text + detected IBAN, registry code, VAT number, reference number. " +
-        "YOU must read the raw_text and extract: supplier name, invoice number, dates, " +
-        "amounts (net, VAT, gross), and line items. Then call validate_invoice_data to verify.", {
+    server.tool("extract_pdf_invoice", "Extract text and key identifiers from a supplier invoice PDF. Returns raw text + detected IBAN, registry code, VAT number, reference number. Read raw_text to extract all invoice fields, then call validate_invoice_data.", {
         file_path: z.string().describe("Absolute path to the PDF file"),
-    }, { ...readOnly, title: "Extract PDF Invoice" }, async ({ file_path }) => {
+    }, { ...readOnly, title: "Extract Supplier Invoice PDF" }, async ({ file_path }) => {
         const resolved = await validatePdfPath(file_path);
         const buffer = await readFile(resolved);
         const pdfData = await pdf(buffer);
@@ -187,9 +184,7 @@ export function registerPdfWorkflowTools(server, api) {
                 }],
         };
     });
-    server.tool("resolve_supplier", "Find or create a supplier in e-arveldaja. First searches by registry code, " +
-        "then VAT number, then name (fuzzy). If not found, optionally creates a new client. " +
-        "Also looks up business registry (äriregister) data if available.", {
+    server.tool("resolve_supplier", "Match a supplier to an existing client by registry code, VAT number, or name (fuzzy). Optionally creates a new client. Looks up Estonian business registry data.", {
         name: z.string().optional().describe("Supplier name from invoice"),
         reg_code: z.string().optional().describe("Registry code (registrikood)"),
         vat_no: z.string().optional().describe("VAT number (KMKR)"),
@@ -197,7 +192,7 @@ export function registerPdfWorkflowTools(server, api) {
         auto_create: z.boolean().optional().describe("Create client if not found (default false)"),
         country: z.string().optional().describe("Country code for auto-create (default EST)"),
         is_physical_entity: z.boolean().optional().describe("Natural person (default false = legal entity)"),
-    }, { ...create, title: "Resolve Supplier" }, async ({ name, reg_code, vat_no, iban, auto_create, country, is_physical_entity }) => {
+    }, { ...create, title: "Find or Create Supplier" }, async ({ name, reg_code, vat_no, iban, auto_create, country, is_physical_entity }) => {
         // 1. Search by registry code
         if (reg_code) {
             const byCode = await api.clients.findByCode(reg_code);
@@ -308,12 +303,11 @@ export function registerPdfWorkflowTools(server, api) {
                 }],
         };
     });
-    server.tool("suggest_booking", "Find similar past purchase invoices from the same supplier to suggest " +
-        "how to book a new invoice (which accounts, articles, etc).", {
+    server.tool("suggest_booking", "Suggest purchase articles and accounts for a new invoice based on similar confirmed invoices from the same supplier.", {
         clients_id: z.number().describe("Supplier client ID"),
         description: z.string().optional().describe("Invoice item description to match"),
         limit: z.number().optional().describe("Max past invoices to return (default 3)"),
-    }, { ...readOnly, title: "Suggest Booking" }, async ({ clients_id, description, limit }) => {
+    }, { ...readOnly, title: "Suggest Purchase Booking" }, async ({ clients_id, description, limit }) => {
         const maxResults = limit ?? 3;
         const allInvoices = await api.purchaseInvoices.listAll();
         // Filter by supplier
@@ -364,9 +358,7 @@ export function registerPdfWorkflowTools(server, api) {
                 }],
         };
     });
-    server.tool("create_purchase_invoice_from_pdf", "Full workflow: create a purchase invoice from extracted PDF data. " +
-        "Resolves supplier, suggests booking, creates the invoice as DRAFT. " +
-        "Pass EXACT vat_price and gross_price from the original invoice for payment matching.", {
+    server.tool("create_purchase_invoice_from_pdf", "Create a draft purchase invoice from extracted and validated PDF data. Pass EXACT vat_price and gross_price from the original invoice for payment matching.", {
         supplier_client_id: z.number().describe("Supplier client ID (from resolve_supplier)"),
         invoice_number: z.string().describe("Invoice number"),
         invoice_date: z.string().describe("Invoice date (YYYY-MM-DD)"),
@@ -379,7 +371,7 @@ export function registerPdfWorkflowTools(server, api) {
         notes: z.string().optional().describe("Notes (e.g. PDF filename)"),
         ref_number: z.string().optional().describe("Reference number"),
         bank_account_no: z.string().optional().describe("Supplier bank account"),
-    }, { ...create, title: "Create Invoice from PDF" }, async (params) => {
+    }, { ...create, title: "Create Purchase Invoice from PDF" }, async (params) => {
         const supplier = await api.clients.get(params.supplier_client_id);
         const isVatReg = await isCompanyVatRegistered(api);
         const purchaseArticles = await getPurchaseArticlesWithVat(api);
@@ -413,7 +405,7 @@ export function registerPdfWorkflowTools(server, api) {
     server.tool("upload_invoice_document", "Upload a PDF document to an existing purchase invoice", {
         invoice_id: z.number().describe("Purchase invoice ID"),
         file_path: z.string().describe("Absolute path to the PDF file"),
-    }, { ...mutate, title: "Upload Invoice Document" }, async ({ invoice_id, file_path }) => {
+    }, { ...mutate, title: "Upload Purchase Invoice PDF" }, async ({ invoice_id, file_path }) => {
         const resolved = await validatePdfPath(file_path);
         const buffer = await readFile(resolved);
         const base64 = buffer.toString("base64");

package/dist/tools/recurring-invoices.js

@@ -9,7 +9,7 @@ export function registerRecurringInvoiceTools(server, api) {
         target_journal_date: z.string().describe("New turnover date (YYYY-MM-DD)"),
         invoice_ids: z.string().optional().describe("Comma-separated source invoice IDs to copy (default: all confirmed from source month)"),
         auto_confirm: z.boolean().optional().describe("Confirm created invoices (default false)"),
-    }, { ...batch, title: "Create Recurring Invoices" }, async ({ source_month, target_date, target_journal_date, invoice_ids, auto_confirm }) => {
+    }, { ...batch, title: "Create Recurring Sale Invoices" }, async ({ source_month, target_date, target_journal_date, invoice_ids, auto_confirm }) => {
         // Get source invoices
         const allSales = await api.saleInvoices.listAll();
         const sourceFrom = `${source_month}-01`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "e-arveldaja-mcp",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "MCP server for Estonian e-arveldaja (e-Financials) API",
   "type": "module",
   "main": "dist/index.js",