@promptpartner/bexio-mcp-server 2.0.0

package/dist/tools/purchase/definitions.js

@@ -0,0 +1,381 @@
+/**
+ * Purchase tool definitions.
+ * Contains MCP tool metadata for bills, expenses, purchase orders, and outgoing payments.
+ */
+export const toolDefinitions = [
+    // ===== BILLS (Creditor Invoices) =====
+    {
+        name: "list_bills",
+        description: "List all bills (creditor invoices) with optional pagination",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of bills to return (default: 50)",
+                },
+                offset: {
+                    type: "integer",
+                    description: "Number of bills to skip (default: 0)",
+                },
+            },
+        },
+    },
+    {
+        name: "get_bill",
+        description: "Get a specific bill (creditor invoice) by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                bill_id: {
+                    type: "integer",
+                    description: "The ID of the bill to retrieve",
+                },
+            },
+            required: ["bill_id"],
+        },
+    },
+    {
+        name: "create_bill",
+        description: "Create a new bill (creditor invoice) from a supplier",
+        inputSchema: {
+            type: "object",
+            properties: {
+                bill_data: {
+                    type: "object",
+                    description: "Bill data including contact_id, title, positions, etc.",
+                },
+            },
+            required: ["bill_data"],
+        },
+    },
+    {
+        name: "update_bill",
+        description: "Update an existing bill (creditor invoice)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                bill_id: {
+                    type: "integer",
+                    description: "The ID of the bill to update",
+                },
+                bill_data: {
+                    type: "object",
+                    description: "Bill data to update",
+                },
+            },
+            required: ["bill_id", "bill_data"],
+        },
+    },
+    {
+        name: "delete_bill",
+        description: "Delete a bill (creditor invoice)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                bill_id: {
+                    type: "integer",
+                    description: "The ID of the bill to delete",
+                },
+            },
+            required: ["bill_id"],
+        },
+    },
+    {
+        name: "search_bills",
+        description: "Search bills (creditor invoices) by criteria",
+        inputSchema: {
+            type: "object",
+            properties: {
+                criteria: {
+                    type: "array",
+                    description: "Array of search criteria objects with field, value, and optional operator",
+                },
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of results",
+                },
+                offset: {
+                    type: "integer",
+                    description: "Number of results to skip",
+                },
+            },
+            required: ["criteria"],
+        },
+    },
+    {
+        name: "issue_bill",
+        description: "Issue a bill (creditor invoice) to change its status",
+        inputSchema: {
+            type: "object",
+            properties: {
+                bill_id: {
+                    type: "integer",
+                    description: "The ID of the bill to issue",
+                },
+            },
+            required: ["bill_id"],
+        },
+    },
+    {
+        name: "mark_bill_as_paid",
+        description: "Mark a bill (creditor invoice) as paid",
+        inputSchema: {
+            type: "object",
+            properties: {
+                bill_id: {
+                    type: "integer",
+                    description: "The ID of the bill to mark as paid",
+                },
+            },
+            required: ["bill_id"],
+        },
+    },
+    // ===== EXPENSES =====
+    {
+        name: "list_expenses",
+        description: "List all expenses with optional pagination",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of expenses to return (default: 50)",
+                },
+                offset: {
+                    type: "integer",
+                    description: "Number of expenses to skip (default: 0)",
+                },
+            },
+        },
+    },
+    {
+        name: "get_expense",
+        description: "Get a specific expense by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                expense_id: {
+                    type: "integer",
+                    description: "The ID of the expense to retrieve",
+                },
+            },
+            required: ["expense_id"],
+        },
+    },
+    {
+        name: "create_expense",
+        description: "Create a new expense record",
+        inputSchema: {
+            type: "object",
+            properties: {
+                expense_data: {
+                    type: "object",
+                    description: "Expense data including title, amount, date, etc.",
+                },
+            },
+            required: ["expense_data"],
+        },
+    },
+    {
+        name: "update_expense",
+        description: "Update an existing expense",
+        inputSchema: {
+            type: "object",
+            properties: {
+                expense_id: {
+                    type: "integer",
+                    description: "The ID of the expense to update",
+                },
+                expense_data: {
+                    type: "object",
+                    description: "Expense data to update",
+                },
+            },
+            required: ["expense_id", "expense_data"],
+        },
+    },
+    {
+        name: "delete_expense",
+        description: "Delete an expense",
+        inputSchema: {
+            type: "object",
+            properties: {
+                expense_id: {
+                    type: "integer",
+                    description: "The ID of the expense to delete",
+                },
+            },
+            required: ["expense_id"],
+        },
+    },
+    // ===== PURCHASE ORDERS =====
+    {
+        name: "list_purchase_orders",
+        description: "List all purchase orders with optional pagination",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of purchase orders to return (default: 50)",
+                },
+                offset: {
+                    type: "integer",
+                    description: "Number of purchase orders to skip (default: 0)",
+                },
+            },
+        },
+    },
+    {
+        name: "get_purchase_order",
+        description: "Get a specific purchase order by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                purchase_order_id: {
+                    type: "integer",
+                    description: "The ID of the purchase order to retrieve",
+                },
+            },
+            required: ["purchase_order_id"],
+        },
+    },
+    {
+        name: "create_purchase_order",
+        description: "Create a new purchase order to a supplier",
+        inputSchema: {
+            type: "object",
+            properties: {
+                purchase_order_data: {
+                    type: "object",
+                    description: "Purchase order data including contact_id, title, positions, etc.",
+                },
+            },
+            required: ["purchase_order_data"],
+        },
+    },
+    {
+        name: "update_purchase_order",
+        description: "Update an existing purchase order",
+        inputSchema: {
+            type: "object",
+            properties: {
+                purchase_order_id: {
+                    type: "integer",
+                    description: "The ID of the purchase order to update",
+                },
+                purchase_order_data: {
+                    type: "object",
+                    description: "Purchase order data to update",
+                },
+            },
+            required: ["purchase_order_id", "purchase_order_data"],
+        },
+    },
+    {
+        name: "delete_purchase_order",
+        description: "Delete a purchase order",
+        inputSchema: {
+            type: "object",
+            properties: {
+                purchase_order_id: {
+                    type: "integer",
+                    description: "The ID of the purchase order to delete",
+                },
+            },
+            required: ["purchase_order_id"],
+        },
+    },
+    // ===== OUTGOING PAYMENTS (linked to bills) =====
+    {
+        name: "list_outgoing_payments",
+        description: "List all outgoing payments for a specific bill (creditor invoice)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                bill_id: {
+                    type: "integer",
+                    description: "The ID of the bill to get payments for",
+                },
+            },
+            required: ["bill_id"],
+        },
+    },
+    {
+        name: "get_outgoing_payment",
+        description: "Get a specific outgoing payment for a bill (creditor invoice)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                bill_id: {
+                    type: "integer",
+                    description: "The ID of the bill",
+                },
+                payment_id: {
+                    type: "integer",
+                    description: "The ID of the payment to retrieve",
+                },
+            },
+            required: ["bill_id", "payment_id"],
+        },
+    },
+    {
+        name: "create_outgoing_payment",
+        description: "Create a new outgoing payment for a bill (creditor invoice)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                bill_id: {
+                    type: "integer",
+                    description: "The ID of the bill to create a payment for",
+                },
+                payment_data: {
+                    type: "object",
+                    description: "Payment data including amount, date, etc.",
+                },
+            },
+            required: ["bill_id", "payment_data"],
+        },
+    },
+    {
+        name: "update_outgoing_payment",
+        description: "Update an existing outgoing payment for a bill (creditor invoice)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                bill_id: {
+                    type: "integer",
+                    description: "The ID of the bill",
+                },
+                payment_id: {
+                    type: "integer",
+                    description: "The ID of the payment to update",
+                },
+                payment_data: {
+                    type: "object",
+                    description: "Payment data to update",
+                },
+            },
+            required: ["bill_id", "payment_id", "payment_data"],
+        },
+    },
+    {
+        name: "delete_outgoing_payment",
+        description: "Delete an outgoing payment for a bill (creditor invoice)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                bill_id: {
+                    type: "integer",
+                    description: "The ID of the bill",
+                },
+                payment_id: {
+                    type: "integer",
+                    description: "The ID of the payment to delete",
+                },
+            },
+            required: ["bill_id", "payment_id"],
+        },
+    },
+];

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

