@promptpartner/bexio-mcp-server 2.0.0

package/dist/tools/quotes/definitions.js

@@ -0,0 +1,174 @@
+/**
+ * Quote tool definitions.
+ * Contains MCP tool metadata for quotes/offers domain.
+ */
+export const toolDefinitions = [
+    {
+        name: "list_quotes",
+        description: "List quotes (offers) from Bexio with optional pagination",
+        inputSchema: {
+            type: "object",
+            properties: {
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of quotes to return (default: 50)",
+                    default: 50,
+                },
+                offset: {
+                    type: "integer",
+                    description: "Number of quotes to skip (default: 0)",
+                    default: 0,
+                },
+            },
+        },
+    },
+    {
+        name: "get_quote",
+        description: "Get a specific quote by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                quote_id: {
+                    type: "integer",
+                    description: "The ID of the quote to retrieve",
+                },
+            },
+            required: ["quote_id"],
+        },
+    },
+    {
+        name: "create_quote",
+        description: "Create a new quote (offer) for an existing contact",
+        inputSchema: {
+            type: "object",
+            properties: {
+                contact_id: {
+                    type: "integer",
+                    description: "The contact ID the quote should be created for",
+                },
+                quote_data: {
+                    type: "object",
+                    description: "Quote payload according to Bexio's /kb_offer schema. The contact_id is merged automatically.",
+                },
+            },
+            required: ["contact_id", "quote_data"],
+        },
+    },
+    {
+        name: "search_quotes",
+        description: "Search quotes with filters",
+        inputSchema: {
+            type: "object",
+            properties: {
+                search_params: {
+                    type: "object",
+                    description: "Search parameters for quotes",
+                },
+            },
+            required: ["search_params"],
+        },
+    },
+    {
+        name: "search_quotes_by_customer",
+        description: "Search quotes by customer name (2-step process: find contact by name, then find quotes by contact_id)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                customer_name: {
+                    type: "string",
+                    description: 'Customer name to search for (e.g., "Anton", "Mustermann")',
+                },
+                limit: {
+                    type: "integer",
+                    description: "Maximum number of quotes to return (default: 50)",
+                    default: 50,
+                },
+            },
+            required: ["customer_name"],
+        },
+    },
+    {
+        name: "issue_quote",
+        description: "Issue a quote",
+        inputSchema: {
+            type: "object",
+            properties: {
+                quote_id: {
+                    type: "integer",
+                    description: "The ID of the quote to issue",
+                },
+            },
+            required: ["quote_id"],
+        },
+    },
+    {
+        name: "accept_quote",
+        description: "Accept a quote",
+        inputSchema: {
+            type: "object",
+            properties: {
+                quote_id: {
+                    type: "integer",
+                    description: "The ID of the quote to accept",
+                },
+            },
+            required: ["quote_id"],
+        },
+    },
+    {
+        name: "decline_quote",
+        description: "Decline a quote",
+        inputSchema: {
+            type: "object",
+            properties: {
+                quote_id: {
+                    type: "integer",
+                    description: "The ID of the quote to decline",
+                },
+            },
+            required: ["quote_id"],
+        },
+    },
+    {
+        name: "send_quote",
+        description: "Send a quote",
+        inputSchema: {
+            type: "object",
+            properties: {
+                quote_id: {
+                    type: "integer",
+                    description: "The ID of the quote to send",
+                },
+            },
+            required: ["quote_id"],
+        },
+    },
+    {
+        name: "create_order_from_quote",
+        description: "Create an order from a quote",
+        inputSchema: {
+            type: "object",
+            properties: {
+                quote_id: {
+                    type: "integer",
+                    description: "The ID of the quote to create an order from",
+                },
+            },
+            required: ["quote_id"],
+        },
+    },
+    {
+        name: "create_invoice_from_quote",
+        description: "Create an invoice from a quote",
+        inputSchema: {
+            type: "object",
+            properties: {
+                quote_id: {
+                    type: "integer",
+                    description: "The ID of the quote to create an invoice from",
+                },
+            },
+            required: ["quote_id"],
+        },
+    },
+];

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

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

