n8n-mcp 2.7.14 → 2.7.17

package/dist/mcp/tool-docs/special/code-node-guide.d.ts

@@ -0,0 +1,3 @@
+import { ToolDocumentation } from '../types';
+export declare const codeNodeGuideDoc: ToolDocumentation;
+//# sourceMappingURL=code-node-guide.d.ts.map

package/dist/mcp/tool-docs/special/code-node-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-node-guide.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/special/code-node-guide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,gBAAgB,EAAE,iBAwD9B,CAAC"}

package/dist/mcp/tool-docs/special/code-node-guide.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.codeNodeGuideDoc = void 0;
+exports.codeNodeGuideDoc = {
+    name: 'code_node_guide',
+    category: 'special',
+    essentials: {
+        description: 'Get comprehensive guide for using Code nodes in n8n - JavaScript/Python execution, data access patterns, and common pitfalls',
+        keyParameters: [],
+        example: 'code_node_guide()',
+        performance: 'Instant (<10ms) - returns static guide',
+        tips: [
+            'Use $input.all() to access all items from previous nodes, not items[0]',
+            'Return data in [{json: {...}}] format, not just plain objects',
+            'External libraries (requests, pandas) not available - use built-in functions or JavaScript $helpers'
+        ]
+    },
+    full: {
+        description: `Provides a comprehensive guide for using Code nodes in n8n workflows. This special tool returns detailed documentation about:
+
+- JavaScript and Python code execution in n8n
+- Correct data access patterns ($input, $json, $node syntax)
+- Available helper functions ($helpers.httpRequest, $jmespath, etc.)
+- Common mistakes and how to avoid them
+- Working with webhook data (critical: data is under .body property)
+- Returning data in the correct format
+- Limitations and security restrictions
+
+This guide is essential for AI agents configuring Code nodes, as it covers the most common issues and correct patterns.`,
+        parameters: {},
+        returns: 'String containing a comprehensive Code node usage guide with examples and best practices',
+        examples: [
+            'code_node_guide() - Get the complete Code node guide',
+            '// Use this before configuring any Code node to understand correct patterns'
+        ],
+        useCases: [
+            'Learning how to access data from previous nodes correctly',
+            'Understanding webhook data structure (body property nesting)',
+            'Configuring JavaScript vs Python Code nodes',
+            'Troubleshooting common Code node errors',
+            'Understanding available helper functions and limitations'
+        ],
+        performance: 'Returns instantly - guide is pre-generated and cached',
+        bestPractices: [
+            'Always read this guide before configuring Code nodes',
+            'Pay special attention to data access patterns - most errors come from incorrect syntax',
+            'Remember webhook data is nested under .body, not at the root level',
+            'Use JavaScript for HTTP requests ($helpers.httpRequest) as Python lacks external libraries',
+            'Test with sample data to ensure correct output format'
+        ],
+        pitfalls: [
+            'Accessing webhook data incorrectly (forgetting .body nesting)',
+            'Using items[0] instead of $input.all() for data access',
+            'Returning plain objects instead of [{json: {...}}] format',
+            'Trying to use external Python libraries (requests, pandas)',
+            'Using expression syntax {{...}} inside Code nodes'
+        ],
+        relatedTools: ['get_node_essentials', 'validate_node_operation', 'get_node_for_task']
+    }
+};
+//# sourceMappingURL=code-node-guide.js.map

package/dist/mcp/tool-docs/special/code-node-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-node-guide.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/special/code-node-guide.ts"],"names":[],"mappings":";;;AAEa,QAAA,gBAAgB,GAAsB;IACjD,IAAI,EAAE,iBAAiB;IACvB,QAAQ,EAAE,SAAS;IACnB,UAAU,EAAE;QACV,WAAW,EAAE,8HAA8H;QAC3I,aAAa,EAAE,EAAE;QACjB,OAAO,EAAE,mBAAmB;QAC5B,WAAW,EAAE,wCAAwC;QACrD,IAAI,EAAE;YACJ,wEAAwE;YACxE,+DAA+D;YAC/D,qGAAqG;SACtG;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE;;;;;;;;;;wHAUuG;QACpH,UAAU,EAAE,EAAE;QACd,OAAO,EAAE,0FAA0F;QACnG,QAAQ,EAAE;YACR,sDAAsD;YACtD,6EAA6E;SAC9E;QACD,QAAQ,EAAE;YACR,2DAA2D;YAC3D,8DAA8D;YAC9D,6CAA6C;YAC7C,yCAAyC;YACzC,0DAA0D;SAC3D;QACD,WAAW,EAAE,uDAAuD;QACpE,aAAa,EAAE;YACb,sDAAsD;YACtD,wFAAwF;YACxF,oEAAoE;YACpE,4FAA4F;YAC5F,uDAAuD;SACxD;QACD,QAAQ,EAAE;YACR,+DAA+D;YAC/D,wDAAwD;YACxD,2DAA2D;YAC3D,4DAA4D;YAC5D,mDAAmD;SACpD;QACD,YAAY,EAAE,CAAC,qBAAqB,EAAE,yBAAyB,EAAE,mBAAmB,CAAC;KACtF;CACF,CAAC"}

