@promptpartner/bexio-mcp-server 2.0.0

package/dist/tools/contacts/definitions.js

@@ -0,0 +1,150 @@
+/**
+ * Contact tool definitions.
+ * Contains MCP tool metadata for contacts domain.
+ */
+export const toolDefinitions = [
+    {
+        name: "list_contacts",
+        description: "List contacts from Bexio with optional pagination and filtering",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of contacts to return (default: 50)",
+                    default: 50,
+                },
+                offset: {
+                    type: "integer",
+                    description: "Number of contacts to skip (default: 0)",
+                    default: 0,
+                },
+                search_term: {
+                    type: "string",
+                    description: "Search term to filter contacts by name, email, etc.",
+                },
+                contact_type_id: {
+                    type: "integer",
+                    description: "Filter by contact type ID (1=Person, 2=Company)",
+                },
+            },
+        },
+    },
+    {
+        name: "get_contact",
+        description: "Get a specific contact by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                contact_id: {
+                    type: "integer",
+                    description: "The ID of the contact to retrieve",
+                },
+            },
+            required: ["contact_id"],
+        },
+    },
+    {
+        name: "search_contacts",
+        description: "Search contacts by name, email, or other fields",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Search query to find contacts",
+                },
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of contacts to return (default: 50)",
+                    default: 50,
+                },
+            },
+            required: ["query"],
+        },
+    },
+    {
+        name: "advanced_search_contacts",
+        description: "Perform advanced search on contacts using multiple criteria",
+        inputSchema: {
+            type: "object",
+            properties: {
+                search_criteria: {
+                    type: "array",
+                    description: "List of search criteria with field, value, and criteria",
+                    items: {
+                        type: "object",
+                        properties: {
+                            field: {
+                                type: "string",
+                                description: "Field to search (e.g., 'name_1', 'mail', 'city', 'nr')",
+                            },
+                            value: {
+                                type: "string",
+                                description: "Value to search for",
+                            },
+                            criteria: {
+                                type: "string",
+                                description: "Search operator ('like', '=', '>', '<', etc.)",
+                                default: "like",
+                            },
+                        },
+                        required: ["field", "value"],
+                    },
+                },
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of contacts to return (default: 50)",
+                    default: 50,
+                },
+            },
+            required: ["search_criteria"],
+        },
+    },
+    {
+        name: "find_contact_by_number",
+        description: "Find a specific contact by its contact number (e.g., '001008')",
+        inputSchema: {
+            type: "object",
+            properties: {
+                contact_number: {
+                    type: "string",
+                    description: "The contact number to search for (e.g., '001008')",
+                },
+            },
+            required: ["contact_number"],
+        },
+    },
+    {
+        name: "find_contact_by_name",
+        description: "Find contacts by name (searches through all pages)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "The name to search for",
+                },
+            },
+            required: ["name"],
+        },
+    },
+    {
+        name: "update_contact",
+        description: "Update an existing contact's information",
+        inputSchema: {
+            type: "object",
+            properties: {
+                contact_id: {
+                    type: "integer",
+                    description: "The ID of the contact to update",
+                },
+                contact_data: {
+                    type: "object",
+                    description: "Contact fields to update",
+                },
+            },
+            required: ["contact_id", "contact_data"],
+        },
+    },
+];

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

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