@@ -0,0 +1,79 @@
+/**
+ * Quote tool handlers.
+ * Implements the logic for each quote tool.
+ */
+import { McpError } from "../../shared/errors.js";
+import { ListQuotesParamsSchema, GetQuoteParamsSchema, CreateQuoteParamsSchema, SearchQuotesParamsSchema, SearchQuotesByCustomerParamsSchema, IssueQuoteParamsSchema, AcceptQuoteParamsSchema, DeclineQuoteParamsSchema, SendQuoteParamsSchema, CreateOrderFromQuoteParamsSchema, CreateInvoiceFromQuoteParamsSchema, } from "../../types/index.js";
+export const handlers = {
+    list_quotes: async (client, args) => {
+        const params = ListQuotesParamsSchema.parse(args);
+        return client.listQuotes(params);
+    },
+    get_quote: async (client, args) => {
+        const { quote_id } = GetQuoteParamsSchema.parse(args);
+        const quote = await client.getQuote(quote_id);
+        if (!quote) {
+            throw McpError.notFound("Quote", quote_id);
+        }
+        return quote;
+    },
+    create_quote: async (client, args) => {
+        const { contact_id, quote_data } = CreateQuoteParamsSchema.parse(args);
+        const payload = { ...quote_data, contact_id };
+        return client.createQuote(payload);
+    },
+    search_quotes: async (client, args) => {
+        const { search_params } = SearchQuotesParamsSchema.parse(args);
+        return client.searchQuotes(search_params);
+    },
+    search_quotes_by_customer: async (client, args) => {
+        const params = SearchQuotesByCustomerParamsSchema.parse(args);
+        // Step 1: Find contacts by name
+        const contacts = await client.findContactByName(params.customer_name);
+        if (!contacts || contacts.length === 0) {
+            return {
+                quotes: [],
+                message: `No contacts found with name "${params.customer_name}"`,
+                contacts_found: 0,
+            };
+        }
+        // Step 2: Search quotes for each contact (limit to first 5)
+        const allQuotes = [];
+        for (const contact of contacts.slice(0, 5)) {
+            const contactId = contact.id;
+            if (contactId) {
+                const quotes = await client.searchQuotesByContactId(contactId);
+                allQuotes.push(...quotes);
+            }
+        }
+        return {
+            quotes: allQuotes,
+            contacts_found: contacts.length,
+            customer_name: params.customer_name,
+        };
+    },
+    issue_quote: async (client, args) => {
+        const { quote_id } = IssueQuoteParamsSchema.parse(args);
+        return client.issueQuote(quote_id);
+    },
+    accept_quote: async (client, args) => {
+        const { quote_id } = AcceptQuoteParamsSchema.parse(args);
+        return client.acceptQuote(quote_id);
+    },
+    decline_quote: async (client, args) => {
+        const { quote_id } = DeclineQuoteParamsSchema.parse(args);
+        return client.declineQuote(quote_id);
+    },
+    send_quote: async (client, args) => {
+        const { quote_id } = SendQuoteParamsSchema.parse(args);
+        return client.sendQuote(quote_id);
+    },
+    create_order_from_quote: async (client, args) => {
+        const { quote_id } = CreateOrderFromQuoteParamsSchema.parse(args);
+        return client.createOrderFromQuote(quote_id);
+    },
+    create_invoice_from_quote: async (client, args) => {
+        const { quote_id } = CreateInvoiceFromQuoteParamsSchema.parse(args);
+        return client.createInvoiceFromQuote(quote_id);
+    },
+};

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

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

package/dist/tools/quotes/index.js

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

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

@@ -0,0 +1,7 @@
+/**
+ * Reference data tool definitions.
+ * Contains MCP tool metadata for reference data domain.
+ * Includes: Contact Groups, Sectors, Salutations, Titles, Countries, Languages, Units
+ */
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+export declare const toolDefinitions: Tool[];

package/dist/tools/reference/definitions.js