package/dist/mcp/tool-docs/special/index.d.ts

@@ -0,0 +1,2 @@
+export { codeNodeGuideDoc } from './code-node-guide';
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/tool-docs/special/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/special/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/mcp/tool-docs/special/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.codeNodeGuideDoc = void 0;
+var code_node_guide_1 = require("./code-node-guide");
+Object.defineProperty(exports, "codeNodeGuideDoc", { enumerable: true, get: function () { return code_node_guide_1.codeNodeGuideDoc; } });
+//# sourceMappingURL=index.js.map

package/dist/mcp/tool-docs/special/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/special/index.ts"],"names":[],"mappings":";;;AAAA,qDAAqD;AAA5C,mHAAA,gBAAgB,OAAA"}

package/dist/mcp/tool-docs/system/index.d.ts

@@ -0,0 +1,5 @@
+export { toolsDocumentationDoc } from './tools-documentation';
+export { n8nDiagnosticDoc } from './n8n-diagnostic';
+export { n8nHealthCheckDoc } from './n8n-health-check';
+export { n8nListAvailableToolsDoc } from './n8n-list-available-tools';
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/tool-docs/system/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/system/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/mcp/tool-docs/system/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.n8nListAvailableToolsDoc = exports.n8nHealthCheckDoc = exports.n8nDiagnosticDoc = exports.toolsDocumentationDoc = void 0;
+var tools_documentation_1 = require("./tools-documentation");
+Object.defineProperty(exports, "toolsDocumentationDoc", { enumerable: true, get: function () { return tools_documentation_1.toolsDocumentationDoc; } });
+var n8n_diagnostic_1 = require("./n8n-diagnostic");
+Object.defineProperty(exports, "n8nDiagnosticDoc", { enumerable: true, get: function () { return n8n_diagnostic_1.n8nDiagnosticDoc; } });
+var n8n_health_check_1 = require("./n8n-health-check");
+Object.defineProperty(exports, "n8nHealthCheckDoc", { enumerable: true, get: function () { return n8n_health_check_1.n8nHealthCheckDoc; } });
+var n8n_list_available_tools_1 = require("./n8n-list-available-tools");
+Object.defineProperty(exports, "n8nListAvailableToolsDoc", { enumerable: true, get: function () { return n8n_list_available_tools_1.n8nListAvailableToolsDoc; } });
+//# sourceMappingURL=index.js.map

package/dist/mcp/tool-docs/system/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/system/index.ts"],"names":[],"mappings":";;;AAAA,6DAA8D;AAArD,4HAAA,qBAAqB,OAAA;AAC9B,mDAAoD;AAA3C,kHAAA,gBAAgB,OAAA;AACzB,uDAAuD;AAA9C,qHAAA,iBAAiB,OAAA;AAC1B,uEAAsE;AAA7D,oIAAA,wBAAwB,OAAA"}

package/dist/mcp/tool-docs/system/n8n-diagnostic.d.ts

@@ -0,0 +1,3 @@
+import { ToolDocumentation } from '../types';
+export declare const n8nDiagnosticDoc: ToolDocumentation;
+//# sourceMappingURL=n8n-diagnostic.d.ts.map

package/dist/mcp/tool-docs/system/n8n-diagnostic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-diagnostic.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/system/n8n-diagnostic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,gBAAgB,EAAE,iBA4E9B,CAAC"}

