@promptpartner/bexio-mcp-server 2.0.0

package/dist/tools/index.js

@@ -0,0 +1,93 @@
+/**
+ * Tool aggregation module.
+ * Single import point for all domain tools.
+ *
+ * Pattern for adding new domains:
+ * 1. Create tools/{domain}/definitions.ts
+ * 2. Create tools/{domain}/handlers.ts
+ * 3. Create tools/{domain}/index.ts
+ * 4. Import and add to arrays below
+ */
+// Domain imports
+import * as reference from "./reference/index.js";
+import * as company from "./company/index.js";
+import * as banking from "./banking/index.js";
+import * as projects from "./projects/index.js";
+import * as timetracking from "./timetracking/index.js";
+import * as accounting from "./accounting/index.js";
+import * as contacts from "./contacts/index.js";
+import * as invoices from "./invoices/index.js";
+import * as orders from "./orders/index.js";
+import * as quotes from "./quotes/index.js";
+import * as payments from "./payments/index.js";
+import * as reminders from "./reminders/index.js";
+import * as deliveries from "./deliveries/index.js";
+import * as items from "./items/index.js";
+import * as reports from "./reports/index.js";
+import * as users from "./users/index.js";
+import * as misc from "./misc/index.js";
+import * as purchase from "./purchase/index.js";
+import * as files from "./files/index.js";
+import * as payroll from "./payroll/index.js";
+// Aggregate all tool definitions (218 total)
+const allDefinitions = [
+    ...reference.toolDefinitions, // 26 tools (contact groups, sectors, salutations, titles, countries, languages, units)
+    ...company.toolDefinitions, // 6 tools (company profile, permissions, payment types)
+    ...banking.toolDefinitions, // 13 tools (bank accounts, currencies, IBAN payments, QR payments)
+    ...projects.toolDefinitions, // 21 tools (projects, project types, project statuses, milestones, work packages)
+    ...timetracking.toolDefinitions, // 11 tools (timesheets, statuses, business activities, communication types)
+    ...accounting.toolDefinitions, // 15 tools (accounts, groups, years, entries, VAT, journal)
+    ...purchase.toolDefinitions, // 23 tools (bills, expenses, purchase orders, outgoing payments)
+    ...files.toolDefinitions, // 10 tools (files, additional addresses)
+    ...payroll.toolDefinitions, // 10 tools (employees, absences, payroll docs - conditional)
+    ...contacts.toolDefinitions, // 7 tools
+    ...invoices.toolDefinitions, // 15 tools
+    ...orders.toolDefinitions, // 7 tools
+    ...quotes.toolDefinitions, // 11 tools
+    ...payments.toolDefinitions, // 4 tools
+    ...reminders.toolDefinitions, // 8 tools
+    ...deliveries.toolDefinitions, // 4 tools
+    ...items.toolDefinitions, // 5 tools
+    ...reports.toolDefinitions, // 7 tools
+    ...users.toolDefinitions, // 6 tools
+    ...misc.toolDefinitions, // 9 tools
+];
+// Aggregate all handlers
+const allHandlers = {
+    ...reference.handlers,
+    ...company.handlers,
+    ...banking.handlers,
+    ...projects.handlers,
+    ...timetracking.handlers,
+    ...accounting.handlers,
+    ...purchase.handlers,
+    ...files.handlers,
+    ...payroll.handlers,
+    ...contacts.handlers,
+    ...invoices.handlers,
+    ...orders.handlers,
+    ...quotes.handlers,
+    ...payments.handlers,
+    ...reminders.handlers,
+    ...deliveries.handlers,
+    ...items.handlers,
+    ...reports.handlers,
+    ...users.handlers,
+    ...misc.handlers,
+};
+/** Get all tool definitions for registration */
+export function getAllToolDefinitions() {
+    return allDefinitions;
+}
+/** Get handler for a specific tool */
+export function getHandler(toolName) {
+    return allHandlers[toolName];
+}
+/** Create handler registry bound to a client */
+export function createHandlerRegistry(client) {
+    const registry = new Map();
+    for (const [name, handler] of Object.entries(allHandlers)) {
+        registry.set(name, (args) => handler(client, args));
+    }
+    return registry;
+}

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

