@promptpartner/bexio-mcp-server 2.0.0

package/dist/tools/accounting/definitions.js

@@ -0,0 +1,345 @@
+/**
+ * Accounting tool definitions.
+ * Contains MCP tool metadata for accounting domain.
+ * Includes: Accounts, Account Groups, Calendar Years, Business Years, Manual Entries, VAT Periods, Journal
+ *
+ * 15 tools total covering ACCT-01 through ACCT-07 requirements.
+ */
+export const toolDefinitions = [
+    // ===== ACCOUNTS - Chart of Accounts (ACCT-01) =====
+    {
+        name: "list_accounts",
+        description: "List chart of accounts with pagination. Returns all accounts in the chart of accounts.",
+        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_account",
+        description: "Get a specific account by ID from the chart of accounts",
+        inputSchema: {
+            type: "object",
+            properties: {
+                account_id: {
+                    type: "integer",
+                    description: "The ID of the account to retrieve",
+                },
+            },
+            required: ["account_id"],
+        },
+    },
+    {
+        name: "create_account",
+        description: "Create a new account in the chart of accounts",
+        inputSchema: {
+            type: "object",
+            properties: {
+                account_no: {
+                    type: "integer",
+                    description: "The account number (must be unique and positive)",
+                },
+                name: {
+                    type: "string",
+                    description: "The name of the account",
+                },
+                account_group_id: {
+                    type: "integer",
+                    description: "The ID of the account group this account belongs to",
+                },
+                is_active: {
+                    type: "boolean",
+                    description: "Whether the account is active (default: true)",
+                    default: true,
+                },
+                tax_id: {
+                    type: "integer",
+                    description: "Optional tax ID to associate with this account",
+                },
+            },
+            required: ["account_no", "name", "account_group_id"],
+        },
+    },
+    {
+        name: "search_accounts",
+        description: "Search accounts by criteria. Use field/value/criteria pattern for flexible searching.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                search_criteria: {
+                    type: "array",
+                    description: "Array of search criteria objects",
+                    items: {
+                        type: "object",
+                        properties: {
+                            field: {
+                                type: "string",
+                                description: "Field to search (e.g., 'name', 'account_no')",
+                            },
+                            value: {
+                                type: ["string", "number", "boolean"],
+                                description: "Value to search for",
+                            },
+                            criteria: {
+                                type: "string",
+                                description: "Search operator (e.g., '=', 'like', '>')",
+                            },
+                        },
+                        required: ["field", "value"],
+                    },
+                },
+            },
+            required: ["search_criteria"],
+        },
+    },
+    // ===== ACCOUNT GROUPS (ACCT-02) =====
+    {
+        name: "list_account_groups",
+        description: "List account groups (read-only hierarchy). Account groups organize the chart of accounts into categories.",
+        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,
+                },
+            },
+        },
+    },
+    // ===== CALENDAR YEARS (ACCT-03) =====
+    {
+        name: "list_calendar_years",
+        description: "List calendar years defined in the system",
+        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_calendar_year",
+        description: "Get a specific calendar year by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                year_id: {
+                    type: "integer",
+                    description: "The ID of the calendar year to retrieve",
+                },
+            },
+            required: ["year_id"],
+        },
+    },
+    // ===== BUSINESS YEARS (ACCT-04) =====
+    {
+        name: "list_business_years",
+        description: "List business/fiscal years (read-only). Business years define fiscal periods for accounting.",
+        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,
+                },
+            },
+        },
+    },
+    // ===== MANUAL ENTRIES (ACCT-05) =====
+    {
+        name: "list_manual_entries",
+        description: "List manual journal entries",
+        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_manual_entry",
+        description: "Get a specific manual entry by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entry_id: {
+                    type: "integer",
+                    description: "The ID of the manual entry to retrieve",
+                },
+            },
+            required: ["entry_id"],
+        },
+    },
+    {
+        name: "create_manual_entry",
+        description: "Create a manual journal entry (double-entry bookkeeping). Provide flat params; the handler transforms to nested entries array internally. Bexio validates that debits equal credits.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                date: {
+                    type: "string",
+                    description: "Entry date in YYYY-MM-DD format",
+                },
+                debit_account_id: {
+                    type: "integer",
+                    description: "The account ID to debit",
+                },
+                credit_account_id: {
+                    type: "integer",
+                    description: "The account ID to credit",
+                },
+                amount: {
+                    type: "number",
+                    description: "The amount for the entry (must be positive)",
+                },
+                description: {
+                    type: "string",
+                    description: "Description of the journal entry",
+                },
+                reference_nr: {
+                    type: "string",
+                    description: "Optional reference number for the entry",
+                },
+                tax_id: {
+                    type: "integer",
+                    description: "Optional tax ID to apply",
+                },
+                tax_account_id: {
+                    type: "integer",
+                    description: "Optional tax account ID",
+                },
+                currency_id: {
+                    type: "integer",
+                    description: "Optional currency ID (defaults to company currency)",
+                },
+                currency_factor: {
+                    type: "number",
+                    description: "Optional currency exchange factor (default: 1)",
+                    default: 1,
+                },
+            },
+            required: ["date", "debit_account_id", "credit_account_id", "amount", "description"],
+        },
+    },
+    {
+        name: "update_manual_entry",
+        description: "Update a manual entry",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entry_id: {
+                    type: "integer",
+                    description: "The ID of the manual entry to update",
+                },
+                entry_data: {
+                    type: "object",
+                    description: "The data to update on the manual entry",
+                },
+            },
+            required: ["entry_id", "entry_data"],
+        },
+    },
+    {
+        name: "delete_manual_entry",
+        description: "Delete a manual entry",
+        inputSchema: {
+            type: "object",
+            properties: {
+                entry_id: {
+                    type: "integer",
+                    description: "The ID of the manual entry to delete",
+                },
+            },
+            required: ["entry_id"],
+        },
+    },
+    // ===== VAT PERIODS (ACCT-06) =====
+    {
+        name: "list_vat_periods",
+        description: "List VAT periods (read-only). VAT periods define reporting periods for value-added tax.",
+        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,
+                },
+            },
+        },
+    },
+    // ===== ACCOUNTING JOURNAL (ACCT-07) =====
+    {
+        name: "get_journal",
+        description: "Query the accounting journal with optional date range. Returns journal entries for the specified period.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                start_date: {
+                    type: "string",
+                    description: "Start date filter in YYYY-MM-DD format",
+                },
+                end_date: {
+                    type: "string",
+                    description: "End date filter in YYYY-MM-DD format",
+                },
+                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,
+                },
+            },
+        },
+    },
+];

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