package/dist/mcp/tool-docs/system/n8n-diagnostic.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.n8nDiagnosticDoc = void 0;
+exports.n8nDiagnosticDoc = {
+    name: 'n8n_diagnostic',
+    category: 'system',
+    essentials: {
+        description: 'Diagnose n8n API configuration and troubleshoot why n8n management tools might not be working',
+        keyParameters: ['verbose'],
+        example: 'n8n_diagnostic({verbose: true})',
+        performance: 'Instant - checks environment and configuration only',
+        tips: [
+            'Run first when n8n tools are missing or failing - shows exact configuration issues',
+            'Use verbose=true for detailed debugging info including environment variables',
+            'If tools are missing, check that N8N_API_URL and N8N_API_KEY are configured'
+        ]
+    },
+    full: {
+        description: `Comprehensive diagnostic tool for troubleshooting n8n API configuration and management tool availability.
+
+This tool performs a detailed check of:
+- Environment variable configuration (N8N_API_URL, N8N_API_KEY)
+- API connectivity and authentication
+- Tool availability status
+- Common configuration issues
+
+The diagnostic is essential when:
+- n8n management tools aren't showing up in the available tools list
+- API calls are failing with authentication or connection errors
+- You need to verify your n8n instance configuration`,
+        parameters: {
+            verbose: {
+                type: 'boolean',
+                description: 'Include detailed debug information including full environment variables and API response details',
+                required: false,
+                default: false
+            }
+        },
+        returns: `Diagnostic report object containing:
+- status: Overall health status ('ok', 'error', 'not_configured')
+- apiUrl: Detected API URL (or null if not configured)
+- apiKeyStatus: Status of API key ('configured', 'missing', 'invalid')
+- toolsAvailable: Number of n8n management tools available
+- connectivity: API connectivity test results
+- errors: Array of specific error messages
+- suggestions: Array of actionable fix suggestions
+- verbose: Additional debug information (if verbose=true)`,
+        examples: [
+            'n8n_diagnostic({}) - Quick diagnostic check',
+            'n8n_diagnostic({verbose: true}) - Detailed diagnostic with environment info',
+            'n8n_diagnostic({verbose: false}) - Standard diagnostic without sensitive data'
+        ],
+        useCases: [
+            'Initial setup verification after configuring N8N_API_URL and N8N_API_KEY',
+            'Troubleshooting when n8n management tools are not available',
+            'Debugging API connection failures or authentication errors',
+            'Verifying n8n instance compatibility and feature availability',
+            'Pre-deployment checks before using workflow management tools'
+        ],
+        performance: `Instant response time:
+- No database queries
+- Only checks environment and makes one test API call
+- Verbose mode adds minimal overhead
+- Safe to run frequently for monitoring`,
+        bestPractices: [
+            'Always run diagnostic first when encountering n8n tool issues',
+            'Use verbose mode only in secure environments (may expose API URLs)',
+            'Check diagnostic before attempting workflow operations',
+            'Include diagnostic output when reporting issues',
+            'Run after any configuration changes to verify setup'
+        ],
+        pitfalls: [
+            'Verbose mode may expose sensitive configuration details - use carefully',
+            'Requires proper environment variables to detect n8n configuration',
+            'API connectivity test requires network access to n8n instance',
+            'Does not test specific workflow operations, only basic connectivity'
+        ],
+        relatedTools: ['n8n_health_check', 'n8n_list_available_tools', 'tools_documentation']
+    }
+};
+//# sourceMappingURL=n8n-diagnostic.js.map

package/dist/mcp/tool-docs/system/n8n-diagnostic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-diagnostic.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/system/n8n-diagnostic.ts"],"names":[],"mappings":";;;AAEa,QAAA,gBAAgB,GAAsB;IACjD,IAAI,EAAE,gBAAgB;IACtB,QAAQ,EAAE,QAAQ;IAClB,UAAU,EAAE;QACV,WAAW,EAAE,+FAA+F;QAC5G,aAAa,EAAE,CAAC,SAAS,CAAC;QAC1B,OAAO,EAAE,iCAAiC;QAC1C,WAAW,EAAE,qDAAqD;QAClE,IAAI,EAAE;YACJ,oFAAoF;YACpF,8EAA8E;YAC9E,6EAA6E;SAC9E;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE;;;;;;;;;;;qDAWoC;QACjD,UAAU,EAAE;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,kGAAkG;gBAC/G,QAAQ,EAAE,KAAK;gBACf,OAAO,EAAE,KAAK;aACf;SACF;QACD,OAAO,EAAE;;;;;;;;0DAQ6C;QACtD,QAAQ,EAAE;YACR,6CAA6C;YAC7C,6EAA6E;YAC7E,+EAA+E;SAChF;QACD,QAAQ,EAAE;YACR,0EAA0E;YAC1E,6DAA6D;YAC7D,4DAA4D;YAC5D,+DAA+D;YAC/D,8DAA8D;SAC/D;QACD,WAAW,EAAE;;;;wCAIuB;QACpC,aAAa,EAAE;YACb,+DAA+D;YAC/D,oEAAoE;YACpE,wDAAwD;YACxD,iDAAiD;YACjD,qDAAqD;SACtD;QACD,QAAQ,EAAE;YACR,yEAAyE;YACzE,mEAAmE;YACnE,+DAA+D;YAC/D,qEAAqE;SACtE;QACD,YAAY,EAAE,CAAC,kBAAkB,EAAE,0BAA0B,EAAE,qBAAqB,CAAC;KACtF;CACF,CAAC"}

package/dist/mcp/tool-docs/system/n8n-health-check.d.ts

@@ -0,0 +1,3 @@
+import { ToolDocumentation } from '../types';
+export declare const n8nHealthCheckDoc: ToolDocumentation;
+//# sourceMappingURL=n8n-health-check.d.ts.map

package/dist/mcp/tool-docs/system/n8n-health-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-health-check.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/system/n8n-health-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,iBAAiB,EAAE,iBAwE/B,CAAC"}

package/dist/mcp/tool-docs/system/n8n-health-check.js

