@promptpartner/bexio-mcp-server 2.0.0

package/dist/tools/timetracking/definitions.js

@@ -0,0 +1,226 @@
+/**
+ * Time Tracking tool definitions.
+ * Contains MCP tool metadata for time tracking domain.
+ * Includes: Timesheets, Timesheet Statuses, Business Activities, Communication Types
+ *
+ * IMPORTANT: Duration format for timesheets is "HH:MM" (e.g., "02:30" for 2.5 hours).
+ */
+export const toolDefinitions = [
+    // ===== TIMESHEETS (PROJ-06) =====
+    {
+        name: "list_timesheets",
+        description: "List all timesheet entries with pagination",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of results to return (default: 100)",
+                    default: 100,
+                },
+                offset: {
+                    type: "integer",
+                    description: "Number of results to skip (default: 0)",
+                    default: 0,
+                },
+            },
+        },
+    },
+    {
+        name: "get_timesheet",
+        description: "Get a specific timesheet entry by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                timesheet_id: {
+                    type: "integer",
+                    description: "The ID of the timesheet entry to retrieve",
+                },
+            },
+            required: ["timesheet_id"],
+        },
+    },
+    {
+        name: "create_timesheet",
+        description: "Create a new timesheet entry. Duration must be in HH:MM format (e.g., '02:30' for 2.5 hours)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                user_id: {
+                    type: "integer",
+                    description: "The ID of the user who worked (required)",
+                },
+                date: {
+                    type: "string",
+                    description: "Date of the work in YYYY-MM-DD format (required)",
+                },
+                duration: {
+                    type: "string",
+                    description: "Duration of work in HH:MM format, e.g., '02:30' for 2 hours 30 minutes (required)",
+                },
+                pr_project_id: {
+                    type: "integer",
+                    description: "ID of the project to link this timesheet to (optional)",
+                },
+                pr_package_id: {
+                    type: "integer",
+                    description: "ID of the work package to link this timesheet to (optional)",
+                },
+                pr_milestone_id: {
+                    type: "integer",
+                    description: "ID of the milestone to link this timesheet to (optional)",
+                },
+                client_service_id: {
+                    type: "integer",
+                    description: "ID of the business activity/service type (optional)",
+                },
+                text: {
+                    type: "string",
+                    description: "Description of the work performed (optional)",
+                },
+                allowable_bill: {
+                    type: "boolean",
+                    description: "Whether this time is billable (default: true)",
+                    default: true,
+                },
+            },
+            required: ["user_id", "date", "duration"],
+        },
+    },
+    {
+        name: "delete_timesheet",
+        description: "Delete a timesheet entry by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                timesheet_id: {
+                    type: "integer",
+                    description: "The ID of the timesheet entry to delete",
+                },
+            },
+            required: ["timesheet_id"],
+        },
+    },
+    {
+        name: "search_timesheets",
+        description: "Search timesheets by criteria (field, value, criteria). Common fields: user_id, pr_project_id, date",
+        inputSchema: {
+            type: "object",
+            properties: {
+                search_criteria: {
+                    type: "array",
+                    description: "Array of search criteria objects with field, value, and optional criteria properties",
+                    items: {
+                        type: "object",
+                        properties: {
+                            field: {
+                                type: "string",
+                                description: "Field name to search (e.g., user_id, pr_project_id, date)",
+                            },
+                            value: {
+                                description: "Value to search for",
+                            },
+                            criteria: {
+                                type: "string",
+                                description: "Comparison operator (e.g., '=', 'like', '>', '<')",
+                            },
+                        },
+                        required: ["field", "value"],
+                    },
+                },
+            },
+            required: ["search_criteria"],
+        },
+    },
+    // ===== TIMESHEET STATUSES (PROJ-07) =====
+    {
+        name: "list_timesheet_statuses",
+        description: "List all timesheet statuses (e.g., open, approved, locked)",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    // ===== BUSINESS ACTIVITIES (PROJ-08) =====
+    {
+        name: "list_business_activities",
+        description: "List business activities (service types for time tracking). Used to categorize work.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of results to return (default: 100)",
+                    default: 100,
+                },
+                offset: {
+                    type: "integer",
+                    description: "Number of results to skip (default: 0)",
+                    default: 0,
+                },
+            },
+        },
+    },
+    {
+        name: "get_business_activity",
+        description: "Get a specific business activity by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                activity_id: {
+                    type: "integer",
+                    description: "The ID of the business activity to retrieve",
+                },
+            },
+            required: ["activity_id"],
+        },
+    },
+    {
+        name: "create_business_activity",
+        description: "Create a new business activity (service type for time tracking)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "The name of the business activity",
+                },
+            },
+            required: ["name"],
+        },
+    },
+    // ===== COMMUNICATION TYPES (PROJ-09) =====
+    {
+        name: "list_communication_types",
+        description: "List all communication types (e.g., email, phone, meeting)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of results to return (default: 100)",
+                    default: 100,
+                },
+                offset: {
+                    type: "integer",
+                    description: "Number of results to skip (default: 0)",
+                    default: 0,
+                },
+            },
+        },
+    },
+    {
+        name: "get_communication_type",
+        description: "Get a specific communication type by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                type_id: {
+                    type: "integer",
+                    description: "The ID of the communication type to retrieve",
+                },
+            },
+            required: ["type_id"],
+        },
+    },
+];

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

