@codemill-solutions/yuki-mcp 1.1.0 → 1.2.0

package/README.md

@@ -89,13 +89,14 @@ Add to your MCP host configuration (e.g. `claude_desktop_config.json`):
 
 ---
 
-## Available tools
+## Available tools (29)
 
 ### Administrations
 
 | Tool | Description |
 |------|-------------|
 | `get_administrations` | List all administrations (companies) for this API key. **Run this first** to find the correct `administrationId`. |
+| `get_administration_id` | Look up an administration's GUID by its exact name. Useful when you know the name but not the GUID. |
 
 ### Relations
 
@@ -130,7 +131,21 @@ Add to your MCP host configuration (e.g. `claude_desktop_config.json`):
 
 | Tool | Key parameters | Description |
 |------|----------------|-------------|
-| `get_gl_accounts` | `date?` | Retrieve all GL accounts with their balance at a given date. Use this to find bank account codes before calling `get_transactions`. |
+| `get_gl_accounts` | `date?` | Retrieve all GL accounts with their balance at a given date (commercial view). Use this to find account codes before calling `get_transactions`. |
+| `get_gl_accounts_fiscal` | `date?` | Same as `get_gl_accounts` but including fiscal corrections. Use for balance sheets and P&L views that must match Yuki's fiscal reports. |
+| `get_net_revenue` | `startDate`, `endDate`, `fiscal?` | Retrieve net revenue (netto-omzet) for a date range. Set `fiscal=true` to include fiscal corrections. |
+
+### Accounting info
+
+Richer read-only views from the `AccountingInfo.asmx` service — not available through the standard `Accounting.asmx`.
+
+| Tool | Key parameters | Description |
+|------|----------------|-------------|
+| `get_gl_account_scheme` | — | Retrieve the complete GL account scheme (rekeningschema): all codes with type, subtype, description, and active/inactive status. Use to validate GL codes or build account pickers. |
+| `get_period_table` | `yearId` | Retrieve the fiscal period table for a year: period numbers, names, and date ranges. Use to translate transaction dates into human-readable period names for reports. |
+| `get_gl_transactions_detailed` | `startDate`, `endDate`, `glAccountCode?`, `financialMode?` | Detailed transaction listing with document type, archive folder, fiscal period ID, project code, and mutation user. More complete than `get_transactions`. Leave `glAccountCode` empty for all accounts. |
+| `get_transaction_document` | `transactionId` | Download the source PDF for a booked transaction as base64. Use the `id` or `hID` from `get_gl_transactions_detailed`. |
+| `get_start_balances` | `yearId`, `financialMode?` | Retrieve opening balances (beginbalansen) per GL account for a fiscal year. |
 
 ### Documents
 
@@ -139,6 +154,11 @@ Add to your MCP host configuration (e.g. `claude_desktop_config.json`):
 | `upload_document` | `fileName`, `dataBase64`, `folder?`, `amount?` | Upload a PDF to the Yuki archive by passing its content as a base64 string. Use `get_document_folders` first to find the right folder ID. |
 | `upload_document_from_path` | `filePath`, `fileName?`, `folder?`, `amount?` | Upload a PDF from a local file path. Reads and encodes the file internally — preferred over `upload_document` when the file is available on disk. Validates that the file exists and is a valid PDF before uploading. |
 | `get_document_folders` | — | List all archive folders available in the administration. |
+| `list_documents` | `folderId` | List documents in a specific archive folder. Returns document IDs, file names, dates, and amounts. |
+| `search_documents` | `searchText` | Full-text search across all archived documents (file names, amounts, OCR content). |
+| `get_document` | `documentId` | Retrieve metadata for a single archived document by its ID (name, folder, date, amount, status). |
+| `download_document` | `documentId` | Download an archived document as a base64-encoded string. |
+| `get_cost_categories` | — | List available GL cost categories for use as the `costCategory` parameter in upload tools. |
 
 ### Backoffice
 
@@ -188,20 +208,25 @@ Available scenarios: `get-administrations`, `search-relations`, `outstanding-inv
 
 ```
 src/
