@promptpartner/bexio-mcp-server 2.0.0

package/dist/tools/misc/definitions.js

@@ -0,0 +1,126 @@
+/**
+ * Misc tool definitions.
+ * Contains MCP tool metadata for comments and contact relations.
+ */
+export const toolDefinitions = [
+    // Comments
+    {
+        name: "list_comments",
+        description: "List all comments",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "get_comment",
+        description: "Get a specific comment by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                comment_id: {
+                    type: "integer",
+                    description: "The ID of the comment to retrieve",
+                },
+            },
+            required: ["comment_id"],
+        },
+    },
+    {
+        name: "create_comment",
+        description: "Create a new comment",
+        inputSchema: {
+            type: "object",
+            properties: {
+                comment_data: {
+                    type: "object",
+                    description: "Comment data to create",
+                },
+            },
+            required: ["comment_data"],
+        },
+    },
+    // Contact Relations
+    {
+        name: "list_contact_relations",
+        description: "List all contact relations",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "get_contact_relation",
+        description: "Get a specific contact relation by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                relation_id: {
+                    type: "integer",
+                    description: "The ID of the contact relation to retrieve",
+                },
+            },
+            required: ["relation_id"],
+        },
+    },
+    {
+        name: "create_contact_relation",
+        description: "Create a new contact relation",
+        inputSchema: {
+            type: "object",
+            properties: {
+                relation_data: {
+                    type: "object",
+                    description: "Contact relation data to create",
+                },
+            },
+            required: ["relation_data"],
+        },
+    },
+    {
+        name: "update_contact_relation",
+        description: "Update a contact relation",
+        inputSchema: {
+            type: "object",
+            properties: {
+                relation_id: {
+                    type: "integer",
+                    description: "The ID of the contact relation to update",
+                },
+                relation_data: {
+                    type: "object",
+                    description: "Contact relation data to update",
+                },
+            },
+            required: ["relation_id", "relation_data"],
+        },
+    },
+    {
+        name: "delete_contact_relation",
+        description: "Delete a contact relation",
+        inputSchema: {
+            type: "object",
+            properties: {
+                relation_id: {
+                    type: "integer",
+                    description: "The ID of the contact relation to delete",
+                },
+            },
+            required: ["relation_id"],
+        },
+    },
+    {
+        name: "search_contact_relations",
+        description: "Search contact relations with filters",
+        inputSchema: {
+            type: "object",
+            properties: {
+                search_params: {
+                    type: "object",
+                    description: "Search parameters for contact relations",
+                },
+            },
+            required: ["search_params"],
+        },
+    },
+];

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

@@ -0,0 +1,7 @@
+/**
+ * Misc tool handlers.
+ * Implements the logic for comments and contact relations.
+ */
+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/misc/handlers.js

@@ -0,0 +1,52 @@
+/**
+ * Misc tool handlers.
+ * Implements the logic for comments and contact relations.
+ */
+import { McpError } from "../../shared/errors.js";
+import { GetCommentParamsSchema, CreateCommentParamsSchema, GetContactRelationParamsSchema, CreateContactRelationParamsSchema, UpdateContactRelationParamsSchema, DeleteContactRelationParamsSchema, SearchContactRelationsParamsSchema, } from "../../types/index.js";
+export const handlers = {
+    // Comments
+    list_comments: async (client) => {
+        return client.listComments();
+    },
+    get_comment: async (client, args) => {
+        const { comment_id } = GetCommentParamsSchema.parse(args);
+        const comment = await client.getComment(comment_id);
+        if (!comment) {
+            throw McpError.notFound("Comment", comment_id);
+        }
+        return comment;
+    },
+    create_comment: async (client, args) => {
+        const { comment_data } = CreateCommentParamsSchema.parse(args);
+        return client.createComment(comment_data);
+    },
+    // Contact Relations
+    list_contact_relations: async (client) => {
+        return client.listContactRelations();
+    },
+    get_contact_relation: async (client, args) => {
+        const { relation_id } = GetContactRelationParamsSchema.parse(args);
+        const relation = await client.getContactRelation(relation_id);
+        if (!relation) {
+            throw McpError.notFound("Contact Relation", relation_id);
+        }
+        return relation;
+    },
+    create_contact_relation: async (client, args) => {
+        const { relation_data } = CreateContactRelationParamsSchema.parse(args);
+        return client.createContactRelation(relation_data);
+    },
+    update_contact_relation: async (client, args) => {
+        const { relation_id, relation_data } = UpdateContactRelationParamsSchema.parse(args);
+        return client.updateContactRelation(relation_id, relation_data);
+    },
+    delete_contact_relation: async (client, args) => {
+        const { relation_id } = DeleteContactRelationParamsSchema.parse(args);
+        return client.deleteContactRelation(relation_id);
+    },
+    search_contact_relations: async (client, args) => {
+        const { search_params } = SearchContactRelationsParamsSchema.parse(args);
+        return client.searchContactRelations(search_params);
+    },
+};

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

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