@@ -0,0 +1,6 @@
+/**
+ * Invoice tool definitions.
+ * Contains MCP tool metadata for invoices domain.
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const toolDefinitions: Tool[];

package/dist/tools/invoices/definitions.js

@@ -0,0 +1,147 @@
+export const toolDefinitions = [
+    {
+        name: "list_invoices",
+        description: "List invoices from Bexio with optional pagination",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: { type: "integer", description: "Maximum number to return (default: 50)", default: 50 },
+                offset: { type: "integer", description: "Number to skip (default: 0)", default: 0 },
+            },
+        },
+    },
+    {
+        name: "list_all_invoices",
+        description: "List every invoice in Bexio by paging automatically",
+        inputSchema: {
+            type: "object",
+            properties: {
+                chunk_size: { type: "integer", description: "Invoices per request (default: 100)", default: 100 },
+            },
+        },
+    },
+    {
+        name: "get_invoice",
+        description: "Get a specific invoice by ID",
+        inputSchema: {
+            type: "object",
+            properties: { invoice_id: { type: "integer", description: "The invoice ID" } },
+            required: ["invoice_id"],
+        },
+    },
+    {
+        name: "search_invoices",
+        description: "Search invoices via the Bexio search endpoint",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: { type: "string", description: "Free-text value matched with LIKE" },
+                field: { type: "string", description: "Field to search (default: title)", default: "title" },
+                operator: { type: "string", description: "Comparison operator (LIKE, =, >)", default: "LIKE" },
+                filters: {
+                    type: "array", description: "Explicit Bexio search filters",
+                    items: {
+                        type: "object",
+                        properties: { field: { type: "string" }, operator: { type: "string" }, value: {} },
+                        required: ["field", "operator", "value"],
+                    },
+                },
+                limit: { type: "integer", description: "Maximum results" },
+            },
+        },
+    },
+    {
+        name: "search_invoices_by_customer",
+        description: "Search invoices by customer name (finds contact, then invoices)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_name: { type: "string", description: "Customer name to search for" },
+                limit: { type: "integer", description: "Maximum invoices to return (default: 50)", default: 50 },
+            },
+            required: ["customer_name"],
+        },
+    },
+    {
+        name: "create_invoice",
+        description: "Create a new invoice in Bexio",
+        inputSchema: {
+            type: "object",
+            properties: { invoice_data: { type: "object", description: "Invoice data to create" } },
+            required: ["invoice_data"],
+        },
+    },
+    {
+        name: "issue_invoice",
+        description: "Issue an invoice",
+        inputSchema: {
+            type: "object",
+            properties: { invoice_id: { type: "integer", description: "The invoice ID to issue" } },
+            required: ["invoice_id"],
+        },
+    },
+    {
+        name: "cancel_invoice",
+        description: "Cancel an invoice",
+        inputSchema: {
+            type: "object",
+            properties: { invoice_id: { type: "integer", description: "The invoice ID to cancel" } },
+            required: ["invoice_id"],
+        },
+    },
+    {
+        name: "mark_invoice_as_sent",
+        description: "Mark an invoice as sent",
+        inputSchema: {
+            type: "object",
+            properties: { invoice_id: { type: "integer", description: "The invoice ID to mark as sent" } },
+            required: ["invoice_id"],
+        },
+    },
+    {
+        name: "send_invoice",
+        description: "Send an invoice",
+        inputSchema: {
+            type: "object",
+            properties: { invoice_id: { type: "integer", description: "The invoice ID to send" } },
+            required: ["invoice_id"],
+        },
+    },
+    {
+        name: "copy_invoice",
+        description: "Copy an invoice",
+        inputSchema: {
+            type: "object",
+            properties: { invoice_id: { type: "integer", description: "The invoice ID to copy" } },
+            required: ["invoice_id"],
+        },
+    },
+    {
+        name: "list_invoice_statuses",
+        description: "List all available invoice statuses with their meanings",
+        inputSchema: { type: "object", properties: {} },
+    },
+    {
+        name: "list_all_statuses",
+        description: "List all document statuses for invoices, quotes, and orders",
+        inputSchema: {
+            type: "object",
+            properties: {
+                document_type: {
+                    type: "string", enum: ["all", "invoices", "quotes", "orders"],
+                    description: "Filter by document type (default: all)", default: "all",
+                },
+            },
+        },
+    },
+    {
+        name: "get_open_invoices",
+        description: "Get all open invoices (draft and sent/pending)",
+        inputSchema: { type: "object", properties: {} },
+    },
+    {
+        name: "get_overdue_invoices",
+        description: "Get all overdue invoices",
+        inputSchema: { type: "object", properties: {} },
+    },
+];

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

@@ -0,0 +1,7 @@
+/**
+ * Invoice tool handlers.
+ * Implements the logic for each invoice tool.
+ */
+import { BexioClient } from "../../bexio-client.js";
+export type HandlerFn = (client: BexioClient, args: unknown) => Promise<unknown>;
+export declare const handlers: Record<string, HandlerFn>;

