@promptpartner/bexio-mcp-server 2.0.0

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

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

@@ -0,0 +1,161 @@
+/**
+ * Reference data tool handlers.
+ * Implements the logic for each reference data tool.
+ */
+import { McpError } from "../../shared/errors.js";
+import { 
+// Contact Groups
+ListContactGroupsParamsSchema, GetContactGroupParamsSchema, CreateContactGroupParamsSchema, DeleteContactGroupParamsSchema, 
+// Contact Sectors
+ListContactSectorsParamsSchema, GetContactSectorParamsSchema, CreateContactSectorParamsSchema, 
+// Salutations
+ListSalutationsParamsSchema, GetSalutationParamsSchema, CreateSalutationParamsSchema, DeleteSalutationParamsSchema, 
+// Titles
+ListTitlesParamsSchema, GetTitleParamsSchema, CreateTitleParamsSchema, DeleteTitleParamsSchema, 
+// Countries
+ListCountriesParamsSchema, GetCountryParamsSchema, CreateCountryParamsSchema, DeleteCountryParamsSchema, 
+// Languages
+ListLanguagesParamsSchema, GetLanguageParamsSchema, CreateLanguageParamsSchema, 
+// Units
+ListUnitsParamsSchema, GetUnitParamsSchema, CreateUnitParamsSchema, DeleteUnitParamsSchema, } from "../../types/index.js";
+export const handlers = {
+    // ===== CONTACT GROUPS (REFDATA-01) =====
+    list_contact_groups: async (client, args) => {
+        const params = ListContactGroupsParamsSchema.parse(args);
+        return client.listContactGroups(params);
+    },
+    get_contact_group: async (client, args) => {
+        const { group_id } = GetContactGroupParamsSchema.parse(args);
+        const group = await client.getContactGroup(group_id);
+        if (!group) {
+            throw McpError.notFound("Contact Group", group_id);
+        }
+        return group;
+    },
+    create_contact_group: async (client, args) => {
+        const { name } = CreateContactGroupParamsSchema.parse(args);
+        return client.createContactGroup({ name });
+    },
+    delete_contact_group: async (client, args) => {
+        const { group_id } = DeleteContactGroupParamsSchema.parse(args);
+        return client.deleteContactGroup(group_id);
+    },
+    // ===== CONTACT SECTORS (REFDATA-02) =====
+    list_contact_sectors: async (client, args) => {
+        const params = ListContactSectorsParamsSchema.parse(args);
+        return client.listContactSectors(params);
+    },
+    get_contact_sector: async (client, args) => {
+        const { sector_id } = GetContactSectorParamsSchema.parse(args);
+        const sector = await client.getContactSector(sector_id);
+        if (!sector) {
+            throw McpError.notFound("Contact Sector", sector_id);
+        }
+        return sector;
+    },
+    create_contact_sector: async (client, args) => {
+        const { name } = CreateContactSectorParamsSchema.parse(args);
+        return client.createContactSector({ name });
+    },
+    // ===== SALUTATIONS (REFDATA-03) =====
+    list_salutations: async (client, args) => {
+        const params = ListSalutationsParamsSchema.parse(args);
+        return client.listSalutations(params);
+    },
+    get_salutation: async (client, args) => {
+        const { salutation_id } = GetSalutationParamsSchema.parse(args);
+        const salutation = await client.getSalutation(salutation_id);
+        if (!salutation) {
+            throw McpError.notFound("Salutation", salutation_id);
+        }
+        return salutation;
+    },
+    create_salutation: async (client, args) => {
+        const { name } = CreateSalutationParamsSchema.parse(args);
+        return client.createSalutation({ name });
+    },
+    delete_salutation: async (client, args) => {
+        const { salutation_id } = DeleteSalutationParamsSchema.parse(args);
+        return client.deleteSalutation(salutation_id);
+    },
+    // ===== TITLES (REFDATA-04) =====
+    list_titles: async (client, args) => {
+        const params = ListTitlesParamsSchema.parse(args);
+        return client.listTitles(params);
+    },
+    get_title: async (client, args) => {
+        const { title_id } = GetTitleParamsSchema.parse(args);
+        const title = await client.getTitle(title_id);
+        if (!title) {
+            throw McpError.notFound("Title", title_id);
+        }
+        return title;
+    },
+    create_title: async (client, args) => {
+        const { name } = CreateTitleParamsSchema.parse(args);
+        return client.createTitle({ name });
+    },
+    delete_title: async (client, args) => {
+        const { title_id } = DeleteTitleParamsSchema.parse(args);
+        return client.deleteTitle(title_id);
+    },
+    // ===== COUNTRIES (REFDATA-05) =====
+    list_countries: async (client, args) => {
+        const params = ListCountriesParamsSchema.parse(args);
+        return client.listCountries(params);
+    },
+    get_country: async (client, args) => {
+        const { country_id } = GetCountryParamsSchema.parse(args);
+        const country = await client.getCountry(country_id);
+        if (!country) {
+            throw McpError.notFound("Country", country_id);
+        }
+        return country;
+    },
+    create_country: async (client, args) => {
+        const { name, iso_3166_alpha2 } = CreateCountryParamsSchema.parse(args);
+        return client.createCountry({ name, iso_3166_alpha2 });
+    },
+    delete_country: async (client, args) => {
+        const { country_id } = DeleteCountryParamsSchema.parse(args);
+        return client.deleteCountry(country_id);
+    },
+    // ===== LANGUAGES (REFDATA-06) =====
+    list_languages: async (client, args) => {
+        const params = ListLanguagesParamsSchema.parse(args);
+        return client.listLanguages(params);
+    },
+    get_language: async (client, args) => {
+        const { language_id } = GetLanguageParamsSchema.parse(args);
+        const language = await client.getLanguage(language_id);
+        if (!language) {
+            throw McpError.notFound("Language", language_id);
+        }
+        return language;
+    },
+    create_language: async (client, args) => {
+        const { name, iso_639_1 } = CreateLanguageParamsSchema.parse(args);
+        return client.createLanguage({ name, iso_639_1 });
+    },
+    // ===== UNITS (REFDATA-07) =====
+    list_units: async (client, args) => {
+        const params = ListUnitsParamsSchema.parse(args);
+        return client.listUnits(params);
+    },
+    get_unit: async (client, args) => {
+        const { unit_id } = GetUnitParamsSchema.parse(args);
+        const unit = await client.getUnit(unit_id);
+        if (!unit) {
+            throw McpError.notFound("Unit", unit_id);
+        }
+        return unit;
+    },
+    create_unit: async (client, args) => {
+        const { name } = CreateUnitParamsSchema.parse(args);
+        return client.createUnit({ name });
+    },
+    delete_unit: async (client, args) => {
+        const { unit_id } = DeleteUnitParamsSchema.parse(args);
+        return client.deleteUnit(unit_id);
+    },
+};

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