@@ -0,0 +1,77 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.n8nHealthCheckDoc = void 0;
+exports.n8nHealthCheckDoc = {
+    name: 'n8n_health_check',
+    category: 'system',
+    essentials: {
+        description: 'Check n8n instance health, API connectivity, and available features',
+        keyParameters: [],
+        example: 'n8n_health_check({})',
+        performance: 'Fast - single API call to health endpoint',
+        tips: [
+            'Use before starting workflow operations to ensure n8n is responsive',
+            'Check regularly in production environments for monitoring',
+            'Returns version info and feature availability for compatibility checks'
+        ]
+    },
+    full: {
+        description: `Performs a comprehensive health check of the configured n8n instance through its API.
+
+This tool verifies:
+- API endpoint accessibility and response time
+- n8n instance version and build information
+- Authentication status and permissions
+- Available features and enterprise capabilities
+- Database connectivity (as reported by n8n)
+- Queue system status (if configured)
+
+Health checks are crucial for:
+- Monitoring n8n instance availability
+- Detecting performance degradation
+- Verifying API compatibility before operations
+- Ensuring authentication is working correctly`,
+        parameters: {},
+        returns: `Health status object containing:
+- status: Overall health status ('healthy', 'degraded', 'error')
+- version: n8n instance version information
+- instanceId: Unique identifier for the n8n instance
+- features: Object listing available features and their status
+- apiVersion: API version for compatibility checking
+- responseTime: API response time in milliseconds
+- timestamp: Check timestamp
+- details: Additional health metrics from n8n`,
+        examples: [
+            'n8n_health_check({}) - Standard health check',
+            '// Use in monitoring scripts\nconst health = await n8n_health_check({});\nif (health.status !== "healthy") alert("n8n is down!");',
+            '// Check before critical operations\nconst health = await n8n_health_check({});\nif (health.responseTime > 1000) console.warn("n8n is slow");'
+        ],
+        useCases: [
+            'Pre-flight checks before workflow deployments',
+            'Continuous monitoring of n8n instance health',
+            'Troubleshooting connectivity or performance issues',
+            'Verifying n8n version compatibility with workflows',
+            'Detecting feature availability (enterprise features, queue mode, etc.)'
+        ],
+        performance: `Fast response expected:
+- Single HTTP request to /health endpoint
+- Typically responds in <100ms for healthy instances
+- Timeout after 10 seconds indicates severe issues
+- Minimal server load - safe for frequent polling`,
+        bestPractices: [
+            'Run health checks before batch operations or deployments',
+            'Set up automated monitoring with regular health checks',
+            'Log response times to detect performance trends',
+            'Check version compatibility when deploying workflows',
+            'Use health status to implement circuit breaker patterns'
+        ],
+        pitfalls: [
+            'Requires N8N_API_URL and N8N_API_KEY to be configured',
+            'Network issues may cause false negatives',
+            'Does not check individual workflow health',
+            'Health endpoint might be cached - not real-time for all metrics'
+        ],
+        relatedTools: ['n8n_diagnostic', 'n8n_list_available_tools', 'n8n_list_workflows']
+    }
+};
+//# sourceMappingURL=n8n-health-check.js.map

package/dist/mcp/tool-docs/system/n8n-health-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-health-check.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/system/n8n-health-check.ts"],"names":[],"mappings":";;;AAEa,QAAA,iBAAiB,GAAsB;IAClD,IAAI,EAAE,kBAAkB;IACxB,QAAQ,EAAE,QAAQ;IAClB,UAAU,EAAE;QACV,WAAW,EAAE,qEAAqE;QAClF,aAAa,EAAE,EAAE;QACjB,OAAO,EAAE,sBAAsB;QAC/B,WAAW,EAAE,2CAA2C;QACxD,IAAI,EAAE;YACJ,qEAAqE;YACrE,2DAA2D;YAC3D,wEAAwE;SACzE;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE;;;;;;;;;;;;;;+CAc8B;QAC3C,UAAU,EAAE,EAAE;QACd,OAAO,EAAE;;;;;;;;8CAQiC;QAC1C,QAAQ,EAAE;YACR,8CAA8C;YAC9C,mIAAmI;YACnI,+IAA+I;SAChJ;QACD,QAAQ,EAAE;YACR,+CAA+C;YAC/C,8CAA8C;YAC9C,oDAAoD;YACpD,oDAAoD;YACpD,wEAAwE;SACzE;QACD,WAAW,EAAE;;;;kDAIiC;QAC9C,aAAa,EAAE;YACb,0DAA0D;YAC1D,wDAAwD;YACxD,iDAAiD;YACjD,sDAAsD;YACtD,yDAAyD;SAC1D;QACD,QAAQ,EAAE;YACR,uDAAuD;YACvD,0CAA0C;YAC1C,2CAA2C;YAC3C,iEAAiE;SAClE;QACD,YAAY,EAAE,CAAC,gBAAgB,EAAE,0BAA0B,EAAE,oBAAoB,CAAC;KACnF;CACF,CAAC"}