package/dist/tools/invoices/handlers.js

@@ -0,0 +1,119 @@
+/**
+ * Invoice tool handlers.
+ * Implements the logic for each invoice tool.
+ */
+import { McpError } from "../../shared/errors.js";
+import { ListInvoicesParamsSchema, ListAllInvoicesParamsSchema, GetInvoiceParamsSchema, SearchInvoicesParamsSchema, SearchInvoicesByCustomerParamsSchema, CreateInvoiceParamsSchema, IssueInvoiceParamsSchema, CancelInvoiceParamsSchema, MarkInvoiceAsSentParamsSchema, SendInvoiceParamsSchema, CopyInvoiceParamsSchema, ListInvoiceStatusesParamsSchema, ListAllStatusesParamsSchema, } from "../../types/index.js";
+export const handlers = {
+    list_invoices: async (client, args) => {
+        const params = ListInvoicesParamsSchema.parse(args);
+        return client.listInvoices(params);
+    },
+    list_all_invoices: async (client, args) => {
+        const { chunk_size } = ListAllInvoicesParamsSchema.parse(args);
+        return client.listAllInvoices(chunk_size);
+    },
+    get_invoice: async (client, args) => {
+        const { invoice_id } = GetInvoiceParamsSchema.parse(args);
+        const invoice = await client.getInvoice(invoice_id);
+        if (!invoice) {
+            throw McpError.notFound("Invoice", invoice_id);
+        }
+        return invoice;
+    },
+    search_invoices: async (client, args) => {
+        const params = SearchInvoicesParamsSchema.parse(args);
+        const searchParams = {
+            field: params.field,
+            operator: params.operator,
+        };
+        if (params.query !== undefined) {
+            searchParams.query = params.query;
+        }
+        if (params.filters !== undefined) {
+            searchParams.filters = params.filters.map((filter) => ({
+                field: filter.field,
+                operator: filter.operator,
+                value: filter.value ?? null,
+            }));
+        }
+        if (params.limit !== undefined) {
+            searchParams.limit = params.limit;
+        }
+        return client.searchInvoices(searchParams);
+    },
+    search_invoices_by_customer: async (client, args) => {
+        const params = SearchInvoicesByCustomerParamsSchema.parse(args);
+        // Step 1: Find contacts by name
+        const contacts = await client.findContactByName(params.customer_name);
+        if (!contacts || contacts.length === 0) {
+            return {
+                invoices: [],
+                message: `No contacts found with name "${params.customer_name}"`,
+                contacts_found: 0,
+            };
+        }
+        // Step 2: Search invoices for each contact (limit to first 5)
+        const allInvoices = [];
+        for (const contact of contacts.slice(0, 5)) {
+            const contactId = contact.id;
+            if (contactId) {
+                const searchParams = {
+                    filters: [
+                        {
+                            field: "contact_id",
+                            operator: "=",
+                            value: contactId.toString(),
+                        },
+                    ],
+                    limit: params.limit,
+                };
+                const invoices = await client.searchInvoices(searchParams);
+                allInvoices.push(...invoices);
+            }
+        }
+        return {
+            invoices: allInvoices,
+            contacts_found: contacts.length,
+            customer_name: params.customer_name,
+        };
+    },
+    create_invoice: async (client, args) => {
+        const { invoice_data } = CreateInvoiceParamsSchema.parse(args);
+        return client.createInvoice(invoice_data);
+    },
+    issue_invoice: async (client, args) => {
+        const { invoice_id } = IssueInvoiceParamsSchema.parse(args);
+        return client.issueInvoice(invoice_id);
+    },
+    cancel_invoice: async (client, args) => {
+        const { invoice_id } = CancelInvoiceParamsSchema.parse(args);
+        return client.cancelInvoice(invoice_id);
+    },
+    mark_invoice_as_sent: async (client, args) => {
+        const { invoice_id } = MarkInvoiceAsSentParamsSchema.parse(args);
+        return client.markInvoiceAsSent(invoice_id);
+    },
+    send_invoice: async (client, args) => {
+        const { invoice_id } = SendInvoiceParamsSchema.parse(args);
+        return client.sendInvoice(invoice_id);
+    },
+    copy_invoice: async (client, args) => {
+        const { invoice_id } = CopyInvoiceParamsSchema.parse(args);
+        return client.copyInvoice(invoice_id);
+    },
+    list_invoice_statuses: async (client, args) => {
+        ListInvoiceStatusesParamsSchema.parse(args);
+        return client.listInvoiceStatuses();
+    },
+    list_all_statuses: async (client, args) => {
+        const { document_type } = ListAllStatusesParamsSchema.parse(args);
+        return client.listAllStatuses(document_type);
+    },
+    get_open_invoices: async (client) => {
+        return client.getOpenInvoices();
+    },
+    get_overdue_invoices: async (client) => {
+        return client.getOverdueInvoices();
+    },
+};

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