@@ -0,0 +1,421 @@
+/**
+ * Reference data tool definitions.
+ * Contains MCP tool metadata for reference data domain.
+ * Includes: Contact Groups, Sectors, Salutations, Titles, Countries, Languages, Units
+ */
+export const toolDefinitions = [
+    // ===== CONTACT GROUPS (REFDATA-01) =====
+    {
+        name: "list_contact_groups",
+        description: "List all contact groups for categorizing contacts",
+        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_contact_group",
+        description: "Get a specific contact group by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                group_id: {
+                    type: "integer",
+                    description: "The ID of the contact group to retrieve",
+                },
+            },
+            required: ["group_id"],
+        },
+    },
+    {
+        name: "create_contact_group",
+        description: "Create a new contact group for categorizing contacts",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "The name of the contact group",
+                },
+            },
+            required: ["name"],
+        },
+    },
+    {
+        name: "delete_contact_group",
+        description: "Delete a contact group by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                group_id: {
+                    type: "integer",
+                    description: "The ID of the contact group to delete",
+                },
+            },
+            required: ["group_id"],
+        },
+    },
+    // ===== CONTACT SECTORS (REFDATA-02) =====
+    {
+        name: "list_contact_sectors",
+        description: "List all contact sectors (industry types for contacts)",
+        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_contact_sector",
+        description: "Get a specific contact sector by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                sector_id: {
+                    type: "integer",
+                    description: "The ID of the contact sector to retrieve",
+                },
+            },
+            required: ["sector_id"],
+        },
+    },
+    {
+        name: "create_contact_sector",
+        description: "Create a new contact sector (industry type)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "The name of the contact sector",
+                },
+            },
+            required: ["name"],
+        },
+    },
+    // ===== SALUTATIONS (REFDATA-03) =====
+    {
+        name: "list_salutations",
+        description: "List all salutations (e.g., Mr., Mrs., Dr.)",
+        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_salutation",
+        description: "Get a specific salutation by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                salutation_id: {
+                    type: "integer",
+                    description: "The ID of the salutation to retrieve",
+                },
+            },
+            required: ["salutation_id"],
+        },
+    },
+    {
+        name: "create_salutation",
+        description: "Create a new salutation (e.g., Mr., Mrs., Dr.)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "The name of the salutation",
+                },
+            },
+            required: ["name"],
+        },
+    },
+    {
+        name: "delete_salutation",
+        description: "Delete a salutation by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                salutation_id: {
+                    type: "integer",
+                    description: "The ID of the salutation to delete",
+                },
+            },
+            required: ["salutation_id"],
+        },
+    },
+    // ===== TITLES (REFDATA-04) =====
+    {
+        name: "list_titles",
+        description: "List all titles (e.g., CEO, Manager, Director)",
+        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_title",
+        description: "Get a specific title by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                title_id: {
+                    type: "integer",
+                    description: "The ID of the title to retrieve",
+                },
+            },
+            required: ["title_id"],
+        },
+    },
+    {
+        name: "create_title",
+        description: "Create a new title (e.g., CEO, Manager, Director)",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "The name of the title",
+                },
+            },
+            required: ["name"],
+        },
+    },
+    {
+        name: "delete_title",
+        description: "Delete a title by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                title_id: {
+                    type: "integer",
+                    description: "The ID of the title to delete",
+                },
+            },
+            required: ["title_id"],
+        },
+    },
+    // ===== COUNTRIES (REFDATA-05) =====
+    {
+        name: "list_countries",
+        description: "List all countries available in Bexio",
+        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_country",
+        description: "Get a specific country by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                country_id: {
+                    type: "integer",
+                    description: "The ID of the country to retrieve",
+                },
+            },
+            required: ["country_id"],
+        },
+    },
+    {
+        name: "create_country",
+        description: "Create a new country entry",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "The name of the country",
+                },
+                iso_3166_alpha2: {
+                    type: "string",
+                    description: "ISO 3166 alpha-2 country code (2 characters, e.g., 'CH', 'DE')",
+                },
+            },
+            required: ["name", "iso_3166_alpha2"],
+        },
+    },
+    {
+        name: "delete_country",
+        description: "Delete a country by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                country_id: {
+                    type: "integer",
+                    description: "The ID of the country to delete",
+                },
+            },
+            required: ["country_id"],
+        },
+    },
+    // ===== LANGUAGES (REFDATA-06) =====
+    {
+        name: "list_languages",
+        description: "List all languages available in Bexio",
+        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_language",
+        description: "Get a specific language by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                language_id: {
+                    type: "integer",
+                    description: "The ID of the language to retrieve",
+                },
+            },
+            required: ["language_id"],
+        },
+    },
+    {
+        name: "create_language",
+        description: "Create a new language entry",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "The name of the language",
+                },
+                iso_639_1: {
+                    type: "string",
+                    description: "ISO 639-1 language code (2 characters, e.g., 'de', 'fr', 'en')",
+                },
+            },
+            required: ["name", "iso_639_1"],
+        },
+    },
+    // ===== UNITS (REFDATA-07) =====
+    {
+        name: "list_units",
+        description: "List all units of measurement (e.g., hours, pieces, kg)",
+        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_unit",
+        description: "Get a specific unit by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                unit_id: {
+                    type: "integer",
+                    description: "The ID of the unit to retrieve",
+                },
+            },
+            required: ["unit_id"],
+        },
+    },
+    {
+        name: "create_unit",
+        description: "Create a new unit of measurement",
+        inputSchema: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "The name of the unit (e.g., 'hours', 'pieces', 'kg')",
+                },
+            },
+            required: ["name"],
+        },
+    },
+    {
+        name: "delete_unit",
+        description: "Delete a unit by ID",
+        inputSchema: {
+            type: "object",
+            properties: {
+                unit_id: {
+                    type: "integer",
+                    description: "The ID of the unit to delete",
+                },
+            },
+            required: ["unit_id"],
+        },
+    },
+];