package/dist/mcp/tool-docs/system/n8n-list-available-tools.d.ts

@@ -0,0 +1,3 @@
+import { ToolDocumentation } from '../types';
+export declare const n8nListAvailableToolsDoc: ToolDocumentation;
+//# sourceMappingURL=n8n-list-available-tools.d.ts.map

package/dist/mcp/tool-docs/system/n8n-list-available-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-list-available-tools.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/system/n8n-list-available-tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,wBAAwB,EAAE,iBAsEtC,CAAC"}

package/dist/mcp/tool-docs/system/n8n-list-available-tools.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.n8nListAvailableToolsDoc = void 0;
+exports.n8nListAvailableToolsDoc = {
+    name: 'n8n_list_available_tools',
+    category: 'system',
+    essentials: {
+        description: 'List all available n8n management tools and their capabilities',
+        keyParameters: [],
+        example: 'n8n_list_available_tools({})',
+        performance: 'Instant - returns static tool list',
+        tips: [
+            'Shows only tools available with current API configuration',
+            'If no n8n tools appear, run n8n_diagnostic to troubleshoot',
+            'Tool availability depends on N8N_API_URL and N8N_API_KEY being set'
+        ]
+    },
+    full: {
+        description: `Lists all available n8n management tools based on current configuration.
+
+This tool provides:
+- Complete list of n8n management tools (when API is configured)
+- Tool descriptions and capabilities
+- Categorized tool listing (workflow, execution, system)
+- Dynamic availability based on API configuration
+
+The tool list is dynamic:
+- Shows 14+ management tools when N8N_API_URL and N8N_API_KEY are configured
+- Shows only documentation tools when API is not configured
+- Helps discover available functionality
+- Provides quick reference for tool names and purposes`,
+        parameters: {},
+        returns: `Object containing:
+- tools: Array of available tool objects, each with:
+  - name: Tool identifier (e.g., 'n8n_create_workflow')
+  - description: Brief description of tool functionality
+  - category: Tool category ('workflow', 'execution', 'system')
+  - requiresApi: Whether tool needs API configuration
+- categories: Summary count by category
+- totalTools: Total number of available tools
+- apiConfigured: Whether n8n API is configured`,
+        examples: [
+            'n8n_list_available_tools({}) - List all available tools',
+            '// Check for specific tool availability\nconst tools = await n8n_list_available_tools({});\nconst hasWorkflowTools = tools.tools.some(t => t.category === "workflow");',
+            '// Discover management capabilities\nconst result = await n8n_list_available_tools({});\nconsole.log(`${result.totalTools} tools available`);'
+        ],
+        useCases: [
+            'Discovering available n8n management capabilities',
+            'Checking if API configuration is working correctly',
+            'Finding the right tool for a specific task',
+            'Generating help documentation or command lists',
+            'Verifying tool availability before automation scripts'
+        ],
+        performance: `Instant response:
+- No API calls required
+- Returns pre-defined tool list
+- Filtered based on configuration
+- Zero network overhead`,
+        bestPractices: [
+            'Check tool availability before building automation workflows',
+            'Use with n8n_diagnostic if expected tools are missing',
+            'Reference tool names exactly as returned by this tool',
+            'Group operations by category for better organization',
+            'Cache results as tool list only changes with configuration'
+        ],
+        pitfalls: [
+            'Tool list is empty if N8N_API_URL and N8N_API_KEY are not set',
+            'Does not validate if tools will actually work - just shows availability',
+            'Tool names must be used exactly as returned',
+            'Does not show tool parameters - use tools_documentation for details'
+        ],
+        relatedTools: ['n8n_diagnostic', 'n8n_health_check', 'tools_documentation']
+    }
+};
+//# sourceMappingURL=n8n-list-available-tools.js.map

package/dist/mcp/tool-docs/system/n8n-list-available-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-list-available-tools.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/system/n8n-list-available-tools.ts"],"names":[],"mappings":";;;AAEa,QAAA,wBAAwB,GAAsB;IACzD,IAAI,EAAE,0BAA0B;IAChC,QAAQ,EAAE,QAAQ;IAClB,UAAU,EAAE;QACV,WAAW,EAAE,gEAAgE;QAC7E,aAAa,EAAE,EAAE;QACjB,OAAO,EAAE,8BAA8B;QACvC,WAAW,EAAE,oCAAoC;QACjD,IAAI,EAAE;YACJ,2DAA2D;YAC3D,4DAA4D;YAC5D,oEAAoE;SACrE;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE;;;;;;;;;;;;uDAYsC;QACnD,UAAU,EAAE,EAAE;QACd,OAAO,EAAE;;;;;;;;+CAQkC;QAC3C,QAAQ,EAAE;YACR,yDAAyD;YACzD,wKAAwK;YACxK,+IAA+I;SAChJ;QACD,QAAQ,EAAE;YACR,mDAAmD;YACnD,oDAAoD;YACpD,4CAA4C;YAC5C,gDAAgD;YAChD,uDAAuD;SACxD;QACD,WAAW,EAAE;;;;wBAIO;QACpB,aAAa,EAAE;YACb,8DAA8D;YAC9D,uDAAuD;YACvD,uDAAuD;YACvD,sDAAsD;YACtD,4DAA4D;SAC7D;QACD,QAAQ,EAAE;YACR,+DAA+D;YAC/D,yEAAyE;YACzE,6CAA6C;YAC7C,qEAAqE;SACtE;QACD,YAAY,EAAE,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,qBAAqB,CAAC;KAC5E;CACF,CAAC"}