@@ -0,0 +1,6 @@
+/**
+ * Reference data domain barrel export.
+ * Exports tool definitions and handlers for reference data domain.
+ */
+export { toolDefinitions } from "./definitions.js";
+export { handlers } from "./handlers.js";

package/dist/tools/reference/index.js

@@ -0,0 +1,6 @@
+/**
+ * Reference data domain barrel export.
+ * Exports tool definitions and handlers for reference data domain.
+ */
+export { toolDefinitions } from "./definitions.js";
+export { handlers } from "./handlers.js";

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

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

package/dist/tools/reminders/definitions.js

@@ -0,0 +1,132 @@
+/**
+ * Reminder tool definitions.
+ * Contains MCP tool metadata for reminders/Mahnungen domain.
+ */
+export const toolDefinitions = [
+    {
+        name: "list_reminders",
+        description: "List reminders for a specific invoice",
+        inputSchema: {
+            type: "object",
+            properties: {
+                invoice_id: {
+                    type: "integer",
+                    description: "The ID of the invoice to get reminders for",
+                },
+            },
+            required: ["invoice_id"],
+        },
+    },
+    {
+        name: "get_reminder",
+        description: "Get a specific reminder by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                invoice_id: {
+                    type: "integer",
+                    description: "The ID of the invoice",
+                },
+                reminder_id: {
+                    type: "integer",
+                    description: "The ID of the reminder to retrieve",
+                },
+            },
+            required: ["invoice_id", "reminder_id"],
+        },
+    },
+    {
+        name: "create_reminder",
+        description: "Create a new reminder for an invoice",
+        inputSchema: {
+            type: "object",
+            properties: {
+                invoice_id: {
+                    type: "integer",
+                    description: "The ID of the invoice to create a reminder for",
+                },
+                reminder_data: {
+                    type: "object",
+                    description: "Reminder data to create",
+                },
+            },
+            required: ["invoice_id", "reminder_data"],
+        },
+    },
+    {
+        name: "delete_reminder",
+        description: "Delete a reminder",
+        inputSchema: {
+            type: "object",
+            properties: {
+                invoice_id: {
+                    type: "integer",
+                    description: "The ID of the invoice",
+                },
+                reminder_id: {
+                    type: "integer",
+                    description: "The ID of the reminder to delete",
+                },
+            },
+            required: ["invoice_id", "reminder_id"],
+        },
+    },
+    {
+        name: "mark_reminder_as_sent",
+        description: "Mark a reminder as sent",
+        inputSchema: {
+            type: "object",
+            properties: {
+                invoice_id: {
+                    type: "integer",
+                    description: "The ID of the invoice",
+                },
+                reminder_id: {
+                    type: "integer",
+                    description: "The ID of the reminder to mark as sent",
+                },
+            },
+            required: ["invoice_id", "reminder_id"],
+        },
+    },
+    {
+        name: "send_reminder",
+        description: "Send a reminder",
+        inputSchema: {
+            type: "object",
+            properties: {
+                invoice_id: {
+                    type: "integer",
+                    description: "The ID of the invoice",
+                },
+                reminder_id: {
+                    type: "integer",
+                    description: "The ID of the reminder to send",
+                },
+            },
+            required: ["invoice_id", "reminder_id"],
+        },
+    },
+    {
+        name: "search_reminders",
+        description: "Search reminders with filters",
+        inputSchema: {
+            type: "object",
+            properties: {
+                search_params: {
+                    type: "object",
+                    description: "Search parameters for reminders",
+                },
+            },
+            required: ["search_params"],
+        },
+    },
+    {
+        name: "get_reminders_sent_this_week",
+        description: "Get all reminders sent this week",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+];

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

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