-├── index.ts              # Entry point — loads env, registers tools, starts stdio transport
-├── yuki-client.ts        # SOAP client: envelope builder, axios HTTP, fast-xml-parser, XmlValue
+├── index.ts                  # Entry point — loads env, registers tools, starts stdio transport
+├── yuki-client.ts            # SOAP client: envelope builder, axios HTTP, fast-xml-parser, XmlValue
 └── tools/
-    ├── administrations.ts  # get_administrations
-    ├── relations.ts        # search_relations, upsert_contact
-    ├── invoices.ts         # get_sales_invoices, get_purchase_invoices,
-    │                       # process_sales_invoice, process_purchase_invoice
-    ├── transactions.ts     # get_transactions, get_transaction_details, process_journal
-    ├── accounting.ts       # get_gl_accounts
-    ├── documents.ts        # upload_document, upload_document_from_path, get_document_folders
-    └── backoffice.ts       # get_workflow, get_outstanding_questions
+    ├── administrations.ts    # get_administrations, get_administration_id
+    ├── relations.ts          # search_relations, upsert_contact
+    ├── invoices.ts           # get_sales_invoices, get_purchase_invoices,
+    │                         # process_sales_invoice, process_purchase_invoice
+    ├── transactions.ts       # get_transactions, get_transaction_details, process_journal
+    ├── accounting.ts         # get_gl_accounts, get_gl_accounts_fiscal, get_net_revenue
+    ├── accounting-info.ts    # get_gl_account_scheme, get_period_table,
+    │                         # get_gl_transactions_detailed, get_transaction_document,
+    │                         # get_start_balances
+    ├── documents.ts          # upload_document, upload_document_from_path,
+    │                         # get_document_folders, list_documents, search_documents,
+    │                         # get_document, download_document, get_cost_categories
+    └── backoffice.ts         # get_workflow, get_outstanding_questions
 
 scripts/
-└── test-agent.ts         # Agent test harness (Claude + MCP client loop)
+└── test-agent.ts             # Agent test harness (Claude + MCP client loop)
 ```
 
 ### Auth flow
@@ -213,7 +238,7 @@ Yuki uses a two-step authentication pattern:
 
 `YukiClient.getSessionID()` handles this transparently and caches the session for the lifetime of the process.
 
-> **Note:** Parameter casing differs across Yuki's services — `sessionId` (lowercase d) on `Sales.asmx` and `Purchase.asmx`; `sessionID` (uppercase D) on `Accounting.asmx`, `Contact.asmx`, and `Archive.asmx`. This is handled per-tool.
+> **Note:** Parameter casing differs across Yuki's services — `sessionId` (lowercase d) on `Sales.asmx` and `Purchase.asmx`; `sessionID` (uppercase D) on `Accounting.asmx`, `AccountingInfo.asmx`, `Contact.asmx`, and `Archive.asmx`. This is handled per-tool.
 
 ### XML documents
 
@@ -223,7 +248,7 @@ Write tools (`process_sales_invoice`, `process_purchase_invoice`, `process_journ
 
 ## Rate limits
 
-Yuki enforces **1,000 API requests per day**. Each tool call is 1 request. The session ID is cached so `Authenticate` is only called once per server process, not once per tool call.
+Yuki enforces **1,000 API requests per day** (upgradeable to 5,000–10,000). Each tool call is 1 request. The session ID is cached so `Authenticate` is only called once per server process, not once per tool call.
 
 Design agent workflows to fetch broad lists once and reference them from the agent's context window rather than re-fetching on every step.
 
@@ -243,6 +268,25 @@ Design agent workflows to fetch broad lists once and reference them from the age
 
 ---
 