package/dist/mcp/tool-docs/system/tools-documentation.d.ts

@@ -0,0 +1,3 @@
+import { ToolDocumentation } from '../types';
+export declare const toolsDocumentationDoc: ToolDocumentation;
+//# sourceMappingURL=tools-documentation.d.ts.map

package/dist/mcp/tool-docs/system/tools-documentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-documentation.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/system/tools-documentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,qBAAqB,EAAE,iBA4DnC,CAAC"}

package/dist/mcp/tool-docs/system/tools-documentation.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toolsDocumentationDoc = void 0;
+exports.toolsDocumentationDoc = {
+    name: 'tools_documentation',
+    category: 'system',
+    essentials: {
+        description: 'The meta-documentation tool. Returns documentation for any MCP tool, including itself. Call without parameters for a comprehensive overview of all available tools. This is your starting point for discovering n8n MCP capabilities.',
+        keyParameters: ['topic', 'depth'],
+        example: 'tools_documentation({topic: "search_nodes"})',
+        performance: 'Instant (static content)',
+        tips: [
+            'Call without parameters first to see all tools',
+            'Can document itself: tools_documentation({topic: "tools_documentation"})',
+            'Use depth:"full" for comprehensive details'
+        ]
+    },
+    full: {
+        description: 'The self-referential documentation system for all MCP tools. This tool can document any other tool, including itself. It\'s the primary discovery mechanism for understanding what tools are available and how to use them. Returns utilitarian documentation optimized for AI agent consumption.',
+        parameters: {
+            topic: { type: 'string', description: 'Tool name (e.g., "search_nodes"), special topic ("javascript_code_node_guide", "python_code_node_guide"), or "overview". Leave empty for quick reference.', required: false },
+            depth: { type: 'string', description: 'Level of detail: "essentials" (default, concise) or "full" (comprehensive with examples)', required: false }
+        },
+        returns: 'Markdown-formatted documentation tailored for the requested tool and depth. For essentials: key info, parameters, example, tips. For full: complete details, all examples, use cases, best practices.',
+        examples: [
+            '// Get started - see all available tools',
+            'tools_documentation()',
+            '',
+            '// Learn about a specific tool',
+            'tools_documentation({topic: "search_nodes"})',
+            '',
+            '// Get comprehensive details',
+            'tools_documentation({topic: "validate_workflow", depth: "full"})',
+            '',
+            '// Self-referential example - document this tool',
+            'tools_documentation({topic: "tools_documentation", depth: "full"})',
+            '',
+            '// Code node guides',
+            'tools_documentation({topic: "javascript_code_node_guide"})',
+            'tools_documentation({topic: "python_code_node_guide"})'
+        ],
+        useCases: [
+            'Initial discovery of available MCP tools',
+            'Learning how to use specific tools',
+            'Finding required and optional parameters',
+            'Getting working examples to copy',
+            'Understanding tool performance characteristics',
+            'Discovering related tools for workflows'
+        ],
+        performance: 'Instant - all documentation is pre-loaded in memory',
+        bestPractices: [
+            'Always start with tools_documentation() to see available tools',
+            'Use essentials for quick parameter reference during coding',
+            'Switch to full depth when debugging or learning new tools',
+            'Check Code node guides when working with Code nodes'
+        ],
+        pitfalls: [
+            'Tool names must match exactly - use the overview to find correct names',
+            'Not all internal functions are documented',
+            'Special topics (code guides) require exact names'
+        ],
+        relatedTools: ['n8n_list_available_tools for dynamic tool discovery', 'list_tasks for common configurations', 'get_database_statistics to verify MCP connection']
+    }
+};
+//# sourceMappingURL=tools-documentation.js.map