@@ -0,0 +1,10 @@
+/**
+ * Accounting tool handlers.
+ * Implements the logic for each accounting tool.
+ *
+ * IMPORTANT: create_manual_entry transforms flat MCP params to nested Bexio API structure.
+ * Bexio validates double-entry rules server-side (debits must equal credits).
+ */
+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/accounting/handlers.js

@@ -0,0 +1,121 @@
+/**
+ * Accounting tool handlers.
+ * Implements the logic for each accounting tool.
+ *
+ * IMPORTANT: create_manual_entry transforms flat MCP params to nested Bexio API structure.
+ * Bexio validates double-entry rules server-side (debits must equal credits).
+ */
+import { McpError } from "../../shared/errors.js";
+import { 
+// Accounts
+ListAccountsParamsSchema, GetAccountParamsSchema, CreateAccountParamsSchema, SearchAccountsParamsSchema, 
+// Account Groups
+ListAccountGroupsParamsSchema, 
+// Calendar Years
+ListCalendarYearsParamsSchema, GetCalendarYearParamsSchema, 
+// Business Years
+ListBusinessYearsParamsSchema, 
+// Manual Entries
+ListManualEntriesParamsSchema, GetManualEntryParamsSchema, CreateManualEntryParamsSchema, UpdateManualEntryParamsSchema, DeleteManualEntryParamsSchema, 
+// VAT Periods
+ListVatPeriodsParamsSchema, 
+// Journal
+GetJournalParamsSchema, } from "../../types/index.js";
+export const handlers = {
+    // ===== ACCOUNTS - Chart of Accounts (ACCT-01) =====
+    list_accounts: async (client, args) => {
+        const params = ListAccountsParamsSchema.parse(args);
+        return client.listAccounts(params);
+    },
+    get_account: async (client, args) => {
+        const { account_id } = GetAccountParamsSchema.parse(args);
+        const account = await client.getAccount(account_id);
+        if (!account) {
+            throw McpError.notFound("Account", account_id);
+        }
+        return account;
+    },
+    create_account: async (client, args) => {
+        const params = CreateAccountParamsSchema.parse(args);
+        return client.createAccount(params);
+    },
+    search_accounts: async (client, args) => {
+        const { search_criteria } = SearchAccountsParamsSchema.parse(args);
+        return client.searchAccounts(search_criteria);
+    },
+    // ===== ACCOUNT GROUPS (ACCT-02) =====
+    list_account_groups: async (client, args) => {
+        const params = ListAccountGroupsParamsSchema.parse(args);
+        return client.listAccountGroups(params);
+    },
+    // ===== CALENDAR YEARS (ACCT-03) =====
+    list_calendar_years: async (client, args) => {
+        const params = ListCalendarYearsParamsSchema.parse(args);
+        return client.listCalendarYears(params);
+    },
+    get_calendar_year: async (client, args) => {
+        const { year_id } = GetCalendarYearParamsSchema.parse(args);
+        const year = await client.getCalendarYear(year_id);
+        if (!year) {
+            throw McpError.notFound("Calendar Year", year_id);
+        }
+        return year;
+    },
+    // ===== BUSINESS YEARS (ACCT-04) =====
+    list_business_years: async (client, args) => {
+        const params = ListBusinessYearsParamsSchema.parse(args);
+        return client.listBusinessYears(params);
+    },
+    // ===== MANUAL ENTRIES (ACCT-05) =====
+    list_manual_entries: async (client, args) => {
+        const params = ListManualEntriesParamsSchema.parse(args);
+        return client.listManualEntries(params);
+    },
+    get_manual_entry: async (client, args) => {
+        const { entry_id } = GetManualEntryParamsSchema.parse(args);
+        const entry = await client.getManualEntry(entry_id);
+        if (!entry) {
+            throw McpError.notFound("Manual Entry", entry_id);
+        }
+        return entry;
+    },
+    create_manual_entry: async (client, args) => {
+        const params = CreateManualEntryParamsSchema.parse(args);
+        // Transform flat MCP params to Bexio API nested structure
+        // Bexio expects an entries array even for single-entry bookings
+        const entryData = {
+            type: params.type || "manual_single_entry",
+            date: params.date,
+            reference_nr: params.reference_nr,
+            entries: [{
+                    debit_account_id: params.debit_account_id,
+                    credit_account_id: params.credit_account_id,
+                    tax_id: params.tax_id,
+                    tax_account_id: params.tax_account_id,
+                    description: params.description,
+                    amount: params.amount,
+                    currency_id: params.currency_id,
+                    currency_factor: params.currency_factor,
+                }],
+        };
+        return client.createManualEntry(entryData);
+    },
+    update_manual_entry: async (client, args) => {
+        const { entry_id, entry_data } = UpdateManualEntryParamsSchema.parse(args);
+        return client.updateManualEntry(entry_id, entry_data);
+    },
+    delete_manual_entry: async (client, args) => {
+        const { entry_id } = DeleteManualEntryParamsSchema.parse(args);
+        return client.deleteManualEntry(entry_id);
+    },
+    // ===== VAT PERIODS (ACCT-06) =====
+    list_vat_periods: async (client, args) => {
+        const params = ListVatPeriodsParamsSchema.parse(args);
+        return client.listVatPeriods(params);
+    },
+    // ===== ACCOUNTING JOURNAL (ACCT-07) =====
+    get_journal: async (client, args) => {
+        const params = GetJournalParamsSchema.parse(args);
+        return client.getJournal(params);
+    },
+};

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