@@ -0,0 +1,40 @@
+/**
+ * Contact tool handlers.
+ * Implements the logic for each contact tool.
+ */
+import { McpError } from "../../shared/errors.js";
+import { ListContactsParamsSchema, GetContactParamsSchema, SearchContactsParamsSchema, AdvancedSearchContactsParamsSchema, FindContactByNumberParamsSchema, FindContactByNameParamsSchema, UpdateContactParamsSchema, } from "../../types/index.js";
+export const handlers = {
+    list_contacts: async (client, args) => {
+        const params = ListContactsParamsSchema.parse(args);
+        return client.listContacts(params);
+    },
+    get_contact: async (client, args) => {
+        const { contact_id } = GetContactParamsSchema.parse(args);
+        const contact = await client.getContact(contact_id);
+        if (!contact) {
+            throw McpError.notFound("Contact", contact_id);
+        }
+        return contact;
+    },
+    search_contacts: async (client, args) => {
+        const { query, limit } = SearchContactsParamsSchema.parse(args);
+        return client.searchContacts(query, limit);
+    },
+    advanced_search_contacts: async (client, args) => {
+        const { search_criteria, limit } = AdvancedSearchContactsParamsSchema.parse(args);
+        return client.advancedSearchContacts(search_criteria, limit);
+    },
+    find_contact_by_number: async (client, args) => {
+        const { contact_number } = FindContactByNumberParamsSchema.parse(args);
+        return client.findContactByNumber(contact_number);
+    },
+    find_contact_by_name: async (client, args) => {
+        const { name } = FindContactByNameParamsSchema.parse(args);
+        return client.findContactByName(name);
+    },
+    update_contact: async (client, args) => {
+        const { contact_id, contact_data } = UpdateContactParamsSchema.parse(args);
+        return client.updateContact(contact_id, contact_data);
+    },
+};

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

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

package/dist/tools/contacts/index.js

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

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

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

package/dist/tools/deliveries/definitions.js

@@ -0,0 +1,67 @@
+/**
+ * Delivery tool definitions.
+ * Contains MCP tool metadata for deliveries domain.
+ */
+export const toolDefinitions = [
+    {
+        name: "list_deliveries",
+        description: "List deliveries from Bexio with optional pagination",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of deliveries to return (default: 50)",
+                    default: 50,
+                },
+                offset: {
+                    type: "integer",
+                    description: "Number of deliveries to skip (default: 0)",
+                    default: 0,
+                },
+            },
+        },
+    },
+    {
+        name: "get_delivery",
+        description: "Get a specific delivery by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                delivery_id: {
+                    type: "integer",
+                    description: "The ID of the delivery to retrieve",
+                },
+            },
+            required: ["delivery_id"],
+        },
+    },
+    {
+        name: "issue_delivery",
+        description: "Issue a delivery",
+        inputSchema: {
+            type: "object",
+            properties: {
+                delivery_id: {
+                    type: "integer",
+                    description: "The ID of the delivery to issue",
+                },
+            },
+            required: ["delivery_id"],
+        },
+    },
+    {
+        name: "search_deliveries",
+        description: "Search deliveries with filters",
+        inputSchema: {
+            type: "object",
+            properties: {
+                search_params: {
+                    type: "object",
+                    description: "Search parameters for deliveries",
+                },
+            },
+            required: ["search_params"],
+        },
+    },
+];

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

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

@@ -0,0 +1,28 @@
+/**
+ * Delivery tool handlers.
+ * Implements the logic for each delivery tool.
+ */
+import { McpError } from "../../shared/errors.js";
+import { ListDeliveriesParamsSchema, GetDeliveryParamsSchema, IssueDeliveryParamsSchema, SearchDeliveriesParamsSchema, } from "../../types/index.js";
+export const handlers = {
+    list_deliveries: async (client, args) => {
+        const params = ListDeliveriesParamsSchema.parse(args);
+        return client.listDeliveries(params);
+    },
+    get_delivery: async (client, args) => {
+        const { delivery_id } = GetDeliveryParamsSchema.parse(args);
+        const delivery = await client.getDelivery(delivery_id);
+        if (!delivery) {
+            throw McpError.notFound("Delivery", delivery_id);
+        }
+        return delivery;
+    },
+    issue_delivery: async (client, args) => {
+        const { delivery_id } = IssueDeliveryParamsSchema.parse(args);
+        return client.issueDelivery(delivery_id);
+    },
+    search_deliveries: async (client, args) => {
+        const { search_params } = SearchDeliveriesParamsSchema.parse(args);
+        return client.searchDeliveries(search_params);
+    },
+};

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

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

package/dist/tools/deliveries/index.js

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

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

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

package/dist/tools/files/definitions.js