package/dist/mcp/tool-docs/system/tools-documentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-documentation.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/system/tools-documentation.ts"],"names":[],"mappings":";;;AAEa,QAAA,qBAAqB,GAAsB;IACtD,IAAI,EAAE,qBAAqB;IAC3B,QAAQ,EAAE,QAAQ;IAClB,UAAU,EAAE;QACV,WAAW,EAAE,uOAAuO;QACpP,aAAa,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;QACjC,OAAO,EAAE,8CAA8C;QACvD,WAAW,EAAE,0BAA0B;QACvC,IAAI,EAAE;YACJ,gDAAgD;YAChD,0EAA0E;YAC1E,4CAA4C;SAC7C;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,mSAAmS;QAChT,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2JAA2J,EAAE,QAAQ,EAAE,KAAK,EAAE;YACpN,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,0FAA0F,EAAE,QAAQ,EAAE,KAAK,EAAE;SACpJ;QACD,OAAO,EAAE,uMAAuM;QAChN,QAAQ,EAAE;YACR,0CAA0C;YAC1C,uBAAuB;YACvB,EAAE;YACF,gCAAgC;YAChC,8CAA8C;YAC9C,EAAE;YACF,8BAA8B;YAC9B,kEAAkE;YAClE,EAAE;YACF,kDAAkD;YAClD,oEAAoE;YACpE,EAAE;YACF,qBAAqB;YACrB,4DAA4D;YAC5D,wDAAwD;SACzD;QACD,QAAQ,EAAE;YACR,0CAA0C;YAC1C,oCAAoC;YACpC,0CAA0C;YAC1C,kCAAkC;YAClC,gDAAgD;YAChD,yCAAyC;SAC1C;QACD,WAAW,EAAE,qDAAqD;QAClE,aAAa,EAAE;YACb,gEAAgE;YAChE,4DAA4D;YAC5D,2DAA2D;YAC3D,qDAAqD;SACtD;QACD,QAAQ,EAAE;YACR,wEAAwE;YACxE,2CAA2C;YAC3C,kDAAkD;SACnD;QACD,YAAY,EAAE,CAAC,qDAAqD,EAAE,sCAAsC,EAAE,kDAAkD,CAAC;KAClK;CACF,CAAC"}

package/dist/mcp/tool-docs/templates/get-node-for-task.d.ts

@@ -0,0 +1,3 @@
+import { ToolDocumentation } from '../types';
+export declare const getNodeForTaskDoc: ToolDocumentation;
+//# sourceMappingURL=get-node-for-task.d.ts.map

package/dist/mcp/tool-docs/templates/get-node-for-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-node-for-task.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/templates/get-node-for-task.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,iBAAiB,EAAE,iBA6C/B,CAAC"}

package/dist/mcp/tool-docs/templates/get-node-for-task.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNodeForTaskDoc = void 0;
+exports.getNodeForTaskDoc = {
+    name: 'get_node_for_task',
+    category: 'templates',
+    essentials: {
+        description: 'Get pre-configured node for tasks: post_json_request, receive_webhook, query_database, send_slack_message, etc. Use list_tasks for all.',
+        keyParameters: ['task'],
+        example: 'get_node_for_task({task: "post_json_request"})',
+        performance: 'Instant',
+        tips: [
+            'Returns ready-to-use configuration',
+            'See list_tasks for available tasks',
+            'Includes credentials structure'
+        ]
+    },
+    full: {
+        description: 'Returns pre-configured node settings for common automation tasks. Each configuration includes the correct node type, essential parameters, and credential requirements. Perfect for quickly setting up standard automations.',
+        parameters: {
+            task: { type: 'string', required: true, description: 'Task name from list_tasks (e.g., "post_json_request", "send_email")' }
+        },
+        returns: 'Complete node configuration with type, displayName, parameters, credentials structure',
+        examples: [
+            'get_node_for_task({task: "post_json_request"}) - HTTP POST setup',
+            'get_node_for_task({task: "receive_webhook"}) - Webhook receiver',
+            'get_node_for_task({task: "send_slack_message"}) - Slack config'
+        ],
+        useCases: [
+            'Quick node configuration',
+            'Learning proper node setup',
+            'Standard automation patterns',
+            'Credential structure reference'
+        ],
+        performance: 'Instant - Pre-configured templates',
+        bestPractices: [
+            'Use list_tasks to discover options',
+            'Customize returned config as needed',
+            'Check credential requirements',
+            'Validate with validate_node_operation'
+        ],
+        pitfalls: [
+            'Templates may need customization',
+            'Credentials must be configured separately',
+            'Not all tasks available for all nodes'
+        ],
+        relatedTools: ['list_tasks', 'validate_node_operation', 'get_node_essentials']
+    }
+};
+//# sourceMappingURL=get-node-for-task.js.map