@@ -0,0 +1,43 @@
+/**
+ * Reminder tool handlers.
+ * Implements the logic for each reminder tool.
+ */
+import { McpError } from "../../shared/errors.js";
+import { ListRemindersParamsSchema, GetReminderParamsSchema, CreateReminderParamsSchema, DeleteReminderParamsSchema, MarkReminderAsSentParamsSchema, SendReminderParamsSchema, SearchRemindersParamsSchema, } from "../../types/index.js";
+export const handlers = {
+    list_reminders: async (client, args) => {
+        const { invoice_id } = ListRemindersParamsSchema.parse(args);
+        return client.listReminders(invoice_id);
+    },
+    get_reminder: async (client, args) => {
+        const { invoice_id, reminder_id } = GetReminderParamsSchema.parse(args);
+        const reminder = await client.getReminder(invoice_id, reminder_id);
+        if (!reminder) {
+            throw McpError.notFound("Reminder", reminder_id);
+        }
+        return reminder;
+    },
+    create_reminder: async (client, args) => {
+        const { invoice_id, reminder_data } = CreateReminderParamsSchema.parse(args);
+        return client.createReminder(invoice_id, reminder_data);
+    },
+    delete_reminder: async (client, args) => {
+        const { invoice_id, reminder_id } = DeleteReminderParamsSchema.parse(args);
+        return client.deleteReminder(invoice_id, reminder_id);
+    },
+    mark_reminder_as_sent: async (client, args) => {
+        const { invoice_id, reminder_id } = MarkReminderAsSentParamsSchema.parse(args);
+        return client.markReminderAsSent(invoice_id, reminder_id);
+    },
+    send_reminder: async (client, args) => {
+        const { invoice_id, reminder_id } = SendReminderParamsSchema.parse(args);
+        return client.sendReminder(invoice_id, reminder_id);
+    },
+    search_reminders: async (client, args) => {
+        const { search_params } = SearchRemindersParamsSchema.parse(args);
+        return client.searchReminders(search_params);
+    },
+    get_reminders_sent_this_week: async (client) => {
+        return client.getRemindersSentThisWeek();
+    },
+};

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

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

package/dist/tools/reminders/index.js

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

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

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

package/dist/tools/reports/definitions.js