@@ -0,0 +1,9 @@
+/**
+ * Time Tracking tool handlers.
+ * Implements the logic for each time tracking tool.
+ *
+ * IMPORTANT: Duration format for timesheets is "HH:MM" (e.g., "02:30" for 2.5 hours).
+ */
+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/timetracking/handlers.js

@@ -0,0 +1,88 @@
+/**
+ * Time Tracking tool handlers.
+ * Implements the logic for each time tracking tool.
+ *
+ * IMPORTANT: Duration format for timesheets is "HH:MM" (e.g., "02:30" for 2.5 hours).
+ */
+import { McpError } from "../../shared/errors.js";
+import { 
+// Timesheets
+ListTimesheetsParamsSchema, GetTimesheetParamsSchema, CreateTimesheetParamsSchema, DeleteTimesheetParamsSchema, SearchTimesheetsParamsSchema, 
+// Timesheet Statuses
+ListTimesheetStatusesParamsSchema, 
+// Business Activities
+ListBusinessActivitiesParamsSchema, GetBusinessActivityParamsSchema, CreateBusinessActivityParamsSchema, 
+// Communication Types
+ListCommunicationTypesParamsSchema, GetCommunicationTypeParamsSchema, } from "../../types/index.js";
+export const handlers = {
+    // ===== TIMESHEETS (PROJ-06) =====
+    list_timesheets: async (client, args) => {
+        const params = ListTimesheetsParamsSchema.parse(args);
+        return client.listTimesheets(params);
+    },
+    get_timesheet: async (client, args) => {
+        const { timesheet_id } = GetTimesheetParamsSchema.parse(args);
+        const timesheet = await client.getTimesheet(timesheet_id);
+        if (!timesheet) {
+            throw McpError.notFound("Timesheet", timesheet_id);
+        }
+        return timesheet;
+    },
+    create_timesheet: async (client, args) => {
+        const params = CreateTimesheetParamsSchema.parse(args);
+        return client.createTimesheet({
+            user_id: params.user_id,
+            date: params.date,
+            duration: params.duration,
+            pr_project_id: params.pr_project_id,
+            pr_package_id: params.pr_package_id,
+            pr_milestone_id: params.pr_milestone_id,
+            client_service_id: params.client_service_id,
+            text: params.text,
+            allowable_bill: params.allowable_bill,
+        });
+    },
+    delete_timesheet: async (client, args) => {
+        const { timesheet_id } = DeleteTimesheetParamsSchema.parse(args);
+        return client.deleteTimesheet(timesheet_id);
+    },
+    search_timesheets: async (client, args) => {
+        const { search_criteria } = SearchTimesheetsParamsSchema.parse(args);
+        return client.searchTimesheets(search_criteria);
+    },
+    // ===== TIMESHEET STATUSES (PROJ-07) =====
+    list_timesheet_statuses: async (client, args) => {
+        ListTimesheetStatusesParamsSchema.parse(args);
+        return client.listTimesheetStatuses();
+    },
+    // ===== BUSINESS ACTIVITIES (PROJ-08) =====
+    list_business_activities: async (client, args) => {
+        const params = ListBusinessActivitiesParamsSchema.parse(args);
+        return client.listBusinessActivities(params);
+    },
+    get_business_activity: async (client, args) => {
+        const { activity_id } = GetBusinessActivityParamsSchema.parse(args);
+        const activity = await client.getBusinessActivity(activity_id);
+        if (!activity) {
+            throw McpError.notFound("Business Activity", activity_id);
+        }
+        return activity;
+    },
+    create_business_activity: async (client, args) => {
+        const { name } = CreateBusinessActivityParamsSchema.parse(args);
+        return client.createBusinessActivity({ name });
+    },
+    // ===== COMMUNICATION TYPES (PROJ-09) =====
+    list_communication_types: async (client, args) => {
+        const params = ListCommunicationTypesParamsSchema.parse(args);
+        return client.listCommunicationTypes(params);
+    },
+    get_communication_type: async (client, args) => {
+        const { type_id } = GetCommunicationTypeParamsSchema.parse(args);
+        const type = await client.getCommunicationType(type_id);
+        if (!type) {
+            throw McpError.notFound("Communication Type", type_id);
+        }
+        return type;
+    },
+};

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