package/dist/mcp/tool-docs/templates/get-node-for-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-node-for-task.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/templates/get-node-for-task.ts"],"names":[],"mappings":";;;AAEa,QAAA,iBAAiB,GAAsB;IAClD,IAAI,EAAE,mBAAmB;IACzB,QAAQ,EAAE,WAAW;IACrB,UAAU,EAAE;QACV,WAAW,EAAE,yIAAyI;QACtJ,aAAa,EAAE,CAAC,MAAM,CAAC;QACvB,OAAO,EAAE,gDAAgD;QACzD,WAAW,EAAE,SAAS;QACtB,IAAI,EAAE;YACJ,oCAAoC;YACpC,oCAAoC;YACpC,gCAAgC;SACjC;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,8NAA8N;QAC3O,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,qEAAqE,EAAE;SAC7H;QACD,OAAO,EAAE,uFAAuF;QAChG,QAAQ,EAAE;YACR,kEAAkE;YAClE,iEAAiE;YACjE,gEAAgE;SACjE;QACD,QAAQ,EAAE;YACR,0BAA0B;YAC1B,4BAA4B;YAC5B,8BAA8B;YAC9B,gCAAgC;SACjC;QACD,WAAW,EAAE,oCAAoC;QACjD,aAAa,EAAE;YACb,oCAAoC;YACpC,qCAAqC;YACrC,+BAA+B;YAC/B,uCAAuC;SACxC;QACD,QAAQ,EAAE;YACR,kCAAkC;YAClC,2CAA2C;YAC3C,uCAAuC;SACxC;QACD,YAAY,EAAE,CAAC,YAAY,EAAE,yBAAyB,EAAE,qBAAqB,CAAC;KAC/E;CACF,CAAC"}

package/dist/mcp/tool-docs/templates/get-template.d.ts

@@ -0,0 +1,3 @@
+import { ToolDocumentation } from '../types';
+export declare const getTemplateDoc: ToolDocumentation;
+//# sourceMappingURL=get-template.d.ts.map

package/dist/mcp/tool-docs/templates/get-template.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-template.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/templates/get-template.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,cAAc,EAAE,iBAuE5B,CAAC"}

package/dist/mcp/tool-docs/templates/get-template.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTemplateDoc = void 0;
+exports.getTemplateDoc = {
+    name: 'get_template',
+    category: 'templates',
+    essentials: {
+        description: 'Get complete workflow JSON by ID. Ready to import. IDs from list_node_templates or search_templates.',
+        keyParameters: ['templateId'],
+        example: 'get_template({templateId: 1234})',
+        performance: 'Fast (<100ms) - single database lookup',
+        tips: [
+            'Get template IDs from list_node_templates or search_templates first',
+            'Returns complete workflow JSON ready for import into n8n',
+            'Includes all nodes, connections, and settings'
+        ]
+    },
+    full: {
+        description: `Retrieves the complete workflow JSON for a specific template by its ID. The returned workflow can be directly imported into n8n through the UI or API. This tool fetches pre-built workflows from the community template library containing 399+ curated workflows.`,
+        parameters: {
+            templateId: {
+                type: 'number',
+                required: true,
+                description: 'The numeric ID of the template to retrieve. Get IDs from list_node_templates or search_templates'
+            }
+        },
+        returns: `Returns an object containing:
+- template: Complete template information including workflow JSON
+  - id: Template ID
+  - name: Template name
+  - description: What the workflow does
+  - author: Creator information (name, username, verified status)
+  - nodes: Array of node types used
+  - views: Number of times viewed
+  - created: Creation date
+  - url: Link to template on n8n.io
+  - workflow: Complete workflow JSON with structure:
+    - nodes: Array of node objects (id, name, type, typeVersion, position, parameters)
+    - connections: Object mapping source nodes to targets
+    - settings: Workflow configuration (timezone, error handling, etc.)
+- usage: Instructions for using the workflow`,
+        examples: [
+            'get_template({templateId: 1234}) - Get Slack notification workflow',
+            'get_template({templateId: 5678}) - Get data sync workflow',
+            'get_template({templateId: 9012}) - Get AI chatbot workflow'
+        ],
+        useCases: [
+            'Download workflows for direct import into n8n',
+            'Study workflow patterns and best practices',
+            'Get complete workflow JSON for customization',
+            'Clone popular workflows for your use case',
+            'Learn how complex automations are built'
+        ],
+        performance: `Fast performance with single database lookup:
+- Query time: <10ms for template retrieval
+- Workflow JSON parsing: <50ms
+- Total response time: <100ms
+- No network calls (uses local cache)`,
+        bestPractices: [
+            'Always check if template exists before attempting modifications',
+            'Review workflow nodes before importing to ensure compatibility',
+            'Save template JSON locally if planning multiple customizations',
+            'Check template creation date for most recent patterns',
+            'Verify all required credentials are configured before import'
+        ],
+        pitfalls: [
+            'Template IDs change when database is refreshed',
+            'Some templates may use deprecated node versions',
+            'Credentials in templates are placeholders - configure your own',
+            'Not all templates work with all n8n versions',
+            'Template may reference external services you don\'t have access to'
+        ],
+        relatedTools: ['list_node_templates', 'search_templates', 'get_templates_for_task', 'n8n_create_workflow']
+    }
+};
+//# sourceMappingURL=get-template.js.map