package/dist/tools/misc/index.js

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

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

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

package/dist/tools/orders/definitions.js

@@ -0,0 +1,114 @@
+/**
+ * Order tool definitions.
+ * Contains MCP tool metadata for orders domain.
+ */
+export const toolDefinitions = [
+    {
+        name: "list_orders",
+        description: "List orders from Bexio with optional pagination",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of orders to return (default: 50)",
+                    default: 50,
+                },
+                offset: {
+                    type: "integer",
+                    description: "Number of orders to skip (default: 0)",
+                    default: 0,
+                },
+            },
+        },
+    },
+    {
+        name: "get_order",
+        description: "Get a specific order by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                order_id: {
+                    type: "integer",
+                    description: "The ID of the order to retrieve",
+                },
+            },
+            required: ["order_id"],
+        },
+    },
+    {
+        name: "create_order",
+        description: "Create a new order in Bexio",
+        inputSchema: {
+            type: "object",
+            properties: {
+                order_data: {
+                    type: "object",
+                    description: "Order data to create",
+                },
+            },
+            required: ["order_data"],
+        },
+    },
+    {
+        name: "search_orders",
+        description: "Search orders with filters",
+        inputSchema: {
+            type: "object",
+            properties: {
+                search_params: {
+                    type: "object",
+                    description: "Search parameters for orders",
+                },
+            },
+            required: ["search_params"],
+        },
+    },
+    {
+        name: "search_orders_by_customer",
+        description: "Search orders by customer name (2-step process: find contact by name, then find orders by contact_id)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_name: {
+                    type: "string",
+                    description: 'Customer name to search for (e.g., "Anton", "Mustermann")',
+                },
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of orders to return (default: 50)",
+                    default: 50,
+                },
+            },
+            required: ["customer_name"],
+        },
+    },
+    {
+        name: "create_delivery_from_order",
+        description: "Create a delivery from an order",
+        inputSchema: {
+            type: "object",
+            properties: {
+                order_id: {
+                    type: "integer",
+                    description: "The ID of the order to create a delivery from",
+                },
+            },
+            required: ["order_id"],
+        },
+    },
+    {
+        name: "create_invoice_from_order",
+        description: "Create an invoice from an order",
+        inputSchema: {
+            type: "object",
+            properties: {
+                order_id: {
+                    type: "integer",
+                    description: "The ID of the order to create an invoice from",
+                },
+            },
+            required: ["order_id"],
+        },
+    },
+];

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

@@ -0,0 +1,7 @@
+/**
+ * Order tool handlers.
+ * Implements the logic for each order 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/orders/handlers.js

@@ -0,0 +1,62 @@
+/**
+ * Order tool handlers.
+ * Implements the logic for each order tool.
+ */
+import { McpError } from "../../shared/errors.js";
+import { ListOrdersParamsSchema, GetOrderParamsSchema, CreateOrderParamsSchema, SearchOrdersParamsSchema, SearchOrdersByCustomerParamsSchema, CreateDeliveryFromOrderParamsSchema, CreateInvoiceFromOrderParamsSchema, } from "../../types/index.js";
+export const handlers = {
+    list_orders: async (client, args) => {
+        const params = ListOrdersParamsSchema.parse(args);
+        return client.listOrders(params);
+    },
+    get_order: async (client, args) => {
+        const { order_id } = GetOrderParamsSchema.parse(args);
+        const order = await client.getOrder(order_id);
+        if (!order) {
+            throw McpError.notFound("Order", order_id);
+        }
+        return order;
+    },
+    create_order: async (client, args) => {
+        const { order_data } = CreateOrderParamsSchema.parse(args);
+        return client.createOrder(order_data);
+    },
+    search_orders: async (client, args) => {
+        const { search_params } = SearchOrdersParamsSchema.parse(args);
+        return client.searchOrders(search_params);
+    },
+    search_orders_by_customer: async (client, args) => {
+        const params = SearchOrdersByCustomerParamsSchema.parse(args);
+        // Step 1: Find contacts by name
+        const contacts = await client.findContactByName(params.customer_name);
+        if (!contacts || contacts.length === 0) {
+            return {
+                orders: [],
+                message: `No contacts found with name "${params.customer_name}"`,
+                contacts_found: 0,
+            };
+        }
+        // Step 2: Search orders for each contact (limit to first 5)
+        const allOrders = [];
+        for (const contact of contacts.slice(0, 5)) {
+            const contactId = contact.id;
+            if (contactId) {
+                const orders = await client.searchOrdersByContactId(contactId);
+                allOrders.push(...orders);
+            }
+        }
+        return {
+            orders: allOrders,
+            contacts_found: contacts.length,
+            customer_name: params.customer_name,
+        };
+    },
+    create_delivery_from_order: async (client, args) => {
+        const { order_id } = CreateDeliveryFromOrderParamsSchema.parse(args);
+        return client.createDeliveryFromOrder(order_id);
+    },
+    create_invoice_from_order: async (client, args) => {
+        const { order_id } = CreateInvoiceFromOrderParamsSchema.parse(args);
+        return client.createInvoiceFromOrder(order_id);
+    },
+};

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

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

