brinkcommerce-dev-mcp 0.1.0-beta.1

package/dist/index.js

@@ -0,0 +1,614 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { OpenAPIManager } from "./openapi-utils.js";
+import { docsConfig } from "./config.js";
+import { logger } from "./logger.js";
+import { validateAndCall } from "./tools/validation-middleware.js";
+import { productTools, 
+// Product Parent handlers
+handleGetProductParent, handleCreateProductParent, handleDeleteProductParent, handlePatchProductParent, handleArchiveProductParent, 
+// Product Variant handlers
+handleGetProductVariant, handleListProductVariants, handleCreateProductVariant, handleDeleteProductVariant, handlePatchProductVariant, 
+// Addon handlers
+handleGetAddon, handleCreateOrUpdateAddon, handleDeleteAddon, handlePatchAddon, handleListProductParentAddons, handleAddProductParentAddon, handleRemoveProductParentAddon, storeTools, handleCreateOrUpdateStoreGroup, handleCreateOrUpdateStoreMarket, handleDeleteStoreGroup, handleDeleteStoreMarket, handleListStoreGroups, handleGetStoreGroup, handleListStoreMarkets, handlePatchStoreGroup, handlePatchStoreMarket, stockTools, handleUpdateProductVariantInventory, handleDeleteProductVariantInventory, 
+// Inventory location handlers
+handleListInventories, handleGetInventory, handleCreateOrUpdateInventory, handleDeleteInventory, 
+// Product variant stock handlers
+handleGetProductVariantStock, handleUpdateProductVariantStockConfig, handlePatchProductVariantInventory, 
+// Store market inventories handlers
+handleGetStoreMarketInventories, handleUpdateStoreMarketInventories, priceTools, handleUpdateProductVariantPrices, handleDeleteProductVariantPrices, handleGetProductVariantAllPrices, handleGetProductVariantPrices, handleGetProductVariantPrice, handleGetAddonPrice, handlePatchProductVariantPrices, orderTools, handleGetOrder, handleGetOrderByReference, handleCancelOrder, handleRefundOrder, handleImportOrder, handleGetImportedOrder, 
+// Delivery handlers
+handleCreateDelivery, handleGetDelivery, handleUpdateDelivery, handleDeleteDelivery, handleStartDelivery, handleRestartDelivery, 
+// Cancellation handlers
+handleGetCancellation, handleDeleteCancellation, handleStartCancellation, handleRestartCancellation, 
+// Refund handlers
+handleGetRefund, handleUpdateRefund, handleDeleteRefund, handleStartRefund, handleRestartRefund, 
+// Release handlers
+handleCreateRelease, handleGetRelease, handleDeleteRelease, handleStartRelease, handleRestartRelease, 
+// Discount handlers
+discountTools, handleRunDiscounts, handleGetBundleGroup, handleCreateOrUpdateBundleGroup, handleDeleteBundleGroup, handleCreateDiscountCode, 
+// Tax handlers
+taxTools, handleGetTaxGroup, handleCreateOrUpdateTaxGroup, handleDeleteTaxGroup, handleGetTaxMarkets, handleCreateOrUpdateTaxMarket, handleDeleteTaxMarket, } from "./tools/index.js";
+import { apiDocsTools, handleListApis, handleGetApiInfo, handleListEndpoints, handleGetEndpointDetails, handleListSchemas, handleGetSchema, handleSearchSchemas, handleGetDocsInfo, } from "./api-docs-tools.js";
+import { 
+// Tool definitions
+orderQueryTools, orderCollectionTools, compensationTools, orderLinesModificationTools, shippingFeesModificationTools, addressesModificationTools, customStateTools, customReasonCodeTools, commentTools, 
+// Order Query handlers
+handleGetOrdersByEmail, handleGetOrdersByMerchantRef, handleGetOrderHistory, handleGetOrderReservation, handleDeleteOrder, 
+// Order Collection handlers
+handleListOrderDeliveries, handleListOrderCancellations, handleListOrderRefunds, handleListOrderReleases, handleListOrderCompensations, handleListOrderModifications, 
+// Compensation handlers
+handleCreateCompensation, handleGetCompensation, handleUpdateCompensation, handleDeleteCompensation, handleStartCompensation, handleRestartCompensation, 
+// Order Lines Modification handlers
+handleCreateOrderLinesModification, handleGetOrderLinesModification, handleUpdateOrderLinesModification, handleDeleteOrderLinesModification, handleStartOrderLinesModification, handleRestartOrderLinesModification, 
+// Shipping Fees Modification handlers
+handleCreateShippingFeesModification, handleGetShippingFeesModification, handleUpdateShippingFeesModification, handleDeleteShippingFeesModification, handleStartShippingFeesModification, handleRestartShippingFeesModification, 
+// Addresses Modification handlers
+handleCreateAddressesModification, handleGetAddressesModification, handleUpdateAddressesModification, handleDeleteAddressesModification, handleStartAddressesModification, 
+// Custom State handlers
+handleListCustomStates, handleGetCustomState, handleCreateCustomState, handleDeleteCustomState, handleAddOrderCustomState, handleRemoveOrderCustomState, 
+// Custom Reason Code handlers
+handleListCustomReasonCodes, handleGetCustomReasonCode, handleCreateCustomReasonCode, handleDeleteCustomReasonCode, 
+// Comment handlers
+handleCreateOrderComment, handleUpdateOrderComment, handleDeleteOrderComment, } from "./tools/order-extended-tools.js";
+// Initialize OpenAPI manager with built-in configuration
+const apiManager = new OpenAPIManager(docsConfig.baseUrl);
+// Create the MCP server
+const mcpServer = new Server({
+    name: "brinkcommerce-dev-mcp",
+    version: "1.0.0",
+    description: "Brink Commerce (BrinkCommerce) headless e-commerce platform MCP server. Provides API documentation AND direct management capabilities. Start with 'get_docs_info' to understand the platform. Use documentation tools to explore 23+ APIs, or use management tools to create products, manage inventory, update prices, and configure stores.",
+}, {
+    capabilities: {
+        tools: {},
+        resources: {},
+    },
+});
+// List available tools
+mcpServer.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            // API Documentation tools
+            apiDocsTools.get_docs_info,
+            apiDocsTools.search_schemas,
+            apiDocsTools.list_apis,
+            apiDocsTools.get_api_info,
+            apiDocsTools.list_endpoints,
+            apiDocsTools.get_endpoint_details,
+            apiDocsTools.list_schemas,
+            apiDocsTools.get_schema,
+            // Product Management tools - Product Parents
+            productTools.get_product_parent,
+            productTools.create_product_parent,
+            productTools.delete_product_parent,
+            productTools.patch_product_parent,
+            productTools.archive_product_parent,
+            // Product Management tools - Product Variants
+            productTools.get_product_variant,
+            productTools.list_product_variants,
+            productTools.create_product_variant,
+            productTools.delete_product_variant,
+            productTools.patch_product_variant,
+            // Product Management tools - Addons
+            productTools.get_addon,
+            productTools.create_or_update_addon,
+            productTools.delete_addon,
+            productTools.patch_addon,
+            productTools.list_product_parent_addons,
+            productTools.add_product_parent_addon,
+            productTools.remove_product_parent_addon,
+            // Store Management tools
+            storeTools.create_or_update_store_group,
+            storeTools.create_or_update_store_market,
+            storeTools.delete_store_group,
+            storeTools.delete_store_market,
+            storeTools.list_store_groups,
+            storeTools.get_store_group,
+            storeTools.list_store_markets,
+            storeTools.patch_store_group,
+            storeTools.patch_store_market,
+            // Stock Management tools
+            stockTools.update_product_variant_inventory,
+            stockTools.delete_product_variant_inventory,
+            // Inventory location tools
+            stockTools.list_inventories,
+            stockTools.get_inventory,
+            stockTools.create_or_update_inventory,
+            stockTools.delete_inventory,
+            // Product variant stock tools
+            stockTools.get_product_variant_stock,
+            stockTools.update_product_variant_stock_config,
+            stockTools.patch_product_variant_inventory,
+            // Store market inventories tools
+            stockTools.get_store_market_inventories,
+            stockTools.update_store_market_inventories,
+            // Price Management tools
+            priceTools.update_product_variant_prices,
+            priceTools.delete_product_variant_prices,
+            priceTools.get_product_variant_all_prices,
+            priceTools.get_product_variant_prices,
+            priceTools.get_product_variant_price,
+            priceTools.get_addon_price,
+            priceTools.patch_product_variant_prices,
+            // Order Management tools
+            orderTools.get_order,
+            orderTools.get_order_by_reference,
+            orderTools.cancel_order,
+            orderTools.refund_order,
+            orderTools.import_order,
+            orderTools.get_imported_order,
+            // Delivery tools
+            orderTools.create_delivery,
+            orderTools.get_delivery,
+            orderTools.update_delivery,
+            orderTools.delete_delivery,
+            orderTools.start_delivery,
+            orderTools.restart_delivery,
+            // Cancellation tools
+            orderTools.get_cancellation,
+            orderTools.delete_cancellation,
+            orderTools.start_cancellation,
+            orderTools.restart_cancellation,
+            // Refund tools
+            orderTools.get_refund,
+            orderTools.update_refund,
+            orderTools.delete_refund,
+            orderTools.start_refund,
+            orderTools.restart_refund,
+            // Release tools
+            orderTools.create_release,
+            orderTools.get_release,
+            orderTools.delete_release,
+            orderTools.start_release,
+            orderTools.restart_release,
+            // Extended Order Query tools
+            orderQueryTools.get_orders_by_email,
+            orderQueryTools.get_orders_by_merchant_ref,
+            orderQueryTools.get_order_history,
+            orderQueryTools.get_order_reservation,
+            orderQueryTools.delete_order,
+            // Order Collection tools
+            orderCollectionTools.list_order_deliveries,
+            orderCollectionTools.list_order_cancellations,
+            orderCollectionTools.list_order_refunds,
+            orderCollectionTools.list_order_releases,
+            orderCollectionTools.list_order_compensations,
+            orderCollectionTools.list_order_modifications,
+            // Compensation tools
+            compensationTools.create_compensation,
+            compensationTools.get_compensation,
+            compensationTools.update_compensation,
+            compensationTools.delete_compensation,
+            compensationTools.start_compensation,
+            compensationTools.restart_compensation,
+            // Order Lines Modification tools
+            orderLinesModificationTools.create_order_lines_modification,
+            orderLinesModificationTools.get_order_lines_modification,
+            orderLinesModificationTools.update_order_lines_modification,
+            orderLinesModificationTools.delete_order_lines_modification,
+            orderLinesModificationTools.start_order_lines_modification,
+            orderLinesModificationTools.restart_order_lines_modification,
+            // Shipping Fees Modification tools
+            shippingFeesModificationTools.create_shipping_fees_modification,
+            shippingFeesModificationTools.get_shipping_fees_modification,
+            shippingFeesModificationTools.update_shipping_fees_modification,
+            shippingFeesModificationTools.delete_shipping_fees_modification,
+            shippingFeesModificationTools.start_shipping_fees_modification,
+            shippingFeesModificationTools.restart_shipping_fees_modification,
+            // Addresses Modification tools
+            addressesModificationTools.create_addresses_modification,
+            addressesModificationTools.get_addresses_modification,
+            addressesModificationTools.update_addresses_modification,
+            addressesModificationTools.delete_addresses_modification,
+            addressesModificationTools.start_addresses_modification,
+            // Custom State tools
+            customStateTools.list_custom_states,
+            customStateTools.get_custom_state,
+            customStateTools.create_custom_state,
+            customStateTools.delete_custom_state,
+            customStateTools.add_order_custom_state,
+            customStateTools.remove_order_custom_state,
+            // Custom Reason Code tools
+            customReasonCodeTools.list_custom_reason_codes,
+            customReasonCodeTools.get_custom_reason_code,
+            customReasonCodeTools.create_custom_reason_code,
+            customReasonCodeTools.delete_custom_reason_code,
+            // Comment tools
+            commentTools.create_order_comment,
+            commentTools.update_order_comment,
+            commentTools.delete_order_comment,
+            // Discount Management tools
+            discountTools.run_discounts,
+            discountTools.get_bundle_group,
+            discountTools.create_or_update_bundle_group,
+            discountTools.delete_bundle_group,
+            discountTools.create_discount_code,
+            // Tax Management tools
+            taxTools.get_tax_group,
+            taxTools.create_or_update_tax_group,
+            taxTools.delete_tax_group,
+            taxTools.get_tax_markets,
+            taxTools.create_or_update_tax_market,
+            taxTools.delete_tax_market,
+        ],
+    };
+});
+// Handle tool calls
+mcpServer.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    const typedArgs = args;
+    try {
+        switch (name) {
+            case "list_apis":
+                return handleListApis(apiManager);
+            case "get_api_info":
+                return validateAndCall(name, typedArgs, (args) => handleGetApiInfo(apiManager, args));
+            case "list_endpoints":
+                return validateAndCall(name, typedArgs, (args) => handleListEndpoints(apiManager, args));
+            case "get_endpoint_details":
+                return validateAndCall(name, typedArgs, (args) => handleGetEndpointDetails(apiManager, args));
+            case "list_schemas":
+                return validateAndCall(name, typedArgs, (args) => handleListSchemas(apiManager, args));
+            case "get_schema":
+                return validateAndCall(name, typedArgs, (args) => handleGetSchema(apiManager, args));
+            case "search_schemas":
+                return validateAndCall(name, typedArgs, (args) => handleSearchSchemas(apiManager, args));
+            case "get_docs_info":
+                return handleGetDocsInfo();
+            // Product Parent operations
+            case "get_product_parent":
+                return validateAndCall(name, typedArgs, (args) => handleGetProductParent(args));
+            case "create_product_parent":
+                return validateAndCall(name, typedArgs, (args) => handleCreateProductParent(args));
+            case "delete_product_parent":
+                return validateAndCall(name, typedArgs, (args) => handleDeleteProductParent(args));
+            case "patch_product_parent":
+                return validateAndCall(name, typedArgs, (args) => handlePatchProductParent(args));
+            case "archive_product_parent":
+                return validateAndCall(name, typedArgs, (args) => handleArchiveProductParent(args));
+            // Product Variant operations
+            case "get_product_variant":
+                return validateAndCall(name, typedArgs, (args) => handleGetProductVariant(args));
+            case "list_product_variants":
+                return validateAndCall(name, typedArgs, (args) => handleListProductVariants(args));
+            case "create_product_variant":
+                return validateAndCall(name, typedArgs, (args) => handleCreateProductVariant(args));
+            case "delete_product_variant":
+                return validateAndCall(name, typedArgs, (args) => handleDeleteProductVariant(args));
+            case "patch_product_variant":
+                return validateAndCall(name, typedArgs, (args) => handlePatchProductVariant(args));
+            // Addon operations
+            case "get_addon":
+                return validateAndCall(name, typedArgs, (args) => handleGetAddon(args));
+            case "create_or_update_addon":
+                return validateAndCall(name, typedArgs, (args) => handleCreateOrUpdateAddon(args));
+            case "delete_addon":
+                return validateAndCall(name, typedArgs, (args) => handleDeleteAddon(args));
+            case "patch_addon":
+                return validateAndCall(name, typedArgs, (args) => handlePatchAddon(args));
+            case "list_product_parent_addons":
+                return validateAndCall(name, typedArgs, (args) => handleListProductParentAddons(args));
+            case "add_product_parent_addon":
+                return validateAndCall(name, typedArgs, (args) => handleAddProductParentAddon(args));
+            case "remove_product_parent_addon":
+                return validateAndCall(name, typedArgs, (args) => handleRemoveProductParentAddon(args));
+            case "create_or_update_store_group":
+                return validateAndCall(name, typedArgs, (args) => handleCreateOrUpdateStoreGroup(args));
+            case "create_or_update_store_market":
+                return validateAndCall(name, typedArgs, (args) => handleCreateOrUpdateStoreMarket(args));
+            case "delete_store_group":
+                return validateAndCall(name, typedArgs, (args) => handleDeleteStoreGroup(args));
+            case "delete_store_market":
+                return validateAndCall(name, typedArgs, (args) => handleDeleteStoreMarket(args));
+            case "list_store_groups":
+                return validateAndCall(name, typedArgs, () => handleListStoreGroups());
+            case "get_store_group":
+                return validateAndCall(name, typedArgs, (args) => handleGetStoreGroup(args));
+            case "list_store_markets":
+                return validateAndCall(name, typedArgs, (args) => handleListStoreMarkets(args));
+            case "patch_store_group":
+                return validateAndCall(name, typedArgs, (args) => handlePatchStoreGroup(args));
+            case "patch_store_market":
+                return validateAndCall(name, typedArgs, (args) => handlePatchStoreMarket(args));
+            case "update_product_variant_inventory":
+                return validateAndCall(name, typedArgs, (args) => handleUpdateProductVariantInventory(args));
+            case "delete_product_variant_inventory":
+                return validateAndCall(name, typedArgs, (args) => handleDeleteProductVariantInventory(args));
+            // Inventory location operations
+            case "list_inventories":
+                return validateAndCall(name, typedArgs, () => handleListInventories());
+            case "get_inventory":
+                return validateAndCall(name, typedArgs, (args) => handleGetInventory(args));
+            case "create_or_update_inventory":
+                return validateAndCall(name, typedArgs, (args) => handleCreateOrUpdateInventory(args));
+            case "delete_inventory":
+                return validateAndCall(name, typedArgs, (args) => handleDeleteInventory(args));
+            // Product variant stock operations
+            case "get_product_variant_stock":
+                return validateAndCall(name, typedArgs, (args) => handleGetProductVariantStock(args));
+            case "update_product_variant_stock_config":
+                return validateAndCall(name, typedArgs, (args) => handleUpdateProductVariantStockConfig(args));
+            case "patch_product_variant_inventory":
+                return validateAndCall(name, typedArgs, (args) => handlePatchProductVariantInventory(args));
+            // Store market inventories operations
+            case "get_store_market_inventories":
+                return validateAndCall(name, typedArgs, (args) => handleGetStoreMarketInventories(args));
+            case "update_store_market_inventories":
+                return validateAndCall(name, typedArgs, (args) => handleUpdateStoreMarketInventories(args));
+            case "update_product_variant_prices":
+                return validateAndCall(name, typedArgs, (args) => handleUpdateProductVariantPrices(args));
+            case "delete_product_variant_prices":
+                return validateAndCall(name, typedArgs, (args) => handleDeleteProductVariantPrices(args));
+            case "get_product_variant_all_prices":
+                return validateAndCall(name, typedArgs, (args) => handleGetProductVariantAllPrices(args));
+            case "get_product_variant_prices":
+                return validateAndCall(name, typedArgs, (args) => handleGetProductVariantPrices(args));
+            case "get_product_variant_price":
+                return validateAndCall(name, typedArgs, (args) => handleGetProductVariantPrice(args));
+            case "get_addon_price":
+                return validateAndCall(name, typedArgs, (args) => handleGetAddonPrice(args));
+            case "patch_product_variant_prices":
+                return validateAndCall(name, typedArgs, (args) => handlePatchProductVariantPrices(args));
+            case "get_order":
+                return validateAndCall(name, typedArgs, (args) => handleGetOrder(args));
+            case "get_order_by_reference":
+                return validateAndCall(name, typedArgs, (args) => handleGetOrderByReference(args));
+            case "cancel_order":
+                return validateAndCall(name, typedArgs, (args) => handleCancelOrder(args));
+            case "refund_order":
+                return validateAndCall(name, typedArgs, (args) => handleRefundOrder(args));
+            case "import_order":
+                return validateAndCall(name, typedArgs, (args) => handleImportOrder(args));
+            case "get_imported_order":
+                return validateAndCall(name, typedArgs, (args) => handleGetImportedOrder(args));
+            // Delivery operations
+            case "create_delivery":
+                return validateAndCall(name, typedArgs, (args) => handleCreateDelivery(args));
+            case "get_delivery":
+                return validateAndCall(name, typedArgs, (args) => handleGetDelivery(args));
+            case "update_delivery":
+                return validateAndCall(name, typedArgs, (args) => handleUpdateDelivery(args));
+            case "delete_delivery":
+                return validateAndCall(name, typedArgs, (args) => handleDeleteDelivery(args));
+            case "start_delivery":
+                return validateAndCall(name, typedArgs, (args) => handleStartDelivery(args));
+            case "restart_delivery":
+                return validateAndCall(name, typedArgs, (args) => handleRestartDelivery(args));
+            // Cancellation operations
+            case "get_cancellation":
+                return validateAndCall(name, typedArgs, (args) => handleGetCancellation(args));
+            case "delete_cancellation":
+                return validateAndCall(name, typedArgs, (args) => handleDeleteCancellation(args));
+            case "start_cancellation":
+                return validateAndCall(name, typedArgs, (args) => handleStartCancellation(args));
+            case "restart_cancellation":
+                return validateAndCall(name, typedArgs, (args) => handleRestartCancellation(args));
+            // Refund operations
+            case "get_refund":
+                return validateAndCall(name, typedArgs, (args) => handleGetRefund(args));
+            case "update_refund":
+                return validateAndCall(name, typedArgs, (args) => handleUpdateRefund(args));
+            case "delete_refund":
+                return validateAndCall(name, typedArgs, (args) => handleDeleteRefund(args));
+            case "start_refund":
+                return validateAndCall(name, typedArgs, (args) => handleStartRefund(args));
+            case "restart_refund":
+                return validateAndCall(name, typedArgs, (args) => handleRestartRefund(args));
+            // Release operations
+            case "create_release":
+                return validateAndCall(name, typedArgs, (args) => handleCreateRelease(args));
+            case "get_release":
+                return validateAndCall(name, typedArgs, (args) => handleGetRelease(args));
+            case "delete_release":
+                return validateAndCall(name, typedArgs, (args) => handleDeleteRelease(args));
+            case "start_release":
+                return validateAndCall(name, typedArgs, (args) => handleStartRelease(args));
+            case "restart_release":
+                return validateAndCall(name, typedArgs, (args) => handleRestartRelease(args));
+            // Extended Order Query operations
+            case "get_orders_by_email":
+                return validateAndCall(name, typedArgs, (args) => handleGetOrdersByEmail(args));
+            case "get_orders_by_merchant_ref":
+                return validateAndCall(name, typedArgs, (args) => handleGetOrdersByMerchantRef(args));
+            case "get_order_history":
+                return validateAndCall(name, typedArgs, (args) => handleGetOrderHistory(args));
+            case "get_order_reservation":
+                return validateAndCall(name, typedArgs, (args) => handleGetOrderReservation(args));
+            case "delete_order":
+                return validateAndCall(name, typedArgs, (args) => handleDeleteOrder(args));
+            // Order Collection operations
+            case "list_order_deliveries":
+                return validateAndCall(name, typedArgs, (args) => handleListOrderDeliveries(args));
+            case "list_order_cancellations":
+                return validateAndCall(name, typedArgs, (args) => handleListOrderCancellations(args));
+            case "list_order_refunds":
+                return validateAndCall(name, typedArgs, (args) => handleListOrderRefunds(args));
+            case "list_order_releases":
+                return validateAndCall(name, typedArgs, (args) => handleListOrderReleases(args));
+            case "list_order_compensations":
+                return validateAndCall(name, typedArgs, (args) => handleListOrderCompensations(args));
+            case "list_order_modifications":
+                return validateAndCall(name, typedArgs, (args) => handleListOrderModifications(args));
+            // Compensation operations
+            case "create_compensation":
+                return validateAndCall(name, typedArgs, (args) => handleCreateCompensation(args));
+            case "get_compensation":
+                return validateAndCall(name, typedArgs, (args) => handleGetCompensation(args));
+            case "update_compensation":
+                return validateAndCall(name, typedArgs, (args) => handleUpdateCompensation(args));
+            case "delete_compensation":
+                return validateAndCall(name, typedArgs, (args) => handleDeleteCompensation(args));
+            case "start_compensation":
+                return validateAndCall(name, typedArgs, (args) => handleStartCompensation(args));
+            case "restart_compensation":
+                return validateAndCall(name, typedArgs, (args) => handleRestartCompensation(args));
+            // Order Lines Modification operations
+            case "create_order_lines_modification":
+                return validateAndCall(name, typedArgs, (args) => handleCreateOrderLinesModification(args));
+            case "get_order_lines_modification":
+                return validateAndCall(name, typedArgs, (args) => handleGetOrderLinesModification(args));
+            case "update_order_lines_modification":
+                return validateAndCall(name, typedArgs, (args) => handleUpdateOrderLinesModification(args));
+            case "delete_order_lines_modification":
+                return validateAndCall(name, typedArgs, (args) => handleDeleteOrderLinesModification(args));
+            case "start_order_lines_modification":
+                return validateAndCall(name, typedArgs, (args) => handleStartOrderLinesModification(args));
+            case "restart_order_lines_modification":
+                return validateAndCall(name, typedArgs, (args) => handleRestartOrderLinesModification(args));
+            // Shipping Fees Modification operations
+            case "create_shipping_fees_modification":
+                return validateAndCall(name, typedArgs, (args) => handleCreateShippingFeesModification(args));
+            case "get_shipping_fees_modification":
+                return validateAndCall(name, typedArgs, (args) => handleGetShippingFeesModification(args));
+            case "update_shipping_fees_modification":
+                return validateAndCall(name, typedArgs, (args) => handleUpdateShippingFeesModification(args));
+            case "delete_shipping_fees_modification":
+                return validateAndCall(name, typedArgs, (args) => handleDeleteShippingFeesModification(args));
+            case "start_shipping_fees_modification":
+                return validateAndCall(name, typedArgs, (args) => handleStartShippingFeesModification(args));
+            case "restart_shipping_fees_modification":
+                return validateAndCall(name, typedArgs, (args) => handleRestartShippingFeesModification(args));
+            // Addresses Modification operations
+            case "create_addresses_modification":
+                return validateAndCall(name, typedArgs, (args) => handleCreateAddressesModification(args));
+            case "get_addresses_modification":
+                return validateAndCall(name, typedArgs, (args) => handleGetAddressesModification(args));
+            case "update_addresses_modification":
+                return validateAndCall(name, typedArgs, (args) => handleUpdateAddressesModification(args));
+            case "delete_addresses_modification":
+                return validateAndCall(name, typedArgs, (args) => handleDeleteAddressesModification(args));
+            case "start_addresses_modification":
+                return validateAndCall(name, typedArgs, (args) => handleStartAddressesModification(args));
+            // Custom State operations
+            case "list_custom_states":
+                return validateAndCall(name, typedArgs, () => handleListCustomStates());
+            case "get_custom_state":
+                return validateAndCall(name, typedArgs, (args) => handleGetCustomState(args));
+            case "create_custom_state":
+                return validateAndCall(name, typedArgs, (args) => handleCreateCustomState(args));
+            case "delete_custom_state":
+                return validateAndCall(name, typedArgs, (args) => handleDeleteCustomState(args));
+            case "add_order_custom_state":
+                return validateAndCall(name, typedArgs, (args) => handleAddOrderCustomState(args));
+            case "remove_order_custom_state":
+                return validateAndCall(name, typedArgs, (args) => handleRemoveOrderCustomState(args));
+            // Custom Reason Code operations
+            case "list_custom_reason_codes":
+                return validateAndCall(name, typedArgs, () => handleListCustomReasonCodes());
+            case "get_custom_reason_code":
+                return validateAndCall(name, typedArgs, (args) => handleGetCustomReasonCode(args));
+            case "create_custom_reason_code":
+                return validateAndCall(name, typedArgs, (args) => handleCreateCustomReasonCode(args));
+            case "delete_custom_reason_code":
+                return validateAndCall(name, typedArgs, (args) => handleDeleteCustomReasonCode(args));
+            // Comment operations
+            case "create_order_comment":
+                return validateAndCall(name, typedArgs, (args) => handleCreateOrderComment(args));
+            case "update_order_comment":
+                return validateAndCall(name, typedArgs, (args) => handleUpdateOrderComment(args));
+            case "delete_order_comment":
+                return validateAndCall(name, typedArgs, (args) => handleDeleteOrderComment(args));
+            // Discount operations
+            case "run_discounts":
+                return validateAndCall(name, typedArgs, (args) => handleRunDiscounts(args));
+            case "get_bundle_group":
+                return validateAndCall(name, typedArgs, (args) => handleGetBundleGroup(args));
+            case "create_or_update_bundle_group":
+                return validateAndCall(name, typedArgs, (args) => handleCreateOrUpdateBundleGroup(args));
+            case "delete_bundle_group":
+                return validateAndCall(name, typedArgs, (args) => handleDeleteBundleGroup(args));
+            case "create_discount_code":
+                return validateAndCall(name, typedArgs, (args) => handleCreateDiscountCode(args));
+            // Tax operations
+            case "get_tax_group":
+                return validateAndCall(name, typedArgs, (args) => handleGetTaxGroup(args));
+            case "create_or_update_tax_group":
+                return validateAndCall(name, typedArgs, (args) => handleCreateOrUpdateTaxGroup(args));
+            case "delete_tax_group":
+                return validateAndCall(name, typedArgs, (args) => handleDeleteTaxGroup(args));
+            case "get_tax_markets":
+                return validateAndCall(name, typedArgs, (args) => handleGetTaxMarkets(args));
+            case "create_or_update_tax_market":
+                return validateAndCall(name, typedArgs, (args) => handleCreateOrUpdateTaxMarket(args));
+            case "delete_tax_market":
+                return validateAndCall(name, typedArgs, (args) => handleDeleteTaxMarket(args));
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${error instanceof Error ? error.message : "Unknown error occurred"}`,
+                },
+            ],
+        };
+    }
+});
+// Handle resource listing
+mcpServer.setRequestHandler(ListResourcesRequestSchema, async () => {
+    const specs = apiManager.getAllSpecs();
+    const resources = specs.map(({ name, spec }) => ({
+        uri: `openapi://${name}`,
+        name: `${spec.info.title} API Specification`,
+        description: spec.info.description ?? `OpenAPI specification for ${spec.info.title}`,
+        mimeType: "application/json",
+    }));
+    return { resources };
+});
+// Handle resource reading
+mcpServer.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    const uri = request.params.uri;
+    const match = uri.match(/^openapi:\/\/(.+)$/);
+    if (!match) {
+        throw new Error(`Invalid resource URI: ${uri}`);
+    }
+    const specName = match[1];
+    const spec = apiManager.getSpec(specName);
+    if (!spec) {
+        throw new Error(`API specification '${specName}' not found`);
+    }
+    return {
+        contents: [
+            {
+                uri,
+                mimeType: "application/json",
+                text: JSON.stringify(spec, null, 2),
+            },
+        ],
+    };
+});
+async function main() {
+    try {
+        // Initialize OpenAPI manager with URL-based fetching and caching
+        logger.info("Initializing OpenAPI manager...");
+        await apiManager.initialize();
+        logger.info(`Loaded ${apiManager.getAllSpecs().length} API specifications`);
+        // Setup graceful shutdown
+        process.on("SIGINT", () => {
+            logger.info("Shutting down gracefully...");
+            apiManager.cleanup();
+            process.exit(0);
+        });
+        process.on("SIGTERM", () => {
+            logger.info("Shutting down gracefully...");
+            apiManager.cleanup();
+            process.exit(0);
+        });
+        // Run as stdio MCP server
+        const transport = new StdioServerTransport();
+        await mcpServer.connect(transport);
+    }
+    catch (error) {
+        logger.error("Failed to initialize OpenAPI manager:", error);
+        process.exit(1);
+    }
+}
+main().catch((error) => {
+    logger.error("Server startup error:", error);
+    process.exit(1);
+});

