brinkcommerce-dev-mcp 0.1.0-beta.1

package/CLAUDE.md

@@ -0,0 +1,105 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Development Commands
+
+Build and development commands available via npm scripts and Makefile:
+
+```bash
+# Build and run
+npm run build          # Compile TypeScript to dist/
+npm run dev            # Development mode with hot reload using tsx
+npm start              # Start the built MCP server
+
+# Make commands (recommended)
+make setup             # Install dependencies and build
+make build             # Build TypeScript to JavaScript  
+make dev               # Run in development mode with hot reload
+make start             # Start MCP server (stdio mode)
+make test              # Test MCP server with example APIs
+make clean             # Clean build artifacts
+make claude-config     # Generate Claude configuration for local use
+make install-global    # Install globally via npm link
+make claude-config-global # Generate config for global install
+```
+
+## Architecture Overview
+
+This is a Model Context Protocol (MCP) server that provides Claude with access to BrinkCommerce OpenAPI specifications. The server enables natural language queries about APIs, endpoints, schemas, and data models.
+
+### Core Components
+
+- **`src/index.ts`** - Main MCP server implementation with stdio transport
+- **`src/openapi-utils.ts`** - OpenAPI specification parsing and management utilities
+- **`openapi-specs/`** - Directory containing BrinkCommerce API specifications (JSON/YAML)
+
+### Key Classes
+
+**OpenAPIManager** (`src/openapi-utils.ts`):
+- Loads and validates OpenAPI specs from the `openapi-specs/` directory
+- Provides methods to query endpoints, schemas, and API information
+- Handles spec dereferencing using SwaggerParser
+- Supports search functionality across all loaded APIs
+
+**MCP Server** (`src/index.ts`):
+- Implements the Model Context Protocol for Claude integration
+- Exposes 8 tools: `list_apis`, `get_api_info`, `list_endpoints`, `get_endpoint_details`, `list_schemas`, `get_schema`, `search_schemas`, `get_docs_info`
+- Provides resource access to raw OpenAPI specs via `openapi://` URIs
+- Uses stdio transport for communication with Claude
+- Self-documenting with comprehensive context for LLMs
+
+### Environment Configuration
+
+- **`DOCS_BASE_URL`** - Override documentation base URL (defaults to `https://brink-commerce.gitbook.io/brink-commerce`)
+- **`SPECS_FORCE_REFRESH`** - Force refresh of all specs on startup (set to `true` to enable)
+- **`BRINKCOMMERCE_CACHE_DIR`** - Override cache directory (highest priority)
+- **`XDG_CACHE_HOME`** - Linux/Unix cache directory (used if set, creates `$XDG_CACHE_HOME/brinkcommerce-dev-mcp`)
+
+## Working with OpenAPI Specs
+
+The server automatically fetches OpenAPI specifications from configured URLs and caches them locally with automatic 48-hour refresh. API specifications are configured in `src/config.ts` and each spec becomes an API that can be queried through the MCP tools.
+
+**Note**: Users may refer to the platform as "Brink", "Brink Commerce", or "BrinkCommerce" - these all refer to the same platform. The API names themselves don't include "brink" prefix (e.g., use "product-management" not "brink-product-management").
+
+### Cache Directory Resolution
+
+The server uses a smart cache directory resolution strategy for cross-platform compatibility:
+
+1. **`BRINKCOMMERCE_CACHE_DIR`** environment variable (highest priority)
+2. **`XDG_CACHE_HOME/brinkcommerce-dev-mcp`** on Linux/Unix systems
+3. **Platform-specific user cache directories:**
+   - **Linux**: `~/.cache/brinkcommerce-dev-mcp`
+   - **macOS**: `~/Library/Caches/brinkcommerce-dev-mcp`  
+   - **Windows**: `%LOCALAPPDATA%\brinkcommerce-dev-mcp\Cache`
+4. **`node_modules/.cache/brinkcommerce-dev-mcp`** (project-level fallback)
+5. **System temp directory** (last resort)
+
+This ensures cache persistence across different environments and survives `npm ci` operations when using user-level cache directories.
+
+BrinkCommerce APIs included:
+- Core APIs: Product Management, Order Management, Price Management, Stock Management, Store Management, Tax Management, Discount Management
+- Shopper API and payment provider integrations: Adyen, Avarda, Klarna, Ledyer, Svea, Walley, Qliro, and more
+- Supporting services: Voyado, Retain24, BSG/KBS Gift Cards, Bonus, Ingrid, NShift, Zaver
+
+The server provides both high-level API information and detailed endpoint/schema inspection capabilities through natural language queries via Claude, with automatic cache management and 48-hour refresh cycles.
+
+## Library Documentation
+
+Comprehensive documentation for all project dependencies is available in the `/docs/libraries/` directory:
+
+### Core Libraries
+- **[MCP TypeScript SDK](docs/libraries/mcp-typescript-sdk.md)** - Model Context Protocol implementation for creating servers and clients
+- **[dotenv](docs/libraries/dotenv.md)** - Environment variable management from .env files
+- **[js-yaml](docs/libraries/js-yaml.md)** - YAML parser and writer for JavaScript
+- **[node-fetch](docs/libraries/node-fetch.md)** - HTTP client bringing Fetch API to Node.js
+- **[swagger-parser](docs/libraries/swagger-parser.md)** - OpenAPI specification parsing and validation
+
+Each documentation file includes:
+- Installation and setup instructions
+- Code examples and usage patterns
+- Configuration options and best practices
+- Common use cases and troubleshooting
+- Migration guides for version updates
+
+This documentation was retrieved using Context7 and provides comprehensive reference material for working with the project's dependencies.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Brink Commerce AB
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,495 @@
+# BrinkCommerce Dev MCP Server
+
+[![Node Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org)
+[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+[![MCP Protocol](https://img.shields.io/badge/MCP-1.0-purple)](https://modelcontextprotocol.io)
+[![Beta](https://img.shields.io/badge/status-beta-orange)](https://github.com/brinkcommerce/brinkcommerce-dev-mcp)
+
+> **Beta Release**: This package is in beta. APIs may change. Please report issues on GitHub.
+
+A Model Context Protocol (MCP) server that provides Claude and other AI assistants with both deep knowledge of BrinkCommerce APIs and direct management capabilities. Explore API documentation, create products, manage inventory, update prices, configure stores, and more.
+
+---
+
+## ⚠️ Important: Safety Notice for Write Operations
+
+> **Use with caution**: This MCP server can modify your BrinkCommerce configuration including products, prices, inventory, orders, and more. AI agents cannot be fully controlled by the server - **safety is your responsibility**.
+
+### Critical Recommendations
+
+1. **NEVER enable auto-accept** for tool calls when using AI assistants with this MCP server
+2. **Review every write operation** before approving - the AI will do exactly what you approve
+3. **Use read-only mode first** for exploration (omit API credentials)
+4. **Test in a staging environment** before connecting to production
+
+### Why Manual Review is Critical
+
+The MCP protocol has no mechanism to force user confirmation - all safety measures are **advisory**. The AI will generate correct parameters for any operation it decides to perform. The only real protection is **you reviewing each tool call** before it executes.
+
+### Read-Only Mode
+
+To use this MCP server in read-only mode for API documentation exploration only:
+- Simply don't configure the `BRINK_CLIENT_ID` and `BRINK_CLIENT_SECRET` environment variables
+- All write operations will fail with authentication errors
+- Documentation tools (`list_apis`, `search_schemas`, etc.) will work normally
+
+---
+
+## What It Does
+
+This MCP server gives AI assistants access to:
+- **23 BrinkCommerce APIs** - Product, Order, Inventory, Pricing, and Payment integrations
+- **Direct Management** - Create products, manage inventory, update prices, configure stores
+- **Natural Language Queries** - "How do I create a product?" or "Show me the Order schema"
+- **Smart Search** - Find APIs and schemas by field names across the entire platform
+- **Offline-First** - All specs cached locally for instant responses
+
+## Requirements
+
+- Node.js 18+ (for npx)
+
+## Set Up the Server
+
+Choose your AI development tool and follow the setup instructions:
+
+### Claude Desktop
+
+Add to your Claude Desktop configuration file:
+
+**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+**Linux:** `~/.config/claude/claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "brinkcommerce": {
+      "command": "npx",
+      "args": ["-y", "brinkcommerce-dev-mcp@beta"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop after saving.
+
+### Claude Code (CLI)
+
+```bash
+claude mcp add brinkcommerce -- npx -y brinkcommerce-dev-mcp@beta
+```
+
+### Cursor
+
+1. Open **Settings** → **Tools and Integrations** → **MCP Servers**
+2. Click **Add new MCP Server**
+3. Add this configuration:
+
+```json
+{
+  "mcpServers": {
+    "brinkcommerce": {
+      "command": "npx",
+      "args": ["-y", "brinkcommerce-dev-mcp@beta"]
+    }
+  }
+}
+```
+
+### VS Code (Copilot)
+
+Add to your VS Code `settings.json`:
+
+```json
+{
+  "mcp": {
+    "servers": {
+      "brinkcommerce": {
+        "command": "npx",
+        "args": ["-y", "brinkcommerce-dev-mcp@beta"]
+      }
+    }
+  }
+}
+```
+
+### Windsurf
+
+Add to `~/.codeium/windsurf/mcp_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "brinkcommerce": {
+      "command": "npx",
+      "args": ["-y", "brinkcommerce-dev-mcp@beta"]
+    }
+  }
+}
+```
+
+### Windows Troubleshooting
+
+If you have connection issues on Windows, use this alternative configuration:
+
+```json
+{
+  "mcpServers": {
+    "brinkcommerce": {
+      "command": "cmd",
+      "args": ["/c", "npx", "-y", "brinkcommerce-dev-mcp@beta"]
+    }
+  }
+}
+```
+
+---
+
+## Configure API Access (Optional)
+
+The server works out of the box for **API documentation** queries. To use **management tools** (create products, update inventory, etc.), add your BrinkCommerce credentials:
+
+### Claude Desktop
+
+```json
+{
+  "mcpServers": {
+    "brinkcommerce": {
+      "command": "npx",
+      "args": ["-y", "brinkcommerce-dev-mcp@beta"],
+      "env": {
+        "BRINK_CLIENT_ID": "your-client-id",
+        "BRINK_CLIENT_SECRET": "your-client-secret",
+        "BRINK_CUSTOMER_NAME": "your-customer-name"
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add brinkcommerce \
+  -e BRINK_CLIENT_ID=your-client-id \
+  -e BRINK_CLIENT_SECRET=your-client-secret \
+  -e BRINK_CUSTOMER_NAME=your-customer-name \
+  -- npx -y brinkcommerce-dev-mcp@beta
+```
+
+### Other Tools
+
+Add the environment variables to your tool's MCP configuration using the `env` property as shown above.
+
+---
+
+## Start Using
+
+Once configured, try these queries in your AI assistant:
+
+**API Documentation:**
+- "What BrinkCommerce APIs are available?"
+- "Show me the Order schema"
+- "Find all APIs that handle payments"
+
+**Direct Management** (requires API credentials):
+- "Create a product parent called 'Blue T-Shirt'"
+- "Update inventory for variant-123 to 50 units"
+- "Set prices for product in Sweden and Norway"
+- "Create a B2C store group"
+
+---
+
+## Alternative Installation
+
+### From Source
+
+```bash
+git clone https://github.com/brinkcommerce/brinkcommerce-dev-mcp.git
+cd brinkcommerce-dev-mcp
+make setup
+make claude-config  # Generate configuration
+```
+
+### Global Install
+
+```bash
+npm install -g brinkcommerce-dev-mcp
+```
+
+## Available Tools
+
+### API Documentation Tools
+
+| Tool | Description | Example |
+|------|-------------|---------|
+| `get_docs_info` | Platform overview and documentation | Start here for introduction |
+| `search_schemas` | Find data models by field names | Search for "email", "price", "inventory" |
+| `list_apis` | List all available APIs | See all 23 BrinkCommerce APIs |
+| `get_api_info` | Get details about a specific API | Learn about ProductManagement API |
+| `list_endpoints` | List API endpoints | Find all POST endpoints |
+| `get_endpoint_details` | Get endpoint specifications | See how to GET /products/{id} |
+| `list_schemas` | List data models for an API | View all Order schemas |
+| `get_schema` | Get schema field details | Examine Product model |
+
+### Product Management Tools
+
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `get_product_parent` | Get a product parent by ID | productParentId |
+| `create_product_parent` | Create or update a product parent | productParentId, name, description, displayNames, displayDescriptions |
+| `patch_product_parent` | Partially update a product parent (only update specified fields) | productParentId |
+| `delete_product_parent` | Delete a product parent | productParentId |
+| `archive_product_parent` | Archive a product parent (soft delete) | productParentId |
+| `get_product_variant` | Get a product variant by ID | productVariantId |
+| `list_product_variants` | List all variants for a product parent | productParentId |
+| `create_product_variant` | Create or update a product variant | productVariantId, productParentId, taxGroupId, imageUrl |
+| `patch_product_variant` | Partially update a product variant (only update specified fields) | productVariantId |
+| `delete_product_variant` | Delete a product variant | productVariantId |
+
+### Addon Tools
+
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `get_addon` | Get an addon by ID | addonId |
+| `create_or_update_addon` | Create or update an addon | addonId, name, description, displayNames, displayDescriptions, taxGroupId, imageUrl |
+| `patch_addon` | Partially update an addon (only update specified fields) | addonId |
+| `delete_addon` | Delete an addon | addonId |
+| `list_product_parent_addons` | List addons for a product parent | productParentId |
+| `add_product_parent_addon` | Add an addon to a product parent | productParentId, addonId |
+| `remove_product_parent_addon` | Remove an addon from a product parent | productParentId, addonId |
+
+### Store Management Tools
+
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `list_store_groups` | List all store groups | - |
+| `get_store_group` | Get a store group by ID | storeGroupId |
+| `create_or_update_store_group` | Create or update a store group | storeGroupId, name, description |
+| `patch_store_group` | Partial update of a store group | storeGroupId |
+| `delete_store_group` | Delete a store group | storeGroupId |
+| `list_store_markets` | List all markets for a store group | storeGroupId |
+| `create_or_update_store_market` | Create or update a store market | storeGroupId, countryCode, currencyCode, isTaxIncludedInPrice |
+| `patch_store_market` | Partial update of a store market | storeGroupId, countryCode |
+| `delete_store_market` | Delete a store market | storeGroupId, countryCode |
+
+### Stock Management Tools
+
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `list_inventories` | List all inventory locations | - |
+| `get_inventory` | Get a specific inventory location | inventoryId |
+| `create_or_update_inventory` | Create or update an inventory location | inventoryId, name, description |
+| `delete_inventory` | Delete an inventory location | inventoryId |
+| `get_product_variant_stock` | Get stock information for a product variant | productVariantId |
+| `update_product_variant_stock_config` | Update stock config for a variant (validateStock) | productVariantId, validateStock |
+| `update_product_variant_inventory` | Update inventory for a product variant | productVariantId, inventoryId, quantity |
+| `patch_product_variant_inventory` | Adjust inventory quantity (add/subtract) | productVariantId, inventoryId, quantityAdjustment |
+| `delete_product_variant_inventory` | Delete inventory for a product variant | productVariantId, inventoryId |
+| `get_store_market_inventories` | Get store market inventory configuration | storeGroupId, countryCode |
+| `update_store_market_inventories` | Update store market inventory priorities | storeGroupId, countryCode, inventoryIds |
+
+### Price Management Tools
+
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `get_product_variant_all_prices` | Get all prices for a variant across all store groups | productVariantId |
+| `get_product_variant_prices` | Get prices for a variant in a specific store group | storeGroupId, productVariantId |
+| `get_product_variant_price` | Get single price for a variant in a specific market | storeGroupId, countryCode, productVariantId |
+| `get_addon_price` | Get price for an addon in a specific market | storeGroupId, countryCode, addonId |
+| `update_product_variant_prices` | Update prices for a product variant across markets | storeGroupId, productVariantId, productVariantPrices |
+| `patch_product_variant_prices` | Partial update of product variant prices | storeGroupId, productVariantId, priceUpdates |
+| `delete_product_variant_prices` | Price deletion not available (update to zero instead) | N/A |
+
+### Order Management Tools
+
+**Core Operations:**
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `get_order` | Get order by ID | orderId |
+| `get_order_by_reference` | Get order by reference | reference |
+| `cancel_order` | Cancel an order | orderId |
+| `refund_order` | Refund an order | orderId |
+| `import_order` | Import external order | orderData |
+| `create_delivery` | Create delivery for order | orderId, deliveryData |
+| `create_release` | Create release for order | orderId, releaseData |
+
+**Order Queries:**
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `get_orders_by_email` | Search orders by customer email | email |
+| `get_orders_by_merchant_ref` | Search orders by merchant reference | merchantRef1 |
+| `get_order_history` | Get order status history | orderId |
+| `get_order_reservation` | Get stock reservation info | orderId |
+| `delete_order` | Delete order (30+ days old only) | orderId |
+
+**Order Collections:**
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `list_order_deliveries` | List all deliveries for an order | orderId |
+| `list_order_cancellations` | List all cancellations for an order | orderId |
+| `list_order_refunds` | List all refunds for an order | orderId |
+| `list_order_releases` | List all releases for an order | orderId |
+| `list_order_compensations` | List all compensations for an order | orderId |
+| `list_order_modifications` | List all modifications for an order | orderId |
+
+**Compensations (partial refunds without returns):**
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `create_compensation` | Create compensation | orderId, request |
+| `get_compensation` | Get compensation details | compensationId |
+| `update_compensation` | Update before starting | compensationId, request |
+| `delete_compensation` | Delete before starting | compensationId |
+| `start_compensation` | Start compensation processing | compensationId |
+| `restart_compensation` | Restart failed compensation | compensationId |
+
+**Order Lines Modifications:**
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `create_order_lines_modification` | Create order lines mod | orderId, request |
+| `get_order_lines_modification` | Get modification details | modificationId |
+| `update_order_lines_modification` | Update before starting | modificationId, request |
+| `delete_order_lines_modification` | Delete before starting | modificationId |
+| `start_order_lines_modification` | Start modification | modificationId |
+| `restart_order_lines_modification` | Restart failed modification | modificationId |
+
+**Shipping Fees Modifications:**
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `create_shipping_fees_modification` | Create shipping fees mod | orderId, request |
+| `get_shipping_fees_modification` | Get modification details | modificationId |
+| `update_shipping_fees_modification` | Update before starting | modificationId, request |
+| `delete_shipping_fees_modification` | Delete before starting | modificationId |
+| `start_shipping_fees_modification` | Start modification | modificationId |
+| `restart_shipping_fees_modification` | Restart failed modification | modificationId |
+
+**Addresses Modifications:**
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `create_addresses_modification` | Create addresses mod | orderId, request |
+| `get_addresses_modification` | Get modification details | modificationId |
+| `update_addresses_modification` | Update before starting | modificationId, request |
+| `delete_addresses_modification` | Delete before starting | modificationId |
+| `start_addresses_modification` | Start modification | modificationId |
+
+**Custom States (control order operations):**
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `list_custom_states` | List all custom states | - |
+| `get_custom_state` | Get custom state details | stateId |
+| `create_custom_state` | Create custom state | stateId, name |
+| `delete_custom_state` | Delete custom state | stateId |
+| `add_order_custom_state` | Add state to order | orderId, stateId |
+| `remove_order_custom_state` | Remove state from order | orderId, stateId |
+
+**Custom Reason Codes:**
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `list_custom_reason_codes` | List all reason codes | - |
+| `get_custom_reason_code` | Get reason code details | code |
+| `create_custom_reason_code` | Create reason code | code, name |
+| `delete_custom_reason_code` | Delete reason code | code |
+
+**Order Comments:**
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `create_order_comment` | Add comment to order | orderId, text |
+| `update_order_comment` | Update existing comment | orderId, commentId, text |
+| `delete_order_comment` | Delete comment | orderId, commentId |
+
+### Discount Management Tools
+
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `run_discounts` | Run discount calculations | discountRunData |
+| `get_bundle_group` | Get bundle group by ID | bundleGroupId |
+| `create_or_update_bundle_group` | Create or update bundle group | bundleGroupId, bundleGroupData |
+| `delete_bundle_group` | Delete bundle group | bundleGroupId |
+| `create_discount_code` | Create a discount code | discountCodeData |
+
+### Tax Management Tools
+
+| Tool | Description | Required Parameters |
+|------|-------------|-------------------|
+| `get_tax_group` | Get tax group by ID | taxGroupId |
+| `create_or_update_tax_group` | Create or update tax group | taxGroupId, taxGroupData |
+| `delete_tax_group` | Delete tax group | taxGroupId |
+| `get_tax_markets` | Get tax markets for a tax group | taxGroupId |
+| `create_or_update_tax_market` | Create or update tax market | taxGroupId, countryCode, taxMarketData |
+| `delete_tax_market` | Delete tax market | taxGroupId, countryCode |
+
+## Testing
+
+```bash
+# Quick test
+make test
+
+# Interactive testing with MCP Inspector
+make inspect
+# Open http://localhost:6274
+```
+
+## Development
+
+```bash
+# Development mode with hot reload
+make dev
+
+# Run all checks
+make check
+
+# View all commands
+make help
+```
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Description | Default | Required |
+|----------|-------------|---------|----------|
+| `BRINK_CLIENT_ID` | OAuth2 client ID for BrinkCommerce API | - | For management tools |
+| `BRINK_CLIENT_SECRET` | OAuth2 client secret for BrinkCommerce API | - | For management tools |
+| `BRINK_CUSTOMER_NAME` | Your BrinkCommerce customer name | - | For management tools |
+| `BRINK_REGION` | BrinkCommerce region (eu-west-1, us-east-1) | `eu-west-1` | Optional |
+| `BRINK_API_KEY` | API key for additional authentication | - | Optional |
+| `BRINKCOMMERCE_CACHE_DIR` | Cache directory location | Platform-specific | Optional |
+| `SPECS_FORCE_REFRESH` | Force refresh all specs on startup | `false` | Optional |
+| `LOG_LEVEL` | Logging verbosity (debug/info/warn/error) | `info` | Optional |
+
+## Troubleshooting
+
+### Server not connecting?
+1. Verify Node.js 18+: `node --version`
+2. Test npx directly: `npx -y brinkcommerce-dev-mcp@beta`
+3. Restart your AI tool completely
+4. Check the tool's developer console for errors
+
+### Windows issues?
+Use the `cmd` wrapper configuration shown in [Windows Troubleshooting](#windows-troubleshooting)
+
+### Cache issues?
+```bash
+SPECS_FORCE_REFRESH=true npx brinkcommerce-dev-mcp@beta
+```
+
+### Need debug output?
+```bash
+LOG_LEVEL=debug npx brinkcommerce-dev-mcp@beta
+```
+
+## Documentation
+
+- [Testing Guide](TESTING.md) - Comprehensive testing documentation
+- [Architecture](ARCHITECTURE.md) - Technical implementation details
+- [Claude Setup](CLAUDE.md) - AI-assisted development guide
+- [BrinkCommerce Docs](https://brink-commerce.gitbook.io/brink-commerce) - Platform documentation
+
+## License
+
+MIT - see [LICENSE](LICENSE) file
+
+## Support
+
+- **Issues**: [GitHub Issues](https://github.com/brinkcommerce/brinkcommerce-dev-mcp/issues)
+- **MCP Protocol**: [modelcontextprotocol.io](https://modelcontextprotocol.io)

package/dist/api-client.d.ts

@@ -0,0 +1,9 @@
+/**
+ * BrinkCommerce API Clients
+ *
+ * This file re-exports all clients from the clients directory for backward compatibility.
+ * New code should import directly from './clients/index.js' instead.
+ *
+ * @deprecated Import from './clients/index.js' instead
+ */
+export { type BrinkApiClientConfig, type ApiResult, BrinkProductManagementClient, createProductManagementClient, BrinkStoreManagementClient, createStoreManagementClient, BrinkStockManagementClient, createStockManagementClient, BrinkPriceManagementClient, createPriceManagementClient, BrinkOrderManagementClient, createOrderManagementClient, BrinkDiscountManagementClient, createDiscountManagementClient, BrinkTaxManagementClient, createTaxManagementClient, } from "./clients/index.js";

package/dist/api-client.js

@@ -0,0 +1,23 @@
+/**
+ * BrinkCommerce API Clients
+ *
+ * This file re-exports all clients from the clients directory for backward compatibility.
+ * New code should import directly from './clients/index.js' instead.
+ *
+ * @deprecated Import from './clients/index.js' instead
+ */
+export { 
+// Product Management
+BrinkProductManagementClient, createProductManagementClient, 
+// Store Management
+BrinkStoreManagementClient, createStoreManagementClient, 
+// Stock Management
+BrinkStockManagementClient, createStockManagementClient, 
+// Price Management
+BrinkPriceManagementClient, createPriceManagementClient, 
+// Order Management
+BrinkOrderManagementClient, createOrderManagementClient, 
+// Discount Management
+BrinkDiscountManagementClient, createDiscountManagementClient, 
+// Tax Management
+BrinkTaxManagementClient, createTaxManagementClient, } from "./clients/index.js";