@@ -0,0 +1,217 @@
+/**
+ * Files and Additional Addresses tool definitions.
+ * Contains MCP tool metadata for files domain.
+ */
+export const toolDefinitions = [
+    // ===== FILES =====
+    {
+        name: "list_files",
+        description: "List files from Bexio with optional pagination",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of files to return (default: 50)",
+                    default: 50,
+                },
+                offset: {
+                    type: "integer",
+                    description: "Number of files to skip (default: 0)",
+                    default: 0,
+                },
+            },
+        },
+    },
+    {
+        name: "get_file",
+        description: "Get a specific file's metadata by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                file_id: {
+                    type: "integer",
+                    description: "The ID of the file to retrieve",
+                },
+            },
+            required: ["file_id"],
+        },
+    },
+    {
+        name: "upload_file",
+        description: "Upload a file to Bexio. File content must be provided as base64 encoded string for MCP JSON transport.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "The filename including extension (e.g., 'document.pdf')",
+                },
+                content_base64: {
+                    type: "string",
+                    description: "The file content encoded as base64 string",
+                },
+                content_type: {
+                    type: "string",
+                    description: "The MIME type of the file (e.g., 'application/pdf', 'image/png')",
+                },
+            },
+            required: ["name", "content_base64", "content_type"],
+        },
+    },
+    {
+        name: "download_file",
+        description: "Download a file's content from Bexio. Returns the file content as base64 encoded string for MCP JSON transport.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                file_id: {
+                    type: "integer",
+                    description: "The ID of the file to download",
+                },
+            },
+            required: ["file_id"],
+        },
+    },
+    {
+        name: "update_file",
+        description: "Update a file's metadata in Bexio",
+        inputSchema: {
+            type: "object",
+            properties: {
+                file_id: {
+                    type: "integer",
+                    description: "The ID of the file to update",
+                },
+                file_data: {
+                    type: "object",
+                    description: "File metadata to update (e.g., name, description)",
+                },
+            },
+            required: ["file_id", "file_data"],
+        },
+    },
+    {
+        name: "delete_file",
+        description: "Delete a file from Bexio",
+        inputSchema: {
+            type: "object",
+            properties: {
+                file_id: {
+                    type: "integer",
+                    description: "The ID of the file to delete",
+                },
+            },
+            required: ["file_id"],
+        },
+    },
+    // ===== ADDITIONAL ADDRESSES =====
+    {
+        name: "list_additional_addresses",
+        description: "List additional addresses for a contact",
+        inputSchema: {
+            type: "object",
+            properties: {
+                contact_id: {
+                    type: "integer",
+                    description: "The ID of the contact",
+                },
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of addresses to return (default: 50)",
+                    default: 50,
+                },
+                offset: {
+                    type: "integer",
+                    description: "Number of addresses to skip (default: 0)",
+                    default: 0,
+                },
+            },
+            required: ["contact_id"],
+        },
+    },
+    {
+        name: "get_additional_address",
+        description: "Get a specific additional address for a contact",
+        inputSchema: {
+            type: "object",
+            properties: {
+                contact_id: {
+                    type: "integer",
+                    description: "The ID of the contact",
+                },
+                address_id: {
+                    type: "integer",
+                    description: "The ID of the additional address",
+                },
+            },
+            required: ["contact_id", "address_id"],
+        },
+    },
+    {
+        name: "create_additional_address",
+        description: "Create an additional address for a contact",
+        inputSchema: {
+            type: "object",
+            properties: {
+                contact_id: {
+                    type: "integer",
+                    description: "The ID of the contact",
+                },
+                address_data: {
+                    type: "object",
+                    description: "The address data",
+                    properties: {
+                        name: {
+                            type: "string",
+                            description: "Name/label for the address",
+                        },
+                        address: {
+                            type: "string",
+                            description: "Street address",
+                        },
+                        postcode: {
+                            type: "string",
+                            description: "Postal code",
+                        },
+                        city: {
+                            type: "string",
+                            description: "City",
+                        },
+                        country_id: {
+                            type: "integer",
+                            description: "Country ID",
+                        },
+                        subject: {
+                            type: "string",
+                            description: "Subject/purpose of the address",
+                        },
+                        description: {
+                            type: "string",
+                            description: "Additional description",
+                        },
+                    },
+                },
+            },
+            required: ["contact_id", "address_data"],
+        },
+    },
+    {
+        name: "delete_additional_address",
+        description: "Delete an additional address from a contact",
+        inputSchema: {
+            type: "object",
+            properties: {
+                contact_id: {
+                    type: "integer",
+                    description: "The ID of the contact",
+                },
+                address_id: {
+                    type: "integer",
+                    description: "The ID of the additional address to delete",
+                },
+            },
+            required: ["contact_id", "address_id"],
+        },
+    },
+];

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