+## About CodeMill Solutions
+
+[CodeMill Solutions](https://codemill.dev/en/) is a Dutch software company based in the Netherlands. We build smart, scalable, and customized solutions that help organizations grow, optimize processes, and realize their digital ambitions.
+
+Our services include:
+
+- **Custom applications** — portals, dashboards, business software, and fully tailored platforms that truly add value.
+- **API integrations** — connecting your application with other systems and external platforms via smart API connections.
+- **Mobile apps** — iOS and Android apps as a logical extension of your web application(s).
+
+`yuki-mcp` is one of our open-source integrations, making Yuki's accounting platform accessible to AI agents through the Model Context Protocol.
+
+📧 [info@codemill.dev](mailto:info@codemill.dev)  
+🌐 [codemill.dev](https://codemill.dev/en/)  
+💼 [LinkedIn](https://www.linkedin.com/company/codemill-solutions/)  
+🐙 [GitHub](https://github.com/CodeMill-Solutions)
+
+---
+
 ## License
 
 MIT — see [LICENSE](./LICENSE).

package/dist/index.js

@@ -3,11 +3,12 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { YukiClient } from './yuki-client.js';
 // Read tools
-import { registerAdministrationTools } from './tools/administrations.js';
+import { registerAdministrationTools, registerAdministrationLookupTools } from './tools/administrations.js';
 import { registerRelationTools } from './tools/relations.js';
 import { registerInvoiceTools } from './tools/invoices.js';
 import { registerTransactionTools } from './tools/transactions.js';
-import { registerAccountingTools } from './tools/accounting.js';
+import { registerAccountingTools, registerAccountingExtendedTools } from './tools/accounting.js';
+import { registerAccountingInfoTools } from './tools/accounting-info.js';
 // Write tools
 import { registerInvoiceWriteTools } from './tools/invoices.js';
 import { registerJournalWriteTools } from './tools/transactions.js';
@@ -29,14 +30,17 @@ const yukiClient = new YukiClient(apiKey, domainId);
 // ── MCP server ────────────────────────────────────────────────────────────────
 const server = new McpServer({
     name: 'yuki-mcp',
-    version: '1.0.0',
+    version: '1.2.0',
 });
 // ── Read tools ────────────────────────────────────────────────────────────────
 registerAdministrationTools(server, yukiClient);
+registerAdministrationLookupTools(server, yukiClient);
 registerRelationTools(server, yukiClient);
 registerInvoiceTools(server, yukiClient);
 registerTransactionTools(server, yukiClient);
 registerAccountingTools(server, yukiClient);
+registerAccountingExtendedTools(server, yukiClient);
+registerAccountingInfoTools(server, yukiClient);
 // ── Write tools ───────────────────────────────────────────────────────────────
 registerInvoiceWriteTools(server, yukiClient);
 registerJournalWriteTools(server, yukiClient);
@@ -48,6 +52,6 @@ registerBackofficeTools(server, yukiClient);
 const transport = new StdioServerTransport();
 await server.connect(transport);
 // Log startup info to stderr only (stdout is reserved for JSON-RPC)
-process.stderr.write(`[yuki-mcp] Server started — 16 tools registered. ` +
+process.stderr.write(`[yuki-mcp] Server started — 29 tools registered. ` +
     `Domain ID: ${domainId || '(none — run get_administrations to discover)'}\n`);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,aAAa;AACb,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,cAAc;AACd,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,mBAAmB;AACnB,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,iFAAiF;AAEjF,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AAC3C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;AAErD,IAAI,CAAC,MAAM,EAAE,CAAC;IACZ,6EAA6E;IAC7E,sDAAsD;IACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mEAAmE,CAAC,CAAC;IAC1F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,iFAAiF;AAEjF,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAEpD,iFAAiF;AAEjF,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,iFAAiF;AACjF,2BAA2B,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAChD,qBAAqB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAC1C,oBAAoB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACzC,wBAAwB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAC7C,uBAAuB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAE5C,iFAAiF;AACjF,yBAAyB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAC9C,yBAAyB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAC9C,yBAAyB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAC9C,qBAAqB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAE1C,iFAAiF;AACjF,uBAAuB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAE5C,iFAAiF;AAEjF,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAEhC,oEAAoE;AACpE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,mDAAmD;IACjD,cAAc,QAAQ,IAAI,8CAA8C,IAAI,CAC/E,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAC;AACvB,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,aAAa;AACb,OAAO,EAAE,2BAA2B,EAAE,iCAAiC,EAAE,MAAM,4BAA4B,CAAC;AAC5G,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,+BAA+B,EAAE,MAAM,uBAAuB,CAAC;AACjG,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AAEzE,cAAc;AACd,OAAO,EAAE,yBAAyB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,mBAAmB;AACnB,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,iFAAiF;AAEjF,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AAC3C,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;AAErD,IAAI,CAAC,MAAM,EAAE,CAAC;IACZ,6EAA6E;IAC7E,sDAAsD;IACtD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mEAAmE,CAAC,CAAC;IAC1F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,iFAAiF;AAEjF,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AAEpD,iFAAiF;AAEjF,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,iFAAiF;AACjF,2BAA2B,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAChD,iCAAiC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACtD,qBAAqB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAC1C,oBAAoB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACzC,wBAAwB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAC7C,uBAAuB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAC5C,+BAA+B,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACpD,2BAA2B,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAEhD,iFAAiF;AACjF,yBAAyB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAC9C,yBAAyB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAC9C,yBAAyB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAC9C,qBAAqB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAE1C,iFAAiF;AACjF,uBAAuB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAE5C,iFAAiF;AAEjF,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAE7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAEhC,oEAAoE;AACpE,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,mDAAmD;IACjD,cAAc,QAAQ,IAAI,8CAA8C,IAAI,CAC/E,CAAC"}

package/dist/tools/accounting-info.d.ts

@@ -0,0 +1,19 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { YukiClient } from '../yuki-client.js';
+/**
+ * Register tools for the Yuki AccountingInfo service.
+ *
+ * AccountingInfo.asmx provides richer read-only views of accounting data
+ * that are not available through the main Accounting.asmx service:
+ *
+ *   - Full GL account scheme (codes, types, subtypes, active/inactive)
+ *   - Fiscal period table (period names and date ranges per year)
+ *   - Detailed transaction listing (includes document type, folder, period, project)
+ *   - Transaction document download (retrieve the source PDF as base64)
+ *   - Opening balances per GL account per fiscal year
+ *
+ * Yuki service: AccountingInfo.asmx
+ * Note: uses sessionID / administrationID (uppercase D), same as Accounting.asmx.
+ */
+export declare function registerAccountingInfoTools(server: McpServer, client: YukiClient): void;
+//# sourceMappingURL=accounting-info.d.ts.map

package/dist/tools/accounting-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounting-info.d.ts","sourceRoot":"","sources":["../../src/tools/accounting-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAsXvF"}

package/dist/tools/accounting-info.js

@@ -0,0 +1,366 @@
+import { z } from 'zod';
+/**
+ * Register tools for the Yuki AccountingInfo service.
+ *
+ * AccountingInfo.asmx provides richer read-only views of accounting data
+ * that are not available through the main Accounting.asmx service:
+ *
+ *   - Full GL account scheme (codes, types, subtypes, active/inactive)
+ *   - Fiscal period table (period names and date ranges per year)
+ *   - Detailed transaction listing (includes document type, folder, period, project)
+ *   - Transaction document download (retrieve the source PDF as base64)
+ *   - Opening balances per GL account per fiscal year
+ *
+ * Yuki service: AccountingInfo.asmx
+ * Note: uses sessionID / administrationID (uppercase D), same as Accounting.asmx.
+ */
+export function registerAccountingInfoTools(server, client) {
+    // ── get_gl_account_scheme ────────────────────────────────────────────────────
+    /**
+     * get_gl_account_scheme
+     *
+     * Retrieve the complete GL account scheme (rekeningschema) for an
+     * administration: all account codes with their type, subtype, and
+     * active/inactive status.
+     *
+     * Use this instead of get_gl_accounts when you need the full account
+     * definition (type, subtype, enabled flag) rather than current balances.
+     * Useful for building GL account pickers, validating codes before booking,
+     * or understanding the chart-of-accounts structure.
+     *
+     * Rate cost: 1 request.
+     */
+    server.registerTool('get_gl_account_scheme', {
+        description: 'Retrieve the complete GL account scheme (rekeningschema) for an administration. ' +
+            'Returns every account code with its type, subtype, description, and active/inactive status. ' +
+            'Use this to validate GL codes before booking or to build account pickers. ' +
+            'For current balances use get_gl_accounts instead.',
+        inputSchema: {
+            administrationId: z
+                .string()
+                .optional()
+                .describe('Administration ID (GUID). Defaults to YUKI_DOMAIN_ID env var.'),
+        },
+    }, async ({ administrationId }) => {
+        try {
+            const adminId = administrationId ?? client.defaultDomainId;
+            if (!adminId)
+                throw new Error('administrationId is required (or set YUKI_DOMAIN_ID env var)');
+            const sessionID = await client.getSessionID();
+            const result = await client.callSoap({
+                service: 'AccountingInfo.asmx',
+                method: 'GetGLAccountScheme',
+                params: { sessionID, administrationID: adminId },
+            });
+            const accounts = normalizeList(result, ['GLAccounts', 'Accounts'], ['GLAccount', 'Account', 'Row']);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ success: true, count: accounts.length, accounts }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return errorResponse(err);
+        }
+    });
+    // ── get_period_table ─────────────────────────────────────────────────────────
+    /**
+     * get_period_table
+     *
+     * Retrieve the fiscal period table for a given year: period names, numbers,
+     * and the date range each period covers.
+     *
+     * This is essential for Theun's depreciation and salary reports, which need
+     * to display "the last period in which a booking was made" in human-readable
+     * form (e.g. "Periode 3 · maart 2025") rather than a raw date.
+     *
+     * Use the returned period names to annotate gl_balances and
+     * workflow_snapshots in the monorepo dashboard.
+     *
+     * Rate cost: 1 request.
+     */
+    server.registerTool('get_period_table', {
+        description: 'Retrieve the fiscal period table (periodeoverzicht) for a given fiscal year. ' +
+            'Returns period numbers, names, and start/end dates. ' +
+            'Use this to translate a transaction date into a period name for reports ' +
+            '(e.g. "tot welke periode zijn afschrijvingen verwerkt").',
+        inputSchema: {
+            yearId: z
+                .number()
+                .int()
+                .describe('Fiscal year as a 4-digit integer (e.g. 2025).'),
+            administrationId: z
+                .string()
+                .optional()
+                .describe('Administration ID (GUID). Defaults to YUKI_DOMAIN_ID env var.'),
+        },
+    }, async ({ yearId, administrationId }) => {
+        try {
+            const adminId = administrationId ?? client.defaultDomainId;
+            if (!adminId)
+                throw new Error('administrationId is required (or set YUKI_DOMAIN_ID env var)');
+            const sessionID = await client.getSessionID();
+            const result = await client.callSoap({
+                service: 'AccountingInfo.asmx',
+                method: 'GetPeriodDateTable',
+                params: { sessionID, administrationID: adminId, yearID: yearId },
+            });
+            const periods = normalizeList(result, ['Periods', 'AdministrationPeriods'], ['Period', 'AdministrationPeriod', 'Row']);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ success: true, yearId, count: periods.length, periods }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return errorResponse(err);
+        }
+    });
+    // ── get_gl_transactions_detailed ────────────────────────────────────────────
+    /**
+     * get_gl_transactions_detailed
+     *
+     * Retrieve a detailed transaction listing for a GL account (or all accounts)
+     * within a date range. Returns richer data than get_transactions:
+     * document type, archive folder, fiscal period ID, project code,
+     * mutation user, and company name.
+     *
+     * Use this when you need to determine *when* a specific type of booking
+     * (e.g. depreciation, salary journal) was last made on an account, or
+     * when you need to link a transaction back to its source document.
+     *
+     * financialMode: '1' = fiscal (default, matches Yuki's fiscal year),
+     *                '0' = commercial (calendar year).
+     *
+     * Rate cost: 1 request.
+     */
+    server.registerTool('get_gl_transactions_detailed', {
+        description: 'Retrieve detailed transaction data for a GL account within a date range. ' +
+            'Returns richer fields than get_transactions: document type, archive folder, ' +
+            'fiscal period ID, project code, and mutation user. ' +
+            'Leave glAccountCode empty to fetch all accounts. ' +
+            'Use this to find the last period in which a depreciation or salary booking was made.',
+        inputSchema: {
+            startDate: z.string().describe('Start date in YYYY-MM-DD format (inclusive)'),
+            endDate: z.string().describe('End date in YYYY-MM-DD format (inclusive)'),
+            glAccountCode: z
+                .string()
+                .optional()
+                .describe('GL account code to filter (e.g. "0300" for depreciation). Leave empty for all accounts.'),
+            financialMode: z
+                .enum(['0', '1'])
+                .optional()
+                .default('1')
+                .describe("Financial mode: '1' = fiscal (default), '0' = commercial."),
+            administrationId: z
+                .string()
+                .optional()
+                .describe('Administration ID (GUID). Defaults to YUKI_DOMAIN_ID env var.'),
+        },
+    }, async ({ startDate, endDate, glAccountCode, financialMode, administrationId }) => {
+        try {
+            const adminId = administrationId ?? client.defaultDomainId;
+            if (!adminId)
+                throw new Error('administrationId is required (or set YUKI_DOMAIN_ID env var)');
+            const sessionID = await client.getSessionID();
+            const result = await client.callSoap({
+                service: 'AccountingInfo.asmx',
+                method: 'GetTransactionDetails',
+                params: {
+                    sessionID,
+                    administrationID: adminId,
+                    GLAccountCode: glAccountCode ?? '',
+                    StartDate: startDate,
+                    EndDate: endDate,
+                    financialMode: financialMode ?? '1',
+                },
+            });
+            const transactions = normalizeList(result, ['TransactionInfos', 'Transactions'], ['TransactionInfo', 'Transaction', 'Row']);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: true,
+                            count: transactions.length,
+                            period: { startDate, endDate },
+                            glAccountCode: glAccountCode ?? '(all)',
+                            financialMode,
+                            transactions,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return errorResponse(err);
+        }
+    });
+    // ── get_transaction_document ─────────────────────────────────────────────────
+    /**
+     * get_transaction_document
+     *
+     * Download the source document (PDF) associated with a transaction in Yuki,
+     * returned as a base64-encoded string.
+     *
+     * Use the transactionId from a get_gl_transactions_detailed response (the `id`
+     * or `hID` field). Useful for retrieving the original invoice PDF from a
+     * booked transaction for verification or re-archival.
+     *
+     * Rate cost: 1 request.
+     */
+    server.registerTool('get_transaction_document', {
+        description: 'Download the source document (PDF) for a booked transaction, returned as base64. ' +
+            'Use the transaction ID from get_gl_transactions_detailed. ' +
+            'Returns fileName and base64-encoded fileData.',
+        inputSchema: {
+            transactionId: z
+                .string()
+                .describe('Transaction ID (from the id or hID field in get_gl_transactions_detailed).'),
+            administrationId: z
+                .string()
+                .optional()
+                .describe('Administration ID (GUID). Defaults to YUKI_DOMAIN_ID env var.'),
+        },
+    }, async ({ transactionId, administrationId }) => {
+        try {
+            const adminId = administrationId ?? client.defaultDomainId;
+            if (!adminId)
+                throw new Error('administrationId is required (or set YUKI_DOMAIN_ID env var)');
+            const sessionID = await client.getSessionID();
+            const result = await client.callSoap({
+                service: 'AccountingInfo.asmx',
+                method: 'GetTransactionDocument',
+                params: { sessionID, administrationID: adminId, transactionID: transactionId },
+            });
+            // Result shape: { fileName: string, filedata: string (base64) }
+            const doc = result;
+            const fileName = doc['fileName'] ?? doc['FileName'] ?? null;
+            const fileData = doc['filedata'] ?? doc['fileData'] ?? doc['FileData'] ?? null;
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            success: true,
+                            transactionId,
+                            fileName,
+                            fileDataBase64: fileData,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return errorResponse(err);
+        }
+    });
+    // ── get_start_balances ───────────────────────────────────────────────────────
+    /**
+     * get_start_balances
+     *
+     * Retrieve the opening balances (beginbalansen) per GL account for a
+     * specific fiscal year.
+     *
+     * Use this when building year-over-year comparisons or verifying that
+     * opening entries match the closing balances of the prior year.
+     *
+     * financialMode: '1' = fiscal (default), '0' = commercial.
+     *
+     * Rate cost: 1 request.
+     */
+    server.registerTool('get_start_balances', {
+        description: 'Retrieve opening balances (beginbalansen) per GL account for a fiscal year. ' +
+            'Returns accountID, accountDescription, and startBalance for each GL account. ' +
+            'Use this for year-over-year balance verification.',
+        inputSchema: {
+            yearId: z
+                .number()
+                .int()
+                .describe('Fiscal year as a 4-digit integer (e.g. 2025).'),
+            financialMode: z
+                .enum(['0', '1'])
+                .optional()
+                .default('1')
+                .describe("Financial mode: '1' = fiscal (default), '0' = commercial."),
+            administrationId: z
+                .string()
+                .optional()
+                .describe('Administration ID (GUID). Defaults to YUKI_DOMAIN_ID env var.'),
+        },
+    }, async ({ yearId, financialMode, administrationId }) => {
+        try {
+            const adminId = administrationId ?? client.defaultDomainId;
+            if (!adminId)
+                throw new Error('administrationId is required (or set YUKI_DOMAIN_ID env var)');
+            const sessionID = await client.getSessionID();
+            const result = await client.callSoap({
+                service: 'AccountingInfo.asmx',
+                method: 'GetStartBalanceByGLAccount',
+                params: {
+                    sessionID,
+                    administrationID: adminId,
+                    yearID: yearId,
+                    financialMode: financialMode ?? '1',
+                },
+            });
+            const balances = normalizeList(result, ['StartBalances', 'AccountStartBalances'], ['StartBalance', 'AccountStartBalance', 'Row']);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({ success: true, yearId, financialMode, count: balances.length, balances }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return errorResponse(err);
+        }
+    });
+}
+// ── Shared helpers ─────────────────────────────────────────────────────────────
+/** Generic list normaliser: tries wrapper tags then item tags, falls back to raw. */
+function normalizeList(result, wrappers, itemTags) {
+    if (!result)
+        return [];
+    if (Array.isArray(result))
+        return result;
+    const rec = result;
+    for (const wrapper of wrappers) {
+        const c = rec[wrapper];
+        if (!c)
+            continue;
+        if (Array.isArray(c))
+            return c;
+        const inner = c;
+        for (const tag of itemTags) {
+            if (Array.isArray(inner[tag]))
+                return inner[tag];
+            if (inner[tag])
+                return [inner[tag]];
+        }
+    }
+    for (const tag of itemTags) {
+        if (Array.isArray(rec[tag]))
+            return rec[tag];
+        if (rec[tag])
+            return [rec[tag]];
+    }
+    return [result];
+}
+/** Uniform error response shape. */
+function errorResponse(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+        content: [{ type: 'text', text: JSON.stringify({ success: false, error: message }, null, 2) }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=accounting-info.js.map

package/dist/tools/accounting-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounting-info.js","sourceRoot":"","sources":["../../src/tools/accounting-info.ts"],"names":[],"mappings":"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"}

package/dist/tools/accounting.d.ts

@@ -10,4 +10,10 @@ import { YukiClient } from '../yuki-client.js';
  * Method:       GLAccountBalance(sessionID, administrationID, transactionDate)
  */
 export declare function registerAccountingTools(server: McpServer, client: YukiClient): void;
+/**
+ * Register additional accounting tools (fiscal variants and revenue).
+ * Called separately from registerAccountingTools so each can be exported
+ * and imported individually if needed.
+ */
+export declare function registerAccountingExtendedTools(server: McpServer, client: YukiClient): void;
 //# sourceMappingURL=accounting.d.ts.map

package/dist/tools/accounting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"accounting.d.ts","sourceRoot":"","sources":["../../src/tools/accounting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAoFnF"}
+{"version":3,"file":"accounting.d.ts","sourceRoot":"","sources":["../../src/tools/accounting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAoFnF;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CA2I3F"}