List all Yuki administrations (companies) accessible with the configured API key. Run this first to discover the correct administrationID to pass to other tools.

Look up the GUID of a Yuki administration by its exact name. Use this to resolve an administration name to the ID required by other tools. For a full list of administrations and IDs use get_administrations.

Reload the administrationId → apiKey map from the JSON keys file without restarting the MCP server. Use after a new key has been generated externally (for example via a create_api_key flow) to make it usable for SOAP calls immediately. Sessions for changed/removed keys are invalidated; unchanged keys keep their cached session. Returns a diff of added/updated/removed IDs.

Search for Yuki relations (customers/suppliers) by name, code, VAT number, or other fields. Returns up to 100 contacts per page with IDs, codes, names, and contact details. Omit searchValue (or pass an empty string) to retrieve all contacts.

Retrieve outstanding (unpaid) sales invoices from Yuki. Returns debtor name, reference, due date, open amount, and currency for each item. Optionally filter by due date cutoff using dateOutstanding.

Retrieve outstanding (unpaid) purchase invoices from Yuki. Returns creditor name, reference, due date, open amount, and currency for each item. Optionally filter by due date cutoff using dateOutstanding.

Retrieve all journal entries for a specific GL account code within a date range. Use this for bank transactions (find the bank GL code with get_gl_accounts first). Returns date, description, debit/credit amounts, and counterpart GL account.

Check whether an outstanding item (invoice) with a given reference still exists in Yuki and retrieve its current open amount and status.

Retrieve all GL accounts (grootboekrekeningen) with their balance at a given date. Use this to find account codes (e.g. bank account codes) or get a financial snapshot. Defaults to today's date if no date is provided.

Retrieve all GL accounts with their balance including fiscal corrections (fiscale stand). Use this for balance sheet and P&L views that must match Yuki fiscal reports. For the commercial/operational view use get_gl_accounts instead.

Retrieve net revenue (netto-omzet) for an administration within a date range. Set fiscal=true to include fiscal corrections (matches Yuki fiscal reports).

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.

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").

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.

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.

Retrieve bank payments that still need a matching purchase invoice — equivalent to "Postbus → Ontbrekende facturen" in the Yuki web interface. Returns creditor name, open amount, date, and bank description for each unmatched payment. Use upload_document or process_purchase_invoice to resolve items in this list.

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.

Create and book a new sales invoice in Yuki. Accepts invoice header, contact, and line items. Optionally sends the invoice to the customer by email. Returns the Yuki response including the assigned document ID.

Book an incoming purchase invoice in Yuki. Accepts invoice totals, supplier contact, and line items. Optionally attach the original PDF as a base64 string. Returns the Yuki response including the assigned document ID.

Post a general journal entry (memoriaal) in Yuki for bank reconciliation, corrections, or custom bookings. IMPORTANT: all entry amounts must sum to exactly 0 (positive = debit, negative = credit). Yuki will reject the entry if this rule is violated.

Create or update a contact (customer or supplier) in Yuki. When contactCode matches an existing record it will be updated; otherwise a new contact is created. Returns the Yuki response with the contact ID.

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.

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.

List documents in a Yuki archive folder. Returns document IDs, file names, dates, and amounts. Call get_document_folders first to find the correct folder ID. Use the returned document ID with get_document or download_document.

Search for documents in a Yuki archive folder by text. Call get_document_folders first to find the folderID. searchOption filters which field to match: All (default), Contact, Subject, Tag, Creator, or Type. tabID scopes the search to a folder tab — use 0 to search all tabs.

Retrieve metadata for a single archived document by its Yuki document ID. Returns file name, folder, date, amount, and status. Use list_documents or search_documents to find document IDs. To download the file binary use download_document.

Download an archived document from Yuki as a base64-encoded string. Use list_documents or search_documents to find the document ID first. Returns fileName and fileDataBase64.

List available cost categories (GL cost accounts) for document uploads. Use the returned GL codes as the costCategory parameter in upload_document.

List all archive folders in the Yuki administration. Use this to find the correct folder ID to pass to upload_document.

Retrieve the Yuki backoffice workflow items for an administration. These are documents (purchase and sales invoices) that could not be processed automatically and are waiting to be reviewed and booked by the accountant.

Retrieve outstanding backoffice questions for an administration in Yuki. These are questions raised by the accountant that require a response before the related documents can be processed.