mcp-grocy 1.10.0 → 2.0.0

package/README.md

@@ -63,7 +63,7 @@ Transform your LLM into an intelligent household management assistant with focus
    
    # Configure
    cp .env.example .env
-   # Edit .env with your GROCY_BASE_URL and GROCY_APIKEY_VALUE
+   # Edit .env with your GROCY_BASE_URL and GROCY_API_KEY
    
    # Run
    docker compose up -d
@@ -74,7 +74,7 @@ Test with mock data (no real Grocy instance needed):
 ```bash
 # In .env file, any values work for mock mode
 GROCY_BASE_URL=http://mock
-GROCY_APIKEY_VALUE=mock
+GROCY_API_KEY=mock
 
 npm install && npm run dev
 ```
@@ -93,7 +93,7 @@ npm run build
 ### Docker
 
 ```bash
-docker run -e GROCY_APIKEY_VALUE=your_api_key -e GROCY_BASE_URL=http://your-grocy-instance ghcr.io/miguelangel-nubla/mcp-grocy:latest
+docker run -e GROCY_API_KEY=your_api_key -e GROCY_BASE_URL=http://your-grocy-instance ghcr.io/miguelangel-nubla/mcp-grocy:latest
 ```
 
 ### Docker Compose (Recommended)
@@ -126,20 +126,20 @@ docker compose up -d
 2. **Configure the server:**
    ```bash
    cp .env.example .env
-   # Edit .env with your GROCY_BASE_URL and GROCY_APIKEY_VALUE
+   # Edit .env with your GROCY_BASE_URL and GROCY_API_KEY
    ```
 
 3. **Essential variables:**
    - `GROCY_BASE_URL` - Your Grocy instance URL
-   - `GROCY_APIKEY_VALUE` - Your Grocy API key
+   - `GROCY_API_KEY` - Your Grocy API key
 
 ### Configuration Options
 
 | Method | Use Case | Command |
 |--------|----------|---------|
 | **`.env` file** | Recommended for most users | `cp .env.example .env` |
-| **Environment variables** | CI/CD, containers | `GROCY_BASE_URL=... GROCY_APIKEY_VALUE=... mcp-grocy` |
-| **Tool toggles** | Customize functionality | Edit `TOOL__*` variables in `.env` |
+| **Environment variables** | CI/CD, containers | `GROCY_BASE_URL=... GROCY_API_KEY=... mcp-grocy` |
+| **Tool configuration** | Customize functionality | Edit `tools` section in `mcp-grocy.yaml` |
 
 📖 **For complete configuration reference:** See [Configuration Guide](src/resources/config.md)
 
@@ -172,7 +172,7 @@ npm start
 |----------|---------|-------------|
 | [📖 API Reference](src/resources/api-reference.md) | Complete tool documentation | Tool usage and examples |
 | [⚙️ Configuration Guide](src/resources/config.md) | Advanced configuration reference | Detailed setup, presets, troubleshooting |