package/dist/logger.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Centralized logger utility for BrinkCommerce MCP server
+ *
+ * This logger ensures all output goes to stderr to avoid interfering with
+ * stdio JSON-RPC communication on stdout. Supports configurable log levels
+ * and environment variable control.
+ */
+export type LogLevel = "error" | "warn" | "info" | "debug";
+interface LoggerOptions {
+    level: LogLevel;
+    silent: boolean;
+}
+declare class Logger {
+    private options;
+    private readonly levels;
+    constructor();
+    private parseEnvironmentOptions;
+    private shouldLog;
+    private formatMessage;
+    private log;
+    /**
+     * Log error messages (always shown unless completely silent)
+     */
+    error(...args: unknown[]): void;
+    /**
+     * Log warning messages
+     */
+    warn(...args: unknown[]): void;
+    /**
+     * Log informational messages (default level)
+     */
+    info(...args: unknown[]): void;
+    /**
+     * Log debug messages (only shown when LOG_LEVEL=debug or MCP_DEBUG=true)
+     */
+    debug(...args: unknown[]): void;
+    /**
+     * Get current logger configuration
+     */
+    getConfig(): LoggerOptions;
+    /**
+     * Update logger configuration (mainly for testing)
+     */
+    setConfig(options: Partial<LoggerOptions>): void;
+}
+export declare const logger: Logger;
+export declare const error: (...args: unknown[]) => void, warn: (...args: unknown[]) => void, info: (...args: unknown[]) => void, debug: (...args: unknown[]) => void;
+export { Logger };