@@ -0,0 +1,7 @@
+/**
+ * Files and Additional Addresses tool handlers.
+ * Implements the logic for each files domain 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/files/handlers.js

@@ -0,0 +1,63 @@
+/**
+ * Files and Additional Addresses tool handlers.
+ * Implements the logic for each files domain tool.
+ */
+import { McpError } from "../../shared/errors.js";
+import { ListFilesParamsSchema, GetFileParamsSchema, UploadFileParamsSchema, DownloadFileParamsSchema, UpdateFileParamsSchema, DeleteFileParamsSchema, ListAdditionalAddressesParamsSchema, GetAdditionalAddressParamsSchema, CreateAdditionalAddressParamsSchema, DeleteAdditionalAddressParamsSchema, } from "../../types/index.js";
+export const handlers = {
+    // ===== FILES =====
+    list_files: async (client, args) => {
+        const params = ListFilesParamsSchema.parse(args);
+        return client.listFiles(params);
+    },
+    get_file: async (client, args) => {
+        const { file_id } = GetFileParamsSchema.parse(args);
+        const file = await client.getFile(file_id);
+        if (!file) {
+            throw McpError.notFound("File", file_id);
+        }
+        return file;
+    },
+    upload_file: async (client, args) => {
+        const params = UploadFileParamsSchema.parse(args);
+        return client.uploadFile(params);
+    },
+    download_file: async (client, args) => {
+        const { file_id } = DownloadFileParamsSchema.parse(args);
+        const content_base64 = await client.downloadFile(file_id);
+        return {
+            file_id,
+            content_base64,
+            message: "File content returned as base64 encoded string",
+        };
+    },
+    update_file: async (client, args) => {
+        const { file_id, file_data } = UpdateFileParamsSchema.parse(args);
+        return client.updateFile(file_id, file_data);
+    },
+    delete_file: async (client, args) => {
+        const { file_id } = DeleteFileParamsSchema.parse(args);
+        return client.deleteFile(file_id);
+    },
+    // ===== ADDITIONAL ADDRESSES =====
+    list_additional_addresses: async (client, args) => {
+        const { contact_id, limit, offset } = ListAdditionalAddressesParamsSchema.parse(args);
+        return client.listAdditionalAddresses(contact_id, { limit, offset });
+    },
+    get_additional_address: async (client, args) => {
+        const { contact_id, address_id } = GetAdditionalAddressParamsSchema.parse(args);
+        const address = await client.getAdditionalAddress(contact_id, address_id);
+        if (!address) {
+            throw McpError.notFound("Additional Address", address_id);
+        }
+        return address;
+    },
+    create_additional_address: async (client, args) => {
+        const { contact_id, address_data } = CreateAdditionalAddressParamsSchema.parse(args);
+        return client.createAdditionalAddress(contact_id, address_data);
+    },
+    delete_additional_address: async (client, args) => {
+        const { contact_id, address_id } = DeleteAdditionalAddressParamsSchema.parse(args);
+        return client.deleteAdditionalAddress(contact_id, address_id);
+    },
+};

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

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

package/dist/tools/files/index.js

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

package/dist/tools/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 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
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+import { BexioClient } from "../bexio-client.js";
+export type HandlerFn = (client: BexioClient, args: unknown) => Promise<unknown>;
+/** Get all tool definitions for registration */
+export declare function getAllToolDefinitions(): Tool[];
+/** Get handler for a specific tool */
+export declare function getHandler(toolName: string): HandlerFn | undefined;
+/** Create handler registry bound to a client */
+export declare function createHandlerRegistry(client: BexioClient): Map<string, (args: unknown) => Promise<unknown>>;