-| [📋 .env.example](.env.example) | Configuration template with ALL tools | Copy and customize for your setup |
+| [📋 .env.example](.env.example) | Environment configuration template | Copy and customize for your setup |
 | [🧪 MCP Inspector](https://github.com/modelcontextprotocol/inspector) | Protocol debugging | Debug MCP interactions |
 
 ### 🆘 Troubleshooting
@@ -185,17 +185,17 @@ npm start
 - For HTTPS URLs, ensure SSL certificate is valid or disable verification with `GROCY_ENABLE_SSL_VERIFY=false`
 
 **"Invalid API key" or "Authentication failed"**
-- Verify your `GROCY_APIKEY_VALUE` is correct
+- Verify your `GROCY_API_KEY` is correct
 - Check that the API key exists in your Grocy instance (User Settings → API Keys)
 - Ensure the API key has proper permissions
 
 **"Tool not found" errors**
-- Check if the tool is enabled in your `.env` file (tool toggles)
+- Check if the tool is enabled in your `mcp-grocy.yaml` file
 - Verify you're using the correct tool names from the API reference
 
 **Large response errors**
 - Increase `REST_RESPONSE_SIZE_LIMIT` if you have many products/stock entries
-- Consider using tool toggles to disable unused functionality
+- Consider disabling unused tools in `mcp-grocy.yaml`
 
 #### Debug Mode
 

package/build/api/client.js

@@ -1,77 +1,64 @@
+/**
+ * Simplified API client for Grocy
+ */
 import axios from 'axios';
 import https from 'https';
-import config from '../config/environment.js';
-export class ApiError extends Error {
-    status;
-    response;
-    constructor(message, status, response) {
-        super(message);
-        this.name = 'ApiError';
-        this.status = status;
-        this.response = response;
-    }
-}
+import { config } from '../config/index.js';
+import { logger } from '../utils/logger.js';
+import { ApiError, ErrorHandler } from '../utils/errors.js';
 export class GrocyApiClient {
     axiosInstance;
     API_KEY_HEADER = 'GROCY-API-KEY';
     constructor() {
-        const { GROCY_ENABLE_SSL_VERIFY, GROCY_APIKEY_VALUE } = config.get();
-        this.axiosInstance = axios.create({
-            baseURL: config.getGrocyBaseUrl(),
-            validateStatus: () => true, // Allow any status code
-            timeout: 30000, // 30 seconds timeout
-            httpsAgent: GROCY_ENABLE_SSL_VERIFY ? undefined : new https.Agent({
+        this.axiosInstance = this.createAxiosInstance();
+        this.setupInterceptors();
+    }
+    createAxiosInstance() {
+        const instance = axios.create({
+            baseURL: config.grocy.base_url,
+            validateStatus: () => true, // Handle all status codes manually
+            timeout: 30000,
+            httpsAgent: config.grocy.enable_ssl_verify ? undefined : new https.Agent({
                 rejectUnauthorized: false
             })
         });
-        // Set default authentication if available
-        if (GROCY_APIKEY_VALUE) {
-            this.axiosInstance.defaults.headers.common[this.API_KEY_HEADER] = GROCY_APIKEY_VALUE;
+        // Set default authentication
+        if (config.grocy.api_key) {
+            instance.defaults.headers.common[this.API_KEY_HEADER] = config.grocy.api_key;
         }
-        // Add request interceptor for logging
+        return instance;
+    }
+    setupInterceptors() {
+        // Request logging
         this.axiosInstance.interceptors.request.use((config) => {
-            console.error(`[API] ${config.method?.toUpperCase()} ${config.url}`);
-            if (config.data) {
-                console.error(`[API] Request body: ${JSON.stringify(config.data)}`);
-            }
+            logger.api(`${config.method?.toUpperCase()} ${config.url}`);
             return config;
         }, (error) => {
-            console.error('[API] Request error:', error);
+            logger.error('Request error', 'API', { error: error.message });
             return Promise.reject(error);
         });
-        // Add response interceptor for error handling
+        // Response logging
         this.axiosInstance.interceptors.response.use((response) => {
             if (response.status >= 400) {
-                console.error(`[API] Error response (${response.status}): ${JSON.stringify(response.data)}`);
+                logger.warn(`HTTP ${response.status}`, 'API', {
+                    url: response.config?.url,
+                    status: response.status
+                });
             }
             return response;
         }, (error) => {
-            console.error('[API] Response error:', error);
+            logger.error('Response error', 'API', { error: error.message });
             return Promise.reject(error);
         });
     }
     normalizeEndpoint(endpoint) {
-        // Standardize path handling
-        let normalizedEndpoint = endpoint;
-        // Check if endpoint explicitly starts with /api/ - use it as is
-        if (endpoint.startsWith('/api/')) {
-            normalizedEndpoint = endpoint;
-        }
-        // Handle endpoints that start with api/ without leading slash
-        else if (endpoint.startsWith('api/')) {
-            normalizedEndpoint = `/${endpoint}`;
-        }
-        // All other endpoints - ensure they start with /api/
-        else {
-            if (endpoint.startsWith('/')) {
-                normalizedEndpoint = `/api${endpoint}`;
-            }
-            else {
-                normalizedEndpoint = `/api/${endpoint}`;
-            }
-        }
-        console.error(`[API] Normalized endpoint: ${normalizedEndpoint}`);
-        return normalizedEndpoint;
+        if (endpoint.startsWith('/api/'))
+            return endpoint;
+        if (endpoint.startsWith('api/'))
+            return `/${endpoint}`;
+        if (endpoint.startsWith('/'))
+            return `/api${endpoint}`;
+        return `/api/${endpoint}`;
     }
     buildQueryString(params) {
         return Object.entries(params)
@@ -80,57 +67,35 @@ export class GrocyApiClient {
     }
     async request(endpoint, options = {}) {
         const { method = 'GET', body = null, headers = {}, queryParams = {}, timeout } = options;
-        let url = this.normalizeEndpoint(endpoint);
-        // Add query parameters
-        if (Object.keys(queryParams).length > 0) {
-            const queryString = this.buildQueryString(queryParams);
-            url += `?${queryString}`;
-        }
-        const requestConfig = {
-            method,
-            url,
-            headers: {
-                'Accept': 'application/json',
-                'Content-Type': 'application/json',
-                ...config.getCustomHeaders(),
-                ...headers
-            },
-            timeout
-        };
-        if (['POST', 'PUT', 'PATCH'].includes(method) && body !== null) {
-            requestConfig.data = body;
-        }
-        try {
+        return ErrorHandler.handleAsync(async () => {
+            let url = this.normalizeEndpoint(endpoint);
+            if (Object.keys(queryParams).length > 0) {
+                url += `?${this.buildQueryString(queryParams)}`;
+            }
+            const requestConfig = {
+                method,
+                url,
+                headers: {
+                    'Accept': 'application/json',
+                    'Content-Type': 'application/json',
+                    ...config.getCustomHeaders(),
+                    ...headers
+                },
+                ...(timeout && { timeout })
+            };
+            if (['POST', 'PUT', 'PATCH'].includes(method) && body !== null) {
+                requestConfig.data = body;
+            }
             const response = await this.axiosInstance.request(requestConfig);
             if (response.status >= 400) {
-                throw new ApiError(`API error (${response.status}): ${JSON.stringify(response.data)}`, response.status, response.data);
+                throw new ApiError(response.data?.message || `HTTP ${response.status} error`, response.status, `${method} ${url}`, { responseData: response.data });
             }
             return {
                 data: response.data,
                 status: response.status,
                 headers: response.headers
             };
-        }
-        catch (error) {
-            if (axios.isAxiosError(error)) {
-                const axiosError = error;
-                if (axiosError.code === 'ECONNABORTED') {
-                    throw new ApiError('Connection timeout: The server took too long to respond');
-                }
-                else if (axiosError.code === 'ECONNRESET' || axiosError.message.includes('socket hang up')) {
-                    throw new ApiError('Connection reset: The server unexpectedly closed the connection');
-                }
-                else if (!axiosError.response) {
-                    throw new ApiError('Network error: Unable to reach the Grocy server');
-                }
-            }
-            // Re-throw ApiError instances
-            if (error instanceof ApiError) {
-                throw error;
-            }
-            // Wrap other errors
-            throw new ApiError(`Request failed: ${error.message || error}`);
-        }
+        }, `API ${method} ${endpoint}`);
     }
     // Convenience methods
     async get(endpoint, options = {}) {
@@ -149,6 +114,8 @@ export class GrocyApiClient {
         return this.request(endpoint, { ...options, method: 'PATCH', body });
     }
 }
-// Export a singleton instance
+// Export singleton instance
 export const apiClient = new GrocyApiClient();
 export default apiClient;
+// Re-export ApiError for convenience
+export { ApiError };

package/build/config/index.js

@@ -0,0 +1,200 @@
+/**
+ * Unified configuration system
+ * Combines environment variables and YAML configuration
+ */
+import { z } from 'zod';
+import { readFileSync, existsSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import YAML from 'yaml';
+import { logger } from '../utils/logger.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+// Environment schema
+const EnvironmentSchema = z.object({
+    // Grocy Configuration
+    GROCY_BASE_URL: z.string().url().optional(),
+    GROCY_API_KEY: z.string().optional(),
+    GROCY_ENABLE_SSL_VERIFY: z.enum(['true', 'false']).optional(),
+    // Server Configuration  
+    REST_RESPONSE_SIZE_LIMIT: z.string().regex(/^\d+$/).optional(),
+    ENABLE_HTTP_SERVER: z.enum(['true', 'false']).optional(),
+    HTTP_SERVER_PORT: z.string().regex(/^\d+$/).optional(),
+    // Logging Configuration
+    LOG_LEVEL: z.enum(['DEBUG', 'INFO', 'WARN', 'ERROR']).optional(),
+    LOG_CATEGORIES: z.string().optional(),
+    // Build Configuration
+    RELEASE_VERSION: z.string().optional(),
+    NODE_ENV: z.enum(['development', 'production', 'test']).optional(),
+});
+// YAML configuration schema
+const YamlConfigSchema = z.object({
+    server: z.object({
+        enable_http_server: z.boolean().default(false),
+        http_server_port: z.number().min(1).max(65535).default(8080),
+    }).default({}),
+    grocy: z.object({
+        base_url: z.string().url().default('http://localhost:9283'),
+        api_key: z.string().optional(),
+        enable_ssl_verify: z.boolean().default(true),
+        response_size_limit: z.number().positive().default(10000),
+    }).default({}),
+    tools: z.record(z.string(), z.object({
+        enabled: z.boolean().default(false),
+        ack_token: z.string().optional(),
+    }).catchall(z.unknown())).default({}),
+});
+export class ConfigManager {
+    static instance;
+    config;
+    // Unified config properties - final resolved values
+    grocy;
+    server;
+    tools;
+    constructor(configPath) {
+        this.config = this.loadConfig(configPath);
+        // Expose final resolved values
+        this.grocy = {
+            base_url: this.config.yaml.grocy.base_url,
+            ...(this.config.yaml.grocy.api_key !== undefined && { api_key: this.config.yaml.grocy.api_key }),
+            enable_ssl_verify: this.config.yaml.grocy.enable_ssl_verify,
+            response_size_limit: this.config.yaml.grocy.response_size_limit
+        };
+        this.server = {
+            enable_http_server: this.config.yaml.server.enable_http_server,
+            http_server_port: this.config.yaml.server.http_server_port
+        };
+        this.tools = this.config.yaml.tools;
+    }
+    static getInstance() {
+        if (!ConfigManager.instance) {
+            ConfigManager.instance = new ConfigManager();
+        }
+        return ConfigManager.instance;
+    }
+    loadConfig(configPath) {
+        // Load environment variables
+        const env = this.loadEnvironment();
+        // Load YAML configuration
+        const yaml = this.loadYamlConfig(configPath);
+        // Apply environment variable overrides
+        this.applyEnvironmentOverrides(yaml, env);
+        return { env, yaml };
+    }
+    loadEnvironment() {
+        try {
+            return EnvironmentSchema.parse(process.env);
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                logger.error('Invalid environment variables', 'CONFIG');
+                error.errors.forEach(err => {
+                    logger.error(`${err.path.join('.')}: ${err.message}`, 'CONFIG');
+                });
+                process.exit(1);
+            }
+            throw error;
+        }
+    }
+    loadYamlConfig(configPath) {
+        const yamlPath = this.findConfigFile(configPath);
+        try {
+            let configData = {};
+            if (existsSync(yamlPath)) {
+                const yamlContent = readFileSync(yamlPath, 'utf8');
+                configData = YAML.parse(yamlContent) || {};
+                logger.config(`Loaded YAML config from: ${yamlPath}`);
+            }
+            else {
+                logger.config('No YAML config found, using defaults');
+            }
+            return YamlConfigSchema.parse(configData);
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                logger.error('Invalid YAML configuration', 'CONFIG');
+                error.errors.forEach(err => {
+                    logger.error(`${err.path.join('.')}: ${err.message}`, 'CONFIG');
+                });
+                process.exit(1);
+            }
+            throw error;
+        }
+    }
+    findConfigFile(configPath) {
+        if (configPath)
+            return configPath;
+        // Look for config files in the following order:
+        // 1. Current working directory (for development)
+        // 2. Project root (relative to the compiled main.js)
+        const projectRoot = resolve(__dirname, '../..');
+        const possiblePaths = [
+            resolve(process.cwd(), 'mcp-grocy.yaml'),
+            resolve(process.cwd(), 'mcp-grocy.yml'),
+            resolve(projectRoot, 'mcp-grocy.yaml'),
+            resolve(projectRoot, 'mcp-grocy.yml'),
+        ];
+        return possiblePaths.find(path => existsSync(path)) ?? possiblePaths[0];
+    }
+    // Public getters
+    getConfig() {
+        return this.config;
+    }
+    getApiUrl() {
+        return this.grocy.base_url.endsWith('/') ? `${this.grocy.base_url}api` : `${this.grocy.base_url}/api`;
+    }
+    getCustomHeaders() {
+        const headers = {};
+        if (this.grocy.api_key) {
+            headers['GROCY-API-KEY'] = this.grocy.api_key;
+        }
+        return headers;
+    }
+    /**
+     * Apply environment variable overrides to YAML configuration
+     */
+    applyEnvironmentOverrides(yaml, env) {
+        // Grocy configuration overrides
+        if (env.GROCY_BASE_URL) {
+            yaml.grocy.base_url = env.GROCY_BASE_URL;
+        }
+        if (env.GROCY_API_KEY) {
+            yaml.grocy.api_key = env.GROCY_API_KEY;
+        }
+        if (env.GROCY_ENABLE_SSL_VERIFY !== undefined) {
+            yaml.grocy.enable_ssl_verify = env.GROCY_ENABLE_SSL_VERIFY === 'true';
+        }
+        if (env.REST_RESPONSE_SIZE_LIMIT !== undefined) {
+            yaml.grocy.response_size_limit = parseInt(env.REST_RESPONSE_SIZE_LIMIT, 10);
+        }
+        // Server configuration overrides
+        if (env.ENABLE_HTTP_SERVER !== undefined) {
+            yaml.server.enable_http_server = env.ENABLE_HTTP_SERVER === 'true';
+        }
+        if (env.HTTP_SERVER_PORT !== undefined) {
+            yaml.server.http_server_port = parseInt(env.HTTP_SERVER_PORT, 10);
+        }
+    }
+    parseToolConfiguration() {
+        const enabledTools = new Set();
+        const toolSubConfigs = new Map();
+        for (const [toolName, toolConfig] of Object.entries(this.config.yaml.tools)) {
+            if (toolConfig.enabled) {
+                enabledTools.add(toolName);
+                // Extract sub-configs (everything except standard fields)
+                const subConfigs = new Map();
+                for (const [key, value] of Object.entries(toolConfig)) {
+                    if (!['enabled', 'ack_token'].includes(key)) {
+                        subConfigs.set(key, value);
+                    }
+                }
+                if (subConfigs.size > 0) {
+                    toolSubConfigs.set(toolName, subConfigs);
+                }
+            }
+        }
+        return { enabledTools, toolSubConfigs };
+    }
+}
+// Export singleton instance
+export const config = ConfigManager.getInstance();
+export default config;

package/build/main.js

@@ -1,29 +1,44 @@
 #!/usr/bin/env node
-// Load environment variables from .env file
+/**
+ * Simplified main entry point
+ * Demonstrates the refactored architecture
+ */
+// Load environment variables
 import 'dotenv/config';
 import { GrocyMcpServer } from './server/mcp-server.js';
-import config from './config/environment.js';
+import { config } from './config/index.js';
 import { VERSION, PACKAGE_NAME as SERVER_NAME } from './version.js';
-// Debug output to help identify version and naming issues
-console.error(`Starting ${SERVER_NAME} server version ${VERSION}`);
+import { logger } from './utils/logger.js';
+import { ErrorHandler } from './utils/errors.js';
+// Startup banner
+logger.info(`Starting ${SERVER_NAME} v${VERSION}`, 'SERVER');
 async function main() {
-    try {
-        // Validate configuration early
-        const envConfig = config.get();
-        // Ensure required environment variables
-        if (!config.hasApiKeyAuth()) {
-            console.error('[WARNING] No GROCY_APIKEY_VALUE configured. Some API calls may fail.');
+    return ErrorHandler.handleAsync(async () => {
+        // Check API key
+        if (!config.grocy.api_key) {
+            logger.warn('No API key configured. Some operations may fail.', 'CONFIG');
         }
-        // Create and start the server
-        const server = new GrocyMcpServer();
+        // Log configuration summary
+        logger.config(`Grocy URL: ${config.grocy.base_url}`);
+        logger.config(`SSL Verify: ${config.grocy.enable_ssl_verify}`);
+        logger.config(`HTTP Server: ${config.server.enable_http_server}`);
+        // Create and start server
+        const server = await GrocyMcpServer.create();
         await server.start();
-    }
-    catch (error) {
-        console.error('[ERROR] Failed to start server:', error);
-        process.exit(1);
-    }
+        logger.info('Server started successfully', 'SERVER');
+    }, 'server startup');
 }
+// Error handling
+process.on('uncaughtException', (error) => {
+    logger.error('Uncaught exception', 'PROCESS', { error });
+    process.exit(1);
+});
+process.on('unhandledRejection', (reason, promise) => {
+    logger.error('Unhandled rejection', 'PROCESS', { reason, promise });
+    process.exit(1);
+});
+// Start the application
 main().catch((error) => {
-    console.error('[FATAL] Unhandled error:', error);
+    logger.error('Failed to start server', 'SERVER', { error });
     process.exit(1);
 });

package/build/resources/README.md

@@ -63,7 +63,7 @@ Transform your LLM into an intelligent household management assistant with focus
    
    # Configure
    cp .env.example .env
-   # Edit .env with your GROCY_BASE_URL and GROCY_APIKEY_VALUE
+   # Edit .env with your GROCY_BASE_URL and GROCY_API_KEY
    
    # Run
    docker compose up -d
@@ -74,7 +74,7 @@ Test with mock data (no real Grocy instance needed):
 ```bash
 # In .env file, any values work for mock mode
 GROCY_BASE_URL=http://mock
-GROCY_APIKEY_VALUE=mock
+GROCY_API_KEY=mock
 
 npm install && npm run dev
 ```
@@ -93,7 +93,7 @@ npm run build
 ### Docker
 
 ```bash
-docker run -e GROCY_APIKEY_VALUE=your_api_key -e GROCY_BASE_URL=http://your-grocy-instance ghcr.io/miguelangel-nubla/mcp-grocy:latest
+docker run -e GROCY_API_KEY=your_api_key -e GROCY_BASE_URL=http://your-grocy-instance ghcr.io/miguelangel-nubla/mcp-grocy:latest
 ```
 
 ### Docker Compose (Recommended)
@@ -126,20 +126,20 @@ docker compose up -d
 2. **Configure the server:**
    ```bash
    cp .env.example .env
-   # Edit .env with your GROCY_BASE_URL and GROCY_APIKEY_VALUE
+   # Edit .env with your GROCY_BASE_URL and GROCY_API_KEY
    ```
 
 3. **Essential variables:**
    - `GROCY_BASE_URL` - Your Grocy instance URL
-   - `GROCY_APIKEY_VALUE` - Your Grocy API key
+   - `GROCY_API_KEY` - Your Grocy API key
 
 ### Configuration Options
 
 | Method | Use Case | Command |
 |--------|----------|---------|
 | **`.env` file** | Recommended for most users | `cp .env.example .env` |
-| **Environment variables** | CI/CD, containers | `GROCY_BASE_URL=... GROCY_APIKEY_VALUE=... mcp-grocy` |
-| **Tool toggles** | Customize functionality | Edit `TOOL__*` variables in `.env` |
+| **Environment variables** | CI/CD, containers | `GROCY_BASE_URL=... GROCY_API_KEY=... mcp-grocy` |
+| **Tool configuration** | Customize functionality | Edit `tools` section in `mcp-grocy.yaml` |
 
 📖 **For complete configuration reference:** See [Configuration Guide](src/resources/config.md)
 
@@ -172,7 +172,7 @@ npm start
 |----------|---------|-------------|
 | [📖 API Reference](src/resources/api-reference.md) | Complete tool documentation | Tool usage and examples |
 | [⚙️ Configuration Guide](src/resources/config.md) | Advanced configuration reference | Detailed setup, presets, troubleshooting |
-| [📋 .env.example](.env.example) | Configuration template with ALL tools | Copy and customize for your setup |
+| [📋 .env.example](.env.example) | Environment configuration template | Copy and customize for your setup |
 | [🧪 MCP Inspector](https://github.com/modelcontextprotocol/inspector) | Protocol debugging | Debug MCP interactions |
 
 ### 🆘 Troubleshooting
@@ -185,17 +185,17 @@ npm start
 - For HTTPS URLs, ensure SSL certificate is valid or disable verification with `GROCY_ENABLE_SSL_VERIFY=false`
 
 **"Invalid API key" or "Authentication failed"**
-- Verify your `GROCY_APIKEY_VALUE` is correct
+- Verify your `GROCY_API_KEY` is correct
 - Check that the API key exists in your Grocy instance (User Settings → API Keys)
 - Ensure the API key has proper permissions
 
 **"Tool not found" errors**
-- Check if the tool is enabled in your `.env` file (tool toggles)
+- Check if the tool is enabled in your `mcp-grocy.yaml` file
 - Verify you're using the correct tool names from the API reference
 
 **Large response errors**
 - Increase `REST_RESPONSE_SIZE_LIMIT` if you have many products/stock entries
-- Consider using tool toggles to disable unused functionality
+- Consider disabling unused tools in `mcp-grocy.yaml`
 
 #### Debug Mode