@@ -0,0 +1,6 @@
+/**
+ * Time Tracking domain barrel export.
+ * Exports tool definitions and handlers for time tracking domain.
+ */
+export { toolDefinitions } from "./definitions.js";
+export { handlers } from "./handlers.js";

package/dist/tools/timetracking/index.js

@@ -0,0 +1,6 @@
+/**
+ * Time Tracking domain barrel export.
+ * Exports tool definitions and handlers for time tracking domain.
+ */
+export { toolDefinitions } from "./definitions.js";
+export { handlers } from "./handlers.js";

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

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

package/dist/tools/users/definitions.js

@@ -0,0 +1,93 @@
+/**
+ * User tool definitions.
+ * Contains MCP tool metadata for users domain.
+ */
+export const toolDefinitions = [
+    {
+        name: "get_current_user",
+        description: "Get the currently authenticated user",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "list_fictional_users",
+        description: "List fictional users from Bexio with optional pagination",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of users to return (default: 50)",
+                    default: 50,
+                },
+                offset: {
+                    type: "integer",
+                    description: "Number of users to skip (default: 0)",
+                    default: 0,
+                },
+            },
+        },
+    },
+    {
+        name: "get_fictional_user",
+        description: "Get a specific fictional user by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                user_id: {
+                    type: "integer",
+                    description: "The ID of the user to retrieve",
+                },
+            },
+            required: ["user_id"],
+        },
+    },
+    {
+        name: "create_fictional_user",
+        description: "Create a new fictional user",
+        inputSchema: {
+            type: "object",
+            properties: {
+                user_data: {
+                    type: "object",
+                    description: "User data to create",
+                },
+            },
+            required: ["user_data"],
+        },
+    },
+    {
+        name: "update_fictional_user",
+        description: "Update a fictional user",
+        inputSchema: {
+            type: "object",
+            properties: {
+                user_id: {
+                    type: "integer",
+                    description: "The ID of the user to update",
+                },
+                user_data: {
+                    type: "object",
+                    description: "User data to update",
+                },
+            },
+            required: ["user_id", "user_data"],
+        },
+    },
+    {
+        name: "delete_fictional_user",
+        description: "Delete a fictional user",
+        inputSchema: {
+            type: "object",
+            properties: {
+                user_id: {
+                    type: "integer",
+                    description: "The ID of the user to delete",
+                },
+            },
+            required: ["user_id"],
+        },
+    },
+];

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

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

@@ -0,0 +1,35 @@
+/**
+ * User tool handlers.
+ * Implements the logic for each user tool.
+ */
+import { McpError } from "../../shared/errors.js";
+import { ListFictionalUsersParamsSchema, GetFictionalUserParamsSchema, CreateFictionalUserParamsSchema, UpdateFictionalUserParamsSchema, DeleteFictionalUserParamsSchema, } from "../../types/index.js";
+export const handlers = {
+    get_current_user: async (client) => {
+        return client.getCurrentUser();
+    },
+    list_fictional_users: async (client, args) => {
+        const params = ListFictionalUsersParamsSchema.parse(args);
+        return client.listFictionalUsers(params);
+    },
+    get_fictional_user: async (client, args) => {
+        const { user_id } = GetFictionalUserParamsSchema.parse(args);
+        const user = await client.getFictionalUser(user_id);
+        if (!user) {
+            throw McpError.notFound("Fictional User", user_id);
+        }
+        return user;
+    },
+    create_fictional_user: async (client, args) => {
+        const { user_data } = CreateFictionalUserParamsSchema.parse(args);
+        return client.createFictionalUser(user_data);
+    },
+    update_fictional_user: async (client, args) => {
+        const { user_id, user_data } = UpdateFictionalUserParamsSchema.parse(args);
+        return client.updateFictionalUser(user_id, user_data);
+    },
+    delete_fictional_user: async (client, args) => {
+        const { user_id } = DeleteFictionalUserParamsSchema.parse(args);
+        return client.deleteFictionalUser(user_id);
+    },
+};

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

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

package/dist/tools/users/index.js

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

package/dist/transports/http.d.ts

@@ -0,0 +1,17 @@
+/**
+ * HTTP Transport for Bexio MCP Server.
+ * Provides HTTP/REST access for n8n and other remote clients.
+ *
+ * IMPORTANT: All logging uses logger (stderr), stdout reserved for nothing in HTTP mode.
+ */
+import { FastifyInstance } from "fastify";
+import { BexioClient } from "../bexio-client.js";
+export interface HttpServerOptions {
+    host: string;
+    port: number;
+}
+/**
+ * Creates an HTTP server for the MCP server.
+ * This enables n8n and other HTTP clients to interact with the Bexio API.
+ */
+export declare function createHttpServer(client: BexioClient, options: HttpServerOptions): Promise<FastifyInstance>;