@@ -0,0 +1,16 @@
+/**
+ * Accounting domain module.
+ * Exports tool definitions and handlers for accounting operations.
+ *
+ * ACCT-01: Accounts (Chart of Accounts) - 4 tools
+ * ACCT-02: Account Groups - 1 tool (read-only)
+ * ACCT-03: Calendar Years - 2 tools
+ * ACCT-04: Business Years - 1 tool (read-only)
+ * ACCT-05: Manual Entries - 5 tools
+ * ACCT-06: VAT Periods - 1 tool (read-only)
+ * ACCT-07: Journal - 1 tool
+ *
+ * Total: 15 tools
+ */
+export { toolDefinitions } from "./definitions.js";
+export { handlers } from "./handlers.js";

package/dist/tools/accounting/index.js

@@ -0,0 +1,16 @@
+/**
+ * Accounting domain module.
+ * Exports tool definitions and handlers for accounting operations.
+ *
+ * ACCT-01: Accounts (Chart of Accounts) - 4 tools
+ * ACCT-02: Account Groups - 1 tool (read-only)
+ * ACCT-03: Calendar Years - 2 tools
+ * ACCT-04: Business Years - 1 tool (read-only)
+ * ACCT-05: Manual Entries - 5 tools
+ * ACCT-06: VAT Periods - 1 tool (read-only)
+ * ACCT-07: Journal - 1 tool
+ *
+ * Total: 15 tools
+ */
+export { toolDefinitions } from "./definitions.js";
+export { handlers } from "./handlers.js";

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

@@ -0,0 +1,11 @@
+/**
+ * Banking tool definitions.
+ * Contains MCP tool metadata for banking domain.
+ *
+ * Swiss Standards:
+ * - IBAN payments: Swiss ISO 20022 payment standards
+ * - QR payments: SIX Group QR-bill specification v2.3
+ * - Addresses: Structured format only (type S) - required from Nov 2025
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const toolDefinitions: Tool[];