@@ -0,0 +1,7 @@
+/**
+ * Purchase tool handlers.
+ * Implements the logic for bills, expenses, purchase orders, and outgoing payments.
+ */
+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/purchase/handlers.js

@@ -0,0 +1,120 @@
+/**
+ * Purchase tool handlers.
+ * Implements the logic for bills, expenses, purchase orders, and outgoing payments.
+ */
+import { McpError } from "../../shared/errors.js";
+import { ListBillsParamsSchema, GetBillParamsSchema, CreateBillParamsSchema, UpdateBillParamsSchema, DeleteBillParamsSchema, SearchBillsParamsSchema, IssueBillParamsSchema, MarkBillAsPaidParamsSchema, ListExpensesParamsSchema, GetExpenseParamsSchema, CreateExpenseParamsSchema, UpdateExpenseParamsSchema, DeleteExpenseParamsSchema, ListPurchaseOrdersParamsSchema, GetPurchaseOrderParamsSchema, CreatePurchaseOrderParamsSchema, UpdatePurchaseOrderParamsSchema, DeletePurchaseOrderParamsSchema, ListOutgoingPaymentsParamsSchema, GetOutgoingPaymentParamsSchema, CreateOutgoingPaymentParamsSchema, UpdateOutgoingPaymentParamsSchema, DeleteOutgoingPaymentParamsSchema, } from "../../types/index.js";
+export const handlers = {
+    // ===== BILLS =====
+    list_bills: async (client, args) => {
+        const { limit, offset } = ListBillsParamsSchema.parse(args);
+        return client.listBills({ limit, offset });
+    },
+    get_bill: async (client, args) => {
+        const { bill_id } = GetBillParamsSchema.parse(args);
+        const bill = await client.getBill(bill_id);
+        if (!bill) {
+            throw McpError.notFound("Bill", bill_id);
+        }
+        return bill;
+    },
+    create_bill: async (client, args) => {
+        const { bill_data } = CreateBillParamsSchema.parse(args);
+        return client.createBill(bill_data);
+    },
+    update_bill: async (client, args) => {
+        const { bill_id, bill_data } = UpdateBillParamsSchema.parse(args);
+        return client.updateBill(bill_id, bill_data);
+    },
+    delete_bill: async (client, args) => {
+        const { bill_id } = DeleteBillParamsSchema.parse(args);
+        return client.deleteBill(bill_id);
+    },
+    search_bills: async (client, args) => {
+        const { criteria, limit, offset } = SearchBillsParamsSchema.parse(args);
+        return client.searchBills(criteria, { limit, offset });
+    },
+    issue_bill: async (client, args) => {
+        const { bill_id } = IssueBillParamsSchema.parse(args);
+        return client.issueBill(bill_id);
+    },
+    mark_bill_as_paid: async (client, args) => {
+        const { bill_id } = MarkBillAsPaidParamsSchema.parse(args);
+        return client.markBillAsPaid(bill_id);
+    },
+    // ===== EXPENSES =====
+    list_expenses: async (client, args) => {
+        const { limit, offset } = ListExpensesParamsSchema.parse(args);
+        return client.listExpenses({ limit, offset });
+    },
+    get_expense: async (client, args) => {
+        const { expense_id } = GetExpenseParamsSchema.parse(args);
+        const expense = await client.getExpense(expense_id);
+        if (!expense) {
+            throw McpError.notFound("Expense", expense_id);
+        }
+        return expense;
+    },
+    create_expense: async (client, args) => {
+        const { expense_data } = CreateExpenseParamsSchema.parse(args);
+        return client.createExpense(expense_data);
+    },
+    update_expense: async (client, args) => {
+        const { expense_id, expense_data } = UpdateExpenseParamsSchema.parse(args);
+        return client.updateExpense(expense_id, expense_data);
+    },
+    delete_expense: async (client, args) => {
+        const { expense_id } = DeleteExpenseParamsSchema.parse(args);
+        return client.deleteExpense(expense_id);
+    },
+    // ===== PURCHASE ORDERS =====
+    list_purchase_orders: async (client, args) => {
+        const { limit, offset } = ListPurchaseOrdersParamsSchema.parse(args);
+        return client.listPurchaseOrders({ limit, offset });
+    },
+    get_purchase_order: async (client, args) => {
+        const { purchase_order_id } = GetPurchaseOrderParamsSchema.parse(args);
+        const purchaseOrder = await client.getPurchaseOrder(purchase_order_id);
+        if (!purchaseOrder) {
+            throw McpError.notFound("Purchase Order", purchase_order_id);
+        }
+        return purchaseOrder;
+    },
+    create_purchase_order: async (client, args) => {
+        const { purchase_order_data } = CreatePurchaseOrderParamsSchema.parse(args);
+        return client.createPurchaseOrder(purchase_order_data);
+    },
+    update_purchase_order: async (client, args) => {
+        const { purchase_order_id, purchase_order_data } = UpdatePurchaseOrderParamsSchema.parse(args);
+        return client.updatePurchaseOrder(purchase_order_id, purchase_order_data);
+    },
+    delete_purchase_order: async (client, args) => {
+        const { purchase_order_id } = DeletePurchaseOrderParamsSchema.parse(args);
+        return client.deletePurchaseOrder(purchase_order_id);
+    },
+    // ===== OUTGOING PAYMENTS (linked to bills) =====
+    list_outgoing_payments: async (client, args) => {
+        const { bill_id } = ListOutgoingPaymentsParamsSchema.parse(args);
+        return client.listOutgoingPayments(bill_id);
+    },
+    get_outgoing_payment: async (client, args) => {
+        const { bill_id, payment_id } = GetOutgoingPaymentParamsSchema.parse(args);
+        const payment = await client.getOutgoingPayment(bill_id, payment_id);
+        if (!payment) {
+            throw McpError.notFound("Outgoing Payment", payment_id);
+        }
+        return payment;
+    },
+    create_outgoing_payment: async (client, args) => {
+        const { bill_id, payment_data } = CreateOutgoingPaymentParamsSchema.parse(args);
+        return client.createOutgoingPayment(bill_id, payment_data);
+    },
+    update_outgoing_payment: async (client, args) => {
+        const { bill_id, payment_id, payment_data } = UpdateOutgoingPaymentParamsSchema.parse(args);
+        return client.updateOutgoingPayment(bill_id, payment_id, payment_data);
+    },
+    delete_outgoing_payment: async (client, args) => {
+        const { bill_id, payment_id } = DeleteOutgoingPaymentParamsSchema.parse(args);
+        return client.deleteOutgoingPayment(bill_id, payment_id);
+    },
+};

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

@@ -0,0 +1,7 @@
+/**
+ * Purchase domain module.
+ * Exports tool definitions and handlers for bills and expenses.
+ */
+export { toolDefinitions } from "./definitions.js";
+export { handlers } from "./handlers.js";
+export type { HandlerFn } from "./handlers.js";

package/dist/tools/purchase/index.js

@@ -0,0 +1,6 @@
+/**
+ * Purchase domain module.
+ * Exports tool definitions and handlers for bills and expenses.
+ */
+export { toolDefinitions } from "./definitions.js";
+export { handlers } from "./handlers.js";

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

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