@@ -0,0 +1,133 @@
+/**
+ * Report tool definitions.
+ * Contains MCP tool metadata for reports and business intelligence domain.
+ */
+export const toolDefinitions = [
+    {
+        name: "get_revenue_report",
+        description: "Get revenue report for a specific period",
+        inputSchema: {
+            type: "object",
+            properties: {
+                start_date: {
+                    type: "string",
+                    format: "date",
+                    description: "Start date for the report (YYYY-MM-DD)",
+                },
+                end_date: {
+                    type: "string",
+                    format: "date",
+                    description: "End date for the report (YYYY-MM-DD)",
+                },
+                group_by: {
+                    type: "string",
+                    description: "Group by field (optional)",
+                },
+            },
+            required: ["start_date", "end_date"],
+        },
+    },
+    {
+        name: "get_customer_revenue_report",
+        description: "Get customer revenue report for a specific period",
+        inputSchema: {
+            type: "object",
+            properties: {
+                start_date: {
+                    type: "string",
+                    format: "date",
+                    description: "Start date for the report (YYYY-MM-DD)",
+                },
+                end_date: {
+                    type: "string",
+                    format: "date",
+                    description: "End date for the report (YYYY-MM-DD)",
+                },
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of customers to return (default: 10)",
+                    default: 10,
+                },
+            },
+            required: ["start_date", "end_date"],
+        },
+    },
+    {
+        name: "get_invoice_status_report",
+        description: "Get invoice status report for a specific period",
+        inputSchema: {
+            type: "object",
+            properties: {
+                start_date: {
+                    type: "string",
+                    format: "date",
+                    description: "Start date for the report (YYYY-MM-DD)",
+                },
+                end_date: {
+                    type: "string",
+                    format: "date",
+                    description: "End date for the report (YYYY-MM-DD)",
+                },
+            },
+            required: ["start_date", "end_date"],
+        },
+    },
+    {
+        name: "get_overdue_invoices_report",
+        description: "Get overdue invoices report",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "get_monthly_revenue_report",
+        description: "Get monthly revenue report for a specific month",
+        inputSchema: {
+            type: "object",
+            properties: {
+                year: {
+                    type: "integer",
+                    description: "Year for the report",
+                },
+                month: {
+                    type: "integer",
+                    description: "Month for the report (1-12)",
+                },
+            },
+            required: ["year", "month"],
+        },
+    },
+    {
+        name: "get_top_customers_by_revenue",
+        description: "Get top customers by revenue",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of customers to return (default: 10)",
+                    default: 10,
+                },
+                start_date: {
+                    type: "string",
+                    format: "date",
+                    description: "Start date for the report (YYYY-MM-DD)",
+                },
+                end_date: {
+                    type: "string",
+                    format: "date",
+                    description: "End date for the report (YYYY-MM-DD)",
+                },
+            },
+        },
+    },
+    {
+        name: "get_tasks_due_this_week",
+        description: "Get all tasks due this week (invoices with due date this week)",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+];

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

@@ -0,0 +1,7 @@
+/**
+ * Report tool handlers.
+ * Implements the logic for each report and business intelligence 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/reports/handlers.js

@@ -0,0 +1,33 @@
+/**
+ * Report tool handlers.
+ * Implements the logic for each report and business intelligence tool.
+ */
+import { GetRevenueReportParamsSchema, GetCustomerRevenueReportParamsSchema, GetInvoiceStatusReportParamsSchema, GetMonthlyRevenueReportParamsSchema, GetTopCustomersByRevenueParamsSchema, } from "../../types/index.js";
+export const handlers = {
+    get_revenue_report: async (client, args) => {
+        const { start_date, end_date, group_by } = GetRevenueReportParamsSchema.parse(args);
+        return client.getRevenueReport(start_date, end_date, group_by);
+    },
+    get_customer_revenue_report: async (client, args) => {
+        const { start_date, end_date, limit } = GetCustomerRevenueReportParamsSchema.parse(args);
+        return client.getCustomerRevenueReport(start_date, end_date, limit);
+    },
+    get_invoice_status_report: async (client, args) => {
+        const { start_date, end_date } = GetInvoiceStatusReportParamsSchema.parse(args);
+        return client.getInvoiceStatusReport(start_date, end_date);
+    },
+    get_overdue_invoices_report: async (client) => {
+        return client.getOverdueInvoicesReport();
+    },
+    get_monthly_revenue_report: async (client, args) => {
+        const { year, month } = GetMonthlyRevenueReportParamsSchema.parse(args);
+        return client.getMonthlyRevenueReport(year, month);
+    },
+    get_top_customers_by_revenue: async (client, args) => {
+        const { limit, start_date, end_date } = GetTopCustomersByRevenueParamsSchema.parse(args);
+        return client.getTopCustomersByRevenue(limit, start_date, end_date);
+    },
+    get_tasks_due_this_week: async (client) => {
+        return client.getTasksDueThisWeek();
+    },
+};

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

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

package/dist/tools/reports/index.js

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

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

@@ -0,0 +1,9 @@
+/**
+ * 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).
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const toolDefinitions: Tool[];