@@ -0,0 +1,6 @@
+/**
+ * Invoices domain module barrel export.
+ */
+export { toolDefinitions } from "./definitions.js";
+export { handlers } from "./handlers.js";
+export type { HandlerFn } from "./handlers.js";

package/dist/tools/invoices/index.js

@@ -0,0 +1,5 @@
+/**
+ * Invoices domain module barrel export.
+ */
+export { toolDefinitions } from "./definitions.js";
+export { handlers } from "./handlers.js";

package/dist/tools/items/definitions.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Item tool definitions.
+ * Contains MCP tool metadata for items/articles and taxes domain.
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const toolDefinitions: Tool[];

package/dist/tools/items/definitions.js

@@ -0,0 +1,100 @@
+/**
+ * Item tool definitions.
+ * Contains MCP tool metadata for items/articles and taxes domain.
+ */
+export const toolDefinitions = [
+    {
+        name: "list_items",
+        description: "List items from Bexio with optional pagination",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of items to return (default: 50)",
+                    default: 50,
+                },
+                offset: {
+                    type: "integer",
+                    description: "Number of items to skip (default: 0)",
+                    default: 0,
+                },
+            },
+        },
+    },
+    {
+        name: "get_item",
+        description: "Get a specific item by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                item_id: {
+                    type: "integer",
+                    description: "The ID of the item to retrieve",
+                },
+            },
+            required: ["item_id"],
+        },
+    },
+    {
+        name: "create_item",
+        description: "Create a new item in Bexio",
+        inputSchema: {
+            type: "object",
+            properties: {
+                item_data: {
+                    type: "object",
+                    description: "Item data to create",
+                    properties: {
+                        name_1: { type: "string", description: "Item name (primary name field)" },
+                        name_2: { type: "string", description: "Item name (secondary name field)" },
+                        description: { type: "string", description: "Item description" },
+                        internal_pos: { type: "string", description: "Internal position number" },
+                        unit_id: { type: "integer", description: "Unit ID" },
+                        purchase_price: { type: "number", description: "Purchase price" },
+                        sale_price: { type: "number", description: "Sale price" },
+                        article_type_id: { type: "integer", description: "Article type ID" },
+                        tax_income_id: { type: "integer", description: "Tax income ID" },
+                        tax_id: { type: "integer", description: "Tax ID" },
+                        account_id: { type: "integer", description: "Account ID" },
+                    },
+                    required: ["name_1"],
+                },
+            },
+            required: ["item_data"],
+        },
+    },
+    {
+        name: "list_taxes",
+        description: "List taxes from Bexio with optional pagination",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of taxes to return (default: 50)",
+                    default: 50,
+                },
+                offset: {
+                    type: "integer",
+                    description: "Number of taxes to skip (default: 0)",
+                    default: 0,
+                },
+            },
+        },
+    },
+    {
+        name: "get_tax",
+        description: "Get a specific tax by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                tax_id: {
+                    type: "integer",
+                    description: "The ID of the tax to retrieve",
+                },
+            },
+            required: ["tax_id"],
+        },
+    },
+];