package/dist/tools/orders/index.js

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

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

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

package/dist/tools/payments/definitions.js

@@ -0,0 +1,74 @@
+/**
+ * Payment tool definitions.
+ * Contains MCP tool metadata for payments domain.
+ */
+export const toolDefinitions = [
+    {
+        name: "list_payments",
+        description: "List payments for a specific invoice",
+        inputSchema: {
+            type: "object",
+            properties: {
+                invoice_id: {
+                    type: "integer",
+                    description: "The ID of the invoice to get payments for",
+                },
+            },
+            required: ["invoice_id"],
+        },
+    },
+    {
+        name: "get_payment",
+        description: "Get a specific payment by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                invoice_id: {
+                    type: "integer",
+                    description: "The ID of the invoice",
+                },
+                payment_id: {
+                    type: "integer",
+                    description: "The ID of the payment to retrieve",
+                },
+            },
+            required: ["invoice_id", "payment_id"],
+        },
+    },
+    {
+        name: "create_payment",
+        description: "Create a new payment for an invoice",
+        inputSchema: {
+            type: "object",
+            properties: {
+                invoice_id: {
+                    type: "integer",
+                    description: "The ID of the invoice to create a payment for",
+                },
+                payment_data: {
+                    type: "object",
+                    description: "Payment data to create",
+                },
+            },
+            required: ["invoice_id", "payment_data"],
+        },
+    },
+    {
+        name: "delete_payment",
+        description: "Delete a payment",
+        inputSchema: {
+            type: "object",
+            properties: {
+                invoice_id: {
+                    type: "integer",
+                    description: "The ID of the invoice",
+                },
+                payment_id: {
+                    type: "integer",
+                    description: "The ID of the payment to delete",
+                },
+            },
+            required: ["invoice_id", "payment_id"],
+        },
+    },
+];

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

@@ -0,0 +1,7 @@
+/**
+ * Payment tool handlers.
+ * Implements the logic for each payment 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/payments/handlers.js

@@ -0,0 +1,28 @@
+/**
+ * Payment tool handlers.
+ * Implements the logic for each payment tool.
+ */
+import { McpError } from "../../shared/errors.js";
+import { ListPaymentsParamsSchema, GetPaymentParamsSchema, CreatePaymentParamsSchema, DeletePaymentParamsSchema, } from "../../types/index.js";
+export const handlers = {
+    list_payments: async (client, args) => {
+        const { invoice_id } = ListPaymentsParamsSchema.parse(args);
+        return client.listPayments(invoice_id);
+    },
+    get_payment: async (client, args) => {
+        const { invoice_id, payment_id } = GetPaymentParamsSchema.parse(args);
+        const payment = await client.getPayment(invoice_id, payment_id);
+        if (!payment) {
+            throw McpError.notFound("Payment", payment_id);
+        }
+        return payment;
+    },
+    create_payment: async (client, args) => {
+        const { invoice_id, payment_data } = CreatePaymentParamsSchema.parse(args);
+        return client.createPayment(invoice_id, payment_data);
+    },
+    delete_payment: async (client, args) => {
+        const { invoice_id, payment_id } = DeletePaymentParamsSchema.parse(args);
+        return client.deletePayment(invoice_id, payment_id);
+    },
+};

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

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

package/dist/tools/payments/index.js

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

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

@@ -0,0 +1,15 @@
+/**
+ * Payroll tool definitions.
+ * Contains MCP tool metadata for payroll domain.
+ *
+ * IMPORTANT: Payroll module requires a Bexio subscription with payroll features.
+ * All tools check module availability on first call and cache the result.
+ * When unavailable, tools return a friendly error explaining how to enable payroll.
+ *
+ * 10 tools total:
+ * - Employees: 4 tools (list, get, create, update)
+ * - Absences: 5 tools (list, get, create, update, delete)
+ * - Payroll Documents: 1 tool (list)
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const toolDefinitions: Tool[];