@codemill-solutions/yuki-mcp 1.0.0

package/dist/tools/documents.js

@@ -0,0 +1,269 @@
+import { z } from "zod";
+import { readFileSync, existsSync } from "fs";
+import { basename } from "path";
+/**
+ * Register tools for uploading documents to the Yuki archive.
+ *
+ * The Yuki Archive service stores source documents (PDFs) alongside
+ * their financial data. Attaching a PDF to a purchase invoice is
+ * strongly recommended for audit compliance.
+ *
+ * Yuki service: Archive.asmx
+ * Method:       UploadDocumentWithData(sessionID, fileName, data, folder,
+ *                                      administrationID, currency, amount,
+ *                                      costCategory, paymentMethod, project, remarks)
+ *
+ * Note: Archive.asmx uses sessionID / administrationID (uppercase D).
+ */
+export function registerDocumentTools(server, client) {
+    /**
+     * upload_document
+     *
+     * Upload a PDF (or other document) to the Yuki archive with optional
+     * financial metadata. This is the recommended way to attach source
+     * documents to purchase invoices in Yuki.
+     *
+     * Use this when:
+     *   - A purchase invoice PDF needs to be stored in Yuki's archive
+     *   - You want Yuki to process the document automatically (OCR)
+     *   - Attaching supporting documents (receipts, bank statements) to bookings
+     *
+     * Folder IDs (use get_document_folders to retrieve the full list):
+     *   - Common folders: purchase invoices, bank statements, general
+     *
+     * Rate cost: 1 request.
+     */
+    server.registerTool("upload_document", {
+        description: "Upload a document (PDF) to the Yuki archive with financial metadata. " +
+            "Use this to attach source documents to purchase invoices or store receipts. " +
+            "The document must be provided as a base64-encoded string. " +
+            "Call get_document_folders first to find the correct folder ID.",
+        inputSchema: {
+            fileName: z.string()
+                .describe("File name including extension (e.g. 'invoice-2024-0042.pdf')"),
+            dataBase64: z.string()
+                .describe("File content encoded as a base64 string"),
+            folder: z.number().int().optional()
+                .describe("Archive folder ID. Use get_document_folders to list available folders."),
+            currency: z.string().optional().default("EUR")
+                .describe("ISO 4217 currency code for the document amount"),
+            amount: z.number().optional()
+                .describe("Total amount on the document (e.g. invoice total including VAT)"),
+            costCategory: z.string().optional()
+                .describe("GL account code for automatic cost categorisation (e.g. '4000')"),
+            paymentMethod: z.number().int().optional()
+                .describe("Payment method code. 0 = unknown, 1 = transfer, 2 = direct collection"),
+            project: z.string().optional()
+                .describe("Project code to link this document to a Yuki project"),
+            remarks: z.string().optional()
+                .describe("Internal remarks shown in the archive"),
+            administrationId: z.string().optional()
+                .describe("Administration ID (GUID). Defaults to YUKI_DOMAIN_ID env var."),
+        },
+    }, async ({ fileName, dataBase64, folder, currency, amount, costCategory, paymentMethod, project, remarks, 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();
+            // Archive.asmx uses sessionID / administrationID (uppercase D)
+            const result = await client.callSoap({
+                service: "Archive.asmx",
+                method: "UploadDocumentWithData",
+                params: {
+                    sessionID,
+                    fileName,
+                    data: dataBase64,
+                    ...(folder !== undefined && { folder }),
+                    administrationID: adminId,
+                    currency: currency ?? "EUR",
+                    ...(amount !== undefined && { amount }),
+                    ...(costCategory !== undefined && { costCategory }),
+                    ...(paymentMethod !== undefined && { paymentMethod }),
+                    ...(project !== undefined && { project }),
+                    ...(remarks !== undefined && { remarks }),
+                },
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ success: true, fileName, result }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (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,
+            };
+        }
+    });
+    /**
+     * upload_document_from_path
+     *
+     * Upload a PDF from the local filesystem to the Yuki archive.
+     * Reads the file at filePath, converts it to base64 internally, and
+     * calls UploadDocumentWithData — avoiding the need to pass large base64
+     * strings through the MCP context.
+     *
+     * Rate cost: 1 request.
+     */
+    server.registerTool("upload_document_from_path", {
+        description: "Upload a PDF from a local file path to the Yuki archive. " +
+            "Reads and encodes the file internally — no need to pass base64 strings. " +
+            "Use this instead of upload_document when the file is available on disk. " +
+            "Call get_document_folders first to find the correct folder ID.",
+        inputSchema: {
+            filePath: z.string()
+                .describe("Absolute path to the file on the local filesystem (e.g. '/tmp/invoice-2024-0042.pdf')"),
+            fileName: z.string().optional()
+                .describe("Override the file name sent to Yuki. Defaults to the basename of filePath."),
+            folder: z.number().int().optional()
+                .describe("Archive folder ID. Use get_document_folders to list available folders."),
+            currency: z.string().optional().default("EUR")
+                .describe("ISO 4217 currency code for the document amount"),
+            amount: z.number().optional()
+                .describe("Total amount on the document (e.g. invoice total including VAT)"),
+            costCategory: z.string().optional()
+                .describe("GL account code for automatic cost categorisation (e.g. '4000')"),
+            paymentMethod: z.number().int().optional()
+                .describe("Payment method code. 0 = unknown, 1 = transfer, 2 = direct collection"),
+            project: z.string().optional()
+                .describe("Project code to link this document to a Yuki project"),
+            remarks: z.string().optional()
+                .describe("Internal remarks shown in the archive"),
+            administrationId: z.string().optional()
+                .describe("Administration ID (GUID). Defaults to YUKI_DOMAIN_ID env var."),
+        },
+    }, async ({ filePath, fileName, folder, currency, amount, costCategory, paymentMethod, project, remarks, administrationId }) => {
+        try {
+            const adminId = administrationId ?? client.defaultDomainId;
+            if (!adminId) {
+                throw new Error("administrationId is required (or set YUKI_DOMAIN_ID env var)");
+            }
+            // Validate file existence before making any API calls
+            if (!existsSync(filePath)) {
+                throw new Error(`File not found: ${filePath}`);
+            }
+            let fileBuffer;
+            try {
+                fileBuffer = readFileSync(filePath);
+            }
+            catch (readErr) {
+                throw new Error(`Cannot read file at ${filePath}: ${readErr instanceof Error ? readErr.message : String(readErr)}`);
+            }
+            // Check for PDF magic bytes (%PDF)
+            if (fileBuffer.length < 4 ||
+                fileBuffer[0] !== 0x25 || // %
+                fileBuffer[1] !== 0x50 || // P
+                fileBuffer[2] !== 0x44 || // D
+                fileBuffer[3] !== 0x46 // F
+            ) {
+                throw new Error(`File does not appear to be a PDF (missing %PDF header): ${filePath}`);
+            }
+            const resolvedFileName = fileName ?? basename(filePath);
+            const dataBase64 = fileBuffer.toString("base64");
+            const sessionID = await client.getSessionID();
+            const result = await client.callSoap({
+                service: "Archive.asmx",
+                method: "UploadDocumentWithData",
+                params: {
+                    sessionID,
+                    fileName: resolvedFileName,
+                    data: dataBase64,
+                    ...(folder !== undefined && { folder }),
+                    administrationID: adminId,
+                    currency: currency ?? "EUR",
+                    ...(amount !== undefined && { amount }),
+                    ...(costCategory !== undefined && { costCategory }),
+                    ...(paymentMethod !== undefined && { paymentMethod }),
+                    ...(project !== undefined && { project }),
+                    ...(remarks !== undefined && { remarks }),
+                },
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ success: true, filePath, fileName: resolvedFileName,
+                            fileSizeBytes: fileBuffer.length, result }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (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,
+            };
+        }
+    });
+    /**
+     * get_document_folders
+     *
+     * List all archive folders available in this Yuki administration.
+     * Use this to find the correct folder ID before calling upload_document.
+     *
+     * Rate cost: 1 request.
+     */
+    server.registerTool("get_document_folders", {
+        description: "List all archive folders in the Yuki administration. " +
+            "Use this to find the correct folder ID to pass to upload_document.",
+        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: "Archive.asmx",
+                method: "DocumentFolders",
+                params: {
+                    sessionID,
+                    administrationID: adminId,
+                },
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ success: true, result }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (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=documents.js.map

package/dist/tools/documents.js.map

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

package/dist/tools/invoices.d.ts

@@ -0,0 +1,22 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { YukiClient } from "../yuki-client.js";
+/**
+ * Register tools for retrieving outstanding invoices from Yuki.
+ *
+ * Note: The Yuki SOAP API exposes outstanding (open) invoice items via
+ * the Accounting service. Full invoice history with date-range filtering
+ * is not available via SOAP — use the Yuki web interface or the
+ * ProcessSalesInvoices/ProcessPurchaseInvoices methods for write operations.
+ *
+ * Sales receivables:  OutstandingDebtorItems
+ * Purchase payables:  OutstandingCreditorItems
+ *
+ * Yuki service: Accounting.asmx
+ */
+export declare function registerInvoiceTools(server: McpServer, client: YukiClient): void;
+/**
+ * Register the write tools for sales and purchase invoices.
+ * Called from registerInvoiceTools — same server/client instance.
+ */
+export declare function registerInvoiceWriteTools(server: McpServer, client: YukiClient): void;
+//# sourceMappingURL=invoices.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"invoices.d.ts","sourceRoot":"","sources":["../../src/tools/invoices.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAuB,MAAM,mBAAmB,CAAC;AAEpE;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,UAAU,GACjB,IAAI,CAsPN;AA0BD;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,UAAU,GACjB,IAAI,CA8KN"}