package/dist/tools/items/handlers.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Item tool handlers.
+ * Implements the logic for each item and tax tool.
+ */
+import { BexioClient } from "../../bexio-client.js";
+export type HandlerFn = (client: BexioClient, args: unknown) => Promise<unknown>;
+export declare const handlers: Record<string, HandlerFn>;

package/dist/tools/items/handlers.js

@@ -0,0 +1,36 @@
+/**
+ * Item tool handlers.
+ * Implements the logic for each item and tax tool.
+ */
+import { McpError } from "../../shared/errors.js";
+import { ListItemsParamsSchema, GetItemParamsSchema, CreateItemParamsSchema, ListTaxesParamsSchema, GetTaxParamsSchema, } from "../../types/index.js";
+export const handlers = {
+    list_items: async (client, args) => {
+        const params = ListItemsParamsSchema.parse(args);
+        return client.listItems(params);
+    },
+    get_item: async (client, args) => {
+        const { item_id } = GetItemParamsSchema.parse(args);
+        const item = await client.getItem(item_id);
+        if (!item) {
+            throw McpError.notFound("Item", item_id);
+        }
+        return item;
+    },
+    create_item: async (client, args) => {
+        const { item_data } = CreateItemParamsSchema.parse(args);
+        return client.createItem(item_data);
+    },
+    list_taxes: async (client, args) => {
+        const params = ListTaxesParamsSchema.parse(args);
+        return client.listTaxes(params);
+    },
+    get_tax: async (client, args) => {
+        const { tax_id } = GetTaxParamsSchema.parse(args);
+        const tax = await client.getTax(tax_id);
+        if (!tax) {
+            throw McpError.notFound("Tax", tax_id);
+        }
+        return tax;
+    },
+};

package/dist/tools/items/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Items domain module barrel export.
+ */
+export { toolDefinitions } from "./definitions.js";
+export { handlers } from "./handlers.js";
+export type { HandlerFn } from "./handlers.js";

package/dist/tools/items/index.js

@@ -0,0 +1,5 @@
+/**
+ * Items domain module barrel export.
+ */
+export { toolDefinitions } from "./definitions.js";
+export { handlers } from "./handlers.js";

package/dist/tools/misc/definitions.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Misc tool definitions.
+ * Contains MCP tool metadata for comments and contact relations.
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const toolDefinitions: Tool[];