n8n-mcp 2.7.15 → 2.7.17

package/dist/mcp/tool-docs/configuration/get-node-as-tool-info.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNodeAsToolInfoDoc = void 0;
+exports.getNodeAsToolInfoDoc = {
+    name: 'get_node_as_tool_info',
+    category: 'configuration',
+    essentials: {
+        description: 'Explains how to use ANY node as an AI tool with requirements and examples.',
+        keyParameters: ['nodeType'],
+        example: 'get_node_as_tool_info({nodeType: "nodes-base.slack"})',
+        performance: 'Fast - returns guidance and examples',
+        tips: [
+            'ANY node can be used as AI tool, not just AI-marked ones',
+            'Community nodes need N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true',
+            'Provides specific use cases and connection requirements'
+        ]
+    },
+    full: {
+        description: `Shows how to use any n8n node as an AI tool in AI Agent workflows. In n8n, ANY node can be connected to an AI Agent's tool port, allowing the AI to use that node's functionality. This tool provides specific guidance, requirements, and examples for using a node as an AI tool.`,
+        parameters: {
+            nodeType: {
+                type: 'string',
+                required: true,
+                description: 'Full node type WITH prefix: "nodes-base.slack", "nodes-base.googleSheets", etc.',
+                examples: [
+                    'nodes-base.slack',
+                    'nodes-base.httpRequest',
+                    'nodes-base.googleSheets',
+                    'nodes-langchain.documentLoader'
+                ]
+            }
+        },
+        returns: `Object containing:
+- nodeType: The node's full type identifier
+- displayName: Human-readable name
+- isMarkedAsAITool: Whether node has usableAsTool property
+- aiToolCapabilities: Detailed AI tool usage information including:
+  - canBeUsedAsTool: Always true in n8n
+  - requiresEnvironmentVariable: For community nodes
+  - commonUseCases: Specific AI tool use cases
+  - requirements: Connection and environment setup
+  - examples: Code examples for common scenarios
+  - tips: Best practices for AI tool usage`,
+        examples: [
+            'get_node_as_tool_info({nodeType: "nodes-base.slack"}) - Get AI tool guidance for Slack',
+            'get_node_as_tool_info({nodeType: "nodes-base.httpRequest"}) - Learn to use HTTP Request as AI tool',
+            'get_node_as_tool_info({nodeType: "nodes-base.postgres"}) - Database queries as AI tools'
+        ],
+        useCases: [
+            'Understanding how to connect any node to AI Agent',
+            'Learning environment requirements for community nodes',
+            'Getting specific use case examples for AI tool usage',
+            'Checking if a node is optimized for AI usage',
+            'Understanding credential requirements for AI tools'
+        ],
+        performance: 'Very fast - returns pre-computed guidance and examples',
+        bestPractices: [
+            'Use this before configuring nodes as AI tools',
+            'Check environment requirements for community nodes',
+            'Review common use cases to understand best applications',
+            'Test nodes independently before connecting to AI Agent',
+            'Give tools descriptive names in AI Agent configuration'
+        ],
+        pitfalls: [
+            'Community nodes require environment variable to be used as tools',
+            'Not all nodes make sense as AI tools (e.g., triggers)',
+            'Some nodes require specific credentials configuration',
+            'Tool descriptions in AI Agent must be clear and detailed'
+        ],
+        relatedTools: ['list_ai_tools', 'get_node_essentials', 'validate_node_operation']
+    }
+};
+//# sourceMappingURL=get-node-as-tool-info.js.map

package/dist/mcp/tool-docs/configuration/get-node-as-tool-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-node-as-tool-info.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/configuration/get-node-as-tool-info.ts"],"names":[],"mappings":";;;AAEa,QAAA,oBAAoB,GAAsB;IACrD,IAAI,EAAE,uBAAuB;IAC7B,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE;QACV,WAAW,EAAE,4EAA4E;QACzF,aAAa,EAAE,CAAC,UAAU,CAAC;QAC3B,OAAO,EAAE,uDAAuD;QAChE,WAAW,EAAE,sCAAsC;QACnD,IAAI,EAAE;YACJ,0DAA0D;YAC1D,mEAAmE;YACnE,yDAAyD;SAC1D;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,qRAAqR;QAClS,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,iFAAiF;gBAC9F,QAAQ,EAAE;oBACR,kBAAkB;oBAClB,wBAAwB;oBACxB,yBAAyB;oBACzB,gCAAgC;iBACjC;aACF;SACF;QACD,OAAO,EAAE;;;;;;;;;;2CAU8B;QACvC,QAAQ,EAAE;YACR,wFAAwF;YACxF,oGAAoG;YACpG,yFAAyF;SAC1F;QACD,QAAQ,EAAE;YACR,mDAAmD;YACnD,uDAAuD;YACvD,sDAAsD;YACtD,8CAA8C;YAC9C,oDAAoD;SACrD;QACD,WAAW,EAAE,wDAAwD;QACrE,aAAa,EAAE;YACb,+CAA+C;YAC/C,oDAAoD;YACpD,yDAAyD;YACzD,wDAAwD;YACxD,wDAAwD;SACzD;QACD,QAAQ,EAAE;YACR,kEAAkE;YAClE,uDAAuD;YACvD,uDAAuD;YACvD,0DAA0D;SAC3D;QACD,YAAY,EAAE,CAAC,eAAe,EAAE,qBAAqB,EAAE,yBAAyB,CAAC;KAClF;CACF,CAAC"}

package/dist/mcp/tool-docs/configuration/get-node-documentation.d.ts

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

package/dist/mcp/tool-docs/configuration/get-node-documentation.d.ts.map

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

package/dist/mcp/tool-docs/configuration/get-node-documentation.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNodeDocumentationDoc = void 0;
+exports.getNodeDocumentationDoc = {
+    name: 'get_node_documentation',
+    category: 'configuration',
+    essentials: {
+        description: 'Get readable docs with examples/auth/patterns. Better than raw schema! 87% coverage. Format: "nodes-base.slack"',
+        keyParameters: ['nodeType'],
+        example: 'get_node_documentation({nodeType: "nodes-base.slack"})',
+        performance: 'Fast - pre-parsed',
+        tips: [
+            '87% coverage',
+            'Includes auth examples',
+            'Human-readable format'
+        ]
+    },
+    full: {
+        description: 'Returns human-readable documentation parsed from n8n-docs including examples, authentication setup, and common patterns. More useful than raw schema for understanding node usage.',
+        parameters: {
+            nodeType: { type: 'string', required: true, description: 'Full node type with prefix (e.g., "nodes-base.slack")' }
+        },
+        returns: 'Parsed markdown documentation with examples, authentication guides, common patterns',
+        examples: [
+            'get_node_documentation({nodeType: "nodes-base.slack"}) - Slack usage guide',
+            'get_node_documentation({nodeType: "nodes-base.googleSheets"}) - Sheets examples'
+        ],
+        useCases: [
+            'Understanding authentication setup',
+            'Finding usage examples',
+            'Learning common patterns'
+        ],
+        performance: 'Fast - Pre-parsed documentation stored in database',
+        bestPractices: [
+            'Use for learning node usage',
+            'Check coverage with get_database_statistics',
+            'Combine with get_node_essentials'
+        ],
+        pitfalls: [
+            'Not all nodes have docs (87% coverage)',
+            'May be outdated for new features',
+            'Requires full node type prefix'
+        ],
+        relatedTools: ['get_node_info', 'get_node_essentials', 'search_nodes']
+    }
+};
+//# sourceMappingURL=get-node-documentation.js.map

package/dist/mcp/tool-docs/configuration/get-node-documentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-node-documentation.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/configuration/get-node-documentation.ts"],"names":[],"mappings":";;;AAEa,QAAA,uBAAuB,GAAsB;IACxD,IAAI,EAAE,wBAAwB;IAC9B,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE;QACV,WAAW,EAAE,iHAAiH;QAC9H,aAAa,EAAE,CAAC,UAAU,CAAC;QAC3B,OAAO,EAAE,wDAAwD;QACjE,WAAW,EAAE,mBAAmB;QAChC,IAAI,EAAE;YACJ,cAAc;YACd,wBAAwB;YACxB,uBAAuB;SACxB;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,oLAAoL;QACjM,UAAU,EAAE;YACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uDAAuD,EAAE;SACnH;QACD,OAAO,EAAE,qFAAqF;QAC9F,QAAQ,EAAE;YACR,4EAA4E;YAC5E,iFAAiF;SAClF;QACD,QAAQ,EAAE;YACR,oCAAoC;YACpC,wBAAwB;YACxB,0BAA0B;SAC3B;QACD,WAAW,EAAE,oDAAoD;QACjE,aAAa,EAAE;YACb,6BAA6B;YAC7B,6CAA6C;YAC7C,kCAAkC;SACnC;QACD,QAAQ,EAAE;YACR,wCAAwC;YACxC,kCAAkC;YAClC,gCAAgC;SACjC;QACD,YAAY,EAAE,CAAC,eAAe,EAAE,qBAAqB,EAAE,cAAc,CAAC;KACvE;CACF,CAAC"}

package/dist/mcp/tool-docs/configuration/get-node-essentials.d.ts

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

package/dist/mcp/tool-docs/configuration/get-node-essentials.d.ts.map

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

package/dist/mcp/tool-docs/configuration/get-node-essentials.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNodeEssentialsDoc = void 0;
+exports.getNodeEssentialsDoc = {
+    name: 'get_node_essentials',
+    category: 'configuration',
+    essentials: {
+        description: 'Returns only the most commonly-used properties for a node (10-20 fields). Response is 95% smaller than get_node_info (5KB vs 100KB+). Essential properties include required fields, common options, and authentication settings. Use validate_node_operation for working configurations.',
+        keyParameters: ['nodeType'],
+        example: 'get_node_essentials({nodeType: "nodes-base.slack"})',
+        performance: '<10ms, ~5KB response',
+        tips: [
+            'Always use this before get_node_info',
+            'Use validate_node_operation for examples',
+            'Perfect for understanding node structure'
+        ]
+    },
+    full: {
+        description: 'Returns a curated subset of node properties focusing on the most commonly-used fields. Essential properties are hand-picked for each node type and include: required fields, primary operations, authentication options, and the most frequent configuration patterns. NOTE: Examples have been removed to avoid confusion - use validate_node_operation to get working configurations with proper validation.',
+        parameters: {
+            nodeType: { type: 'string', description: 'Full node type with prefix, e.g., "nodes-base.slack", "nodes-base.httpRequest"', required: true }
+        },
+        returns: `Object containing:
+{
+  "nodeType": "nodes-base.slack",
+  "displayName": "Slack",
+  "description": "Consume Slack API",
+  "category": "output",
+  "version": "2.3",
+  "requiredProperties": [],  // Most nodes have no strictly required fields
+  "commonProperties": [
+    {
+      "name": "resource",
+      "displayName": "Resource",
+      "type": "options",
+      "options": ["channel", "message", "user"],
+      "default": "message"
+    },
+    {
+      "name": "operation",
+      "displayName": "Operation", 
+      "type": "options",
+      "options": ["post", "update", "delete"],
+      "default": "post"
+    },
+    // ... 10-20 most common properties
+  ],
+  "operations": [
+    {"name": "Post", "description": "Post a message"},
+    {"name": "Update", "description": "Update a message"}
+  ],
+  "metadata": {
+    "totalProperties": 121,
+    "isAITool": false,
+    "hasCredentials": true
+  }
+}`,
+        examples: [
+            'get_node_essentials({nodeType: "nodes-base.httpRequest"}) - HTTP configuration basics',
+            'get_node_essentials({nodeType: "nodes-base.slack"}) - Slack messaging essentials',
+            'get_node_essentials({nodeType: "nodes-base.googleSheets"}) - Sheets operations',
+            '// Workflow: search → essentials → validate',
+            'const nodes = search_nodes({query: "database"});',
+            'const mysql = get_node_essentials({nodeType: "nodes-base.mySql"});',
+            'validate_node_operation("nodes-base.mySql", {operation: "select"}, "minimal");'
+        ],
+        useCases: [
+            'Quickly understand node structure without information overload',
+            'Identify which properties are most important',
+            'Learn node basics before diving into advanced features',
+            'Build workflows faster with curated property sets'
+        ],
+        performance: '<10ms response time, ~5KB payload (vs 100KB+ for full schema)',
+        bestPractices: [
+            'Always start with essentials, only use get_node_info if needed',
+            'Use validate_node_operation to get working configurations',
+            'Check authentication requirements first',
+            'Use search_node_properties if specific property not in essentials'
+        ],
+        pitfalls: [
+            'Advanced properties not included - use get_node_info for complete schema',
+            'Node-specific validators may require additional fields',
+            'Some nodes have 50+ properties, essentials shows only top 10-20'
+        ],
+        relatedTools: ['get_node_info for complete schema', 'search_node_properties for finding specific fields', 'validate_node_minimal to check configuration']
+    }
+};
+//# sourceMappingURL=get-node-essentials.js.map

package/dist/mcp/tool-docs/configuration/get-node-essentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-node-essentials.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/configuration/get-node-essentials.ts"],"names":[],"mappings":";;;AAEa,QAAA,oBAAoB,GAAsB;IACrD,IAAI,EAAE,qBAAqB;IAC3B,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE;QACV,WAAW,EAAE,0RAA0R;QACvS,aAAa,EAAE,CAAC,UAAU,CAAC;QAC3B,OAAO,EAAE,qDAAqD;QAC9D,WAAW,EAAE,sBAAsB;QACnC,IAAI,EAAE;YACJ,sCAAsC;YACtC,0CAA0C;YAC1C,0CAA0C;SAC3C;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,gZAAgZ;QAC7Z,UAAU,EAAE;YACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gFAAgF,EAAE,QAAQ,EAAE,IAAI,EAAE;SAC5I;QACD,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCX;QACE,QAAQ,EAAE;YACR,uFAAuF;YACvF,kFAAkF;YAClF,gFAAgF;YAChF,6CAA6C;YAC7C,kDAAkD;YAClD,oEAAoE;YACpE,gFAAgF;SACjF;QACD,QAAQ,EAAE;YACR,gEAAgE;YAChE,8CAA8C;YAC9C,wDAAwD;YACxD,mDAAmD;SACpD;QACD,WAAW,EAAE,+DAA+D;QAC5E,aAAa,EAAE;YACb,gEAAgE;YAChE,2DAA2D;YAC3D,yCAAyC;YACzC,mEAAmE;SACpE;QACD,QAAQ,EAAE;YACR,0EAA0E;YAC1E,wDAAwD;YACxD,iEAAiE;SAClE;QACD,YAAY,EAAE,CAAC,mCAAmC,EAAE,oDAAoD,EAAE,8CAA8C,CAAC;KAC1J;CACF,CAAC"}

package/dist/mcp/tool-docs/configuration/get-node-info.d.ts

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

package/dist/mcp/tool-docs/configuration/get-node-info.d.ts.map

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

package/dist/mcp/tool-docs/configuration/get-node-info.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNodeInfoDoc = void 0;
+exports.getNodeInfoDoc = {
+    name: 'get_node_info',
+    category: 'configuration',
+    essentials: {
+        description: 'Returns complete node schema with ALL properties (100KB+ response). Only use when you need advanced properties not in get_node_essentials. Contains 200+ properties for complex nodes like HTTP Request. Requires full prefix like "nodes-base.httpRequest".',
+        keyParameters: ['nodeType'],
+        example: 'get_node_info({nodeType: "nodes-base.slack"})',
+        performance: '100-500ms, 50-500KB response',
+        tips: [
+            'Try get_node_essentials first (95% smaller)',
+            'Use only for advanced configurations',
+            'Response may have 200+ properties'
+        ]
+    },
+    full: {
+        description: 'Returns the complete JSON schema for a node including all properties, operations, authentication methods, version information, and metadata. Response sizes range from 50KB to 500KB. Use this only when get_node_essentials doesn\'t provide the specific property you need.',
+        parameters: {
+            nodeType: { type: 'string', required: true, description: 'Full node type with prefix. Examples: "nodes-base.slack", "nodes-base.httpRequest", "nodes-langchain.openAi"' }
+        },
+        returns: `Complete node object containing:
+{
+  "displayName": "Slack",
+  "name": "slack",
+  "type": "nodes-base.slack",
+  "typeVersion": 2.2,
+  "description": "Consume Slack API",
+  "defaults": {"name": "Slack"},
+  "inputs": ["main"],
+  "outputs": ["main"],
+  "credentials": [
+    {
+      "name": "slackApi",
+      "required": true,
+      "displayOptions": {...}
+    }
+  ],
+  "properties": [
+    // 200+ property definitions including:
+    {
+      "displayName": "Resource",
+      "name": "resource",
+      "type": "options",
+      "options": ["channel", "message", "user", "file", ...],
+      "default": "message"
+    },
+    {
+      "displayName": "Operation", 
+      "name": "operation",
+      "type": "options",
+      "displayOptions": {
+        "show": {"resource": ["message"]}
+      },
+      "options": ["post", "update", "delete", "get", ...],
+      "default": "post"
+    },
+    // ... 200+ more properties with complex conditions
+  ],
+  "version": 2.2,
+  "subtitle": "={{$parameter[\"operation\"] + \": \" + $parameter[\"resource\"]}}",
+  "codex": {...},
+  "supportedWebhooks": [...]
+}`,
+        examples: [
+            'get_node_info({nodeType: "nodes-base.httpRequest"}) - 300+ properties for HTTP requests',
+            'get_node_info({nodeType: "nodes-base.googleSheets"}) - Complex operations and auth',
+            '// When to use get_node_info:',
+            '// 1. First try essentials',
+            'const essentials = get_node_essentials({nodeType: "nodes-base.slack"});',
+            '// 2. If property missing, search for it',
+            'const props = search_node_properties({nodeType: "nodes-base.slack", query: "thread"});',
+            '// 3. Only if needed, get full schema',
+            'const full = get_node_info({nodeType: "nodes-base.slack"});'
+        ],
+        useCases: [
+            'Analyzing all available operations for a node',
+            'Understanding complex property dependencies',
+            'Discovering all authentication methods',
+            'Building UI that shows all node options',
+            'Debugging property visibility conditions'
+        ],
+        performance: '100-500ms depending on node complexity. HTTP Request node: ~300KB, Simple nodes: ~50KB',
+        bestPractices: [
+            'Always try get_node_essentials first - it\'s 95% smaller',
+            'Use search_node_properties to find specific advanced properties',
+            'Cache results locally - schemas rarely change',
+            'Parse incrementally - don\'t load entire response into memory at once'
+        ],
+        pitfalls: [
+            'Response can exceed 500KB for complex nodes',
+            'Contains many rarely-used properties that add noise',
+            'Property conditions can be deeply nested and complex',
+            'Must use full node type with prefix (nodes-base.X not just X)'
+        ],
+        relatedTools: ['get_node_essentials for common properties', 'search_node_properties to find specific fields', 'get_property_dependencies to understand conditions']
+    }
+};
+//# sourceMappingURL=get-node-info.js.map

package/dist/mcp/tool-docs/configuration/get-node-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-node-info.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/configuration/get-node-info.ts"],"names":[],"mappings":";;;AAEa,QAAA,cAAc,GAAsB;IAC/C,IAAI,EAAE,eAAe;IACrB,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE;QACV,WAAW,EAAE,8PAA8P;QAC3Q,aAAa,EAAE,CAAC,UAAU,CAAC;QAC3B,OAAO,EAAE,+CAA+C;QACxD,WAAW,EAAE,8BAA8B;QAC3C,IAAI,EAAE;YACJ,6CAA6C;YAC7C,sCAAsC;YACtC,mCAAmC;SACpC;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,+QAA+Q;QAC5R,UAAU,EAAE;YACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,8GAA8G,EAAE;SAC1K;QACD,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0CX;QACE,QAAQ,EAAE;YACR,yFAAyF;YACzF,oFAAoF;YACpF,+BAA+B;YAC/B,4BAA4B;YAC5B,yEAAyE;YACzE,0CAA0C;YAC1C,wFAAwF;YACxF,uCAAuC;YACvC,6DAA6D;SAC9D;QACD,QAAQ,EAAE;YACR,+CAA+C;YAC/C,6CAA6C;YAC7C,wCAAwC;YACxC,yCAAyC;YACzC,0CAA0C;SAC3C;QACD,WAAW,EAAE,wFAAwF;QACrG,aAAa,EAAE;YACb,0DAA0D;YAC1D,iEAAiE;YACjE,+CAA+C;YAC/C,uEAAuE;SACxE;QACD,QAAQ,EAAE;YACR,6CAA6C;YAC7C,qDAAqD;YACrD,sDAAsD;YACtD,+DAA+D;SAChE;QACD,YAAY,EAAE,CAAC,2CAA2C,EAAE,gDAAgD,EAAE,oDAAoD,CAAC;KACpK;CACF,CAAC"}

package/dist/mcp/tool-docs/configuration/get-property-dependencies.d.ts

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

package/dist/mcp/tool-docs/configuration/get-property-dependencies.d.ts.map

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

package/dist/mcp/tool-docs/configuration/get-property-dependencies.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPropertyDependenciesDoc = void 0;
+exports.getPropertyDependenciesDoc = {
+    name: 'get_property_dependencies',
+    category: 'configuration',
+    essentials: {
+        description: 'Shows property dependencies and visibility rules - which fields appear when.',
+        keyParameters: ['nodeType', 'config?'],
+        example: 'get_property_dependencies({nodeType: "nodes-base.httpRequest"})',
+        performance: 'Fast - analyzes property conditions',
+        tips: [
+            'Shows which properties depend on other property values',
+            'Test visibility impact with optional config parameter',
+            'Helps understand complex conditional property displays'
+        ]
+    },
+    full: {
+        description: `Analyzes property dependencies and visibility conditions for a node. Shows which properties control the visibility of other properties (e.g., sendBody=true reveals body-related fields). Optionally test how a specific configuration affects property visibility.`,
+        parameters: {
+            nodeType: {
+                type: 'string',
+                required: true,
+                description: 'The node type to analyze (e.g., "nodes-base.httpRequest")',
+                examples: [
+                    'nodes-base.httpRequest',
+                    'nodes-base.slack',
+                    'nodes-base.if',
+                    'nodes-base.switch'
+                ]
+            },
+            config: {
+                type: 'object',
+                required: false,
+                description: 'Optional partial configuration to check visibility impact',
+                examples: [
+                    '{ method: "POST", sendBody: true }',
+                    '{ operation: "create", resource: "contact" }',
+                    '{ mode: "rules" }'
+                ]
+            }
+        },
+        returns: `Object containing:
+- nodeType: The analyzed node type
+- displayName: Human-readable node name
+- controllingProperties: Properties that control visibility of others
+- dependentProperties: Properties whose visibility depends on others
+- complexDependencies: Multi-condition dependencies
+- currentConfig: If config provided, shows:
+  - providedValues: The configuration you passed
+  - visibilityImpact: Which properties are visible/hidden`,
+        examples: [
+            'get_property_dependencies({nodeType: "nodes-base.httpRequest"}) - Analyze HTTP Request dependencies',
+            'get_property_dependencies({nodeType: "nodes-base.httpRequest", config: {sendBody: true}}) - Test visibility with sendBody enabled',
+            'get_property_dependencies({nodeType: "nodes-base.if", config: {mode: "rules"}}) - Check If node in rules mode'
+        ],
+        useCases: [
+            'Understanding which properties control others',
+            'Debugging why certain fields are not visible',
+            'Building dynamic UIs that match n8n behavior',
+            'Testing configurations before applying them',
+            'Understanding complex node property relationships'
+        ],
+        performance: 'Fast - analyzes property metadata without database queries',
+        bestPractices: [
+            'Use before configuring complex nodes with many conditional fields',
+            'Test different config values to understand visibility rules',
+            'Check dependencies when properties seem to be missing',
+            'Use for nodes with multiple operation modes (Slack, Google Sheets)',
+            'Combine with search_node_properties to find specific fields'
+        ],
+        pitfalls: [
+            'Some properties have complex multi-condition dependencies',
+            'Visibility rules can be nested (property A controls B which controls C)',
+            'Not all hidden properties are due to dependencies (some are deprecated)',
+            'Config parameter only tests visibility, does not validate values'
+        ],
+        relatedTools: ['search_node_properties', 'get_node_essentials', 'validate_node_operation']
+    }
+};
+//# sourceMappingURL=get-property-dependencies.js.map

package/dist/mcp/tool-docs/configuration/get-property-dependencies.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-property-dependencies.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/configuration/get-property-dependencies.ts"],"names":[],"mappings":";;;AAEa,QAAA,0BAA0B,GAAsB;IAC3D,IAAI,EAAE,2BAA2B;IACjC,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE;QACV,WAAW,EAAE,8EAA8E;QAC3F,aAAa,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;QACtC,OAAO,EAAE,iEAAiE;QAC1E,WAAW,EAAE,qCAAqC;QAClD,IAAI,EAAE;YACJ,wDAAwD;YACxD,uDAAuD;YACvD,wDAAwD;SACzD;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,qQAAqQ;QAClR,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,2DAA2D;gBACxE,QAAQ,EAAE;oBACR,wBAAwB;oBACxB,kBAAkB;oBAClB,eAAe;oBACf,mBAAmB;iBACpB;aACF;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,2DAA2D;gBACxE,QAAQ,EAAE;oBACR,oCAAoC;oBACpC,8CAA8C;oBAC9C,mBAAmB;iBACpB;aACF;SACF;QACD,OAAO,EAAE;;;;;;;;0DAQ6C;QACtD,QAAQ,EAAE;YACR,qGAAqG;YACrG,mIAAmI;YACnI,+GAA+G;SAChH;QACD,QAAQ,EAAE;YACR,+CAA+C;YAC/C,8CAA8C;YAC9C,8CAA8C;YAC9C,6CAA6C;YAC7C,mDAAmD;SACpD;QACD,WAAW,EAAE,4DAA4D;QACzE,aAAa,EAAE;YACb,mEAAmE;YACnE,6DAA6D;YAC7D,uDAAuD;YACvD,oEAAoE;YACpE,6DAA6D;SAC9D;QACD,QAAQ,EAAE;YACR,2DAA2D;YAC3D,yEAAyE;YACzE,yEAAyE;YACzE,kEAAkE;SACnE;QACD,YAAY,EAAE,CAAC,wBAAwB,EAAE,qBAAqB,EAAE,yBAAyB,CAAC;KAC3F;CACF,CAAC"}

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

@@ -0,0 +1,7 @@
+export { getNodeInfoDoc } from './get-node-info';
+export { getNodeEssentialsDoc } from './get-node-essentials';
+export { getNodeDocumentationDoc } from './get-node-documentation';
+export { searchNodePropertiesDoc } from './search-node-properties';
+export { getNodeAsToolInfoDoc } from './get-node-as-tool-info';
+export { getPropertyDependenciesDoc } from './get-property-dependencies';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/configuration/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC"}

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

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPropertyDependenciesDoc = exports.getNodeAsToolInfoDoc = exports.searchNodePropertiesDoc = exports.getNodeDocumentationDoc = exports.getNodeEssentialsDoc = exports.getNodeInfoDoc = void 0;
+var get_node_info_1 = require("./get-node-info");
+Object.defineProperty(exports, "getNodeInfoDoc", { enumerable: true, get: function () { return get_node_info_1.getNodeInfoDoc; } });
+var get_node_essentials_1 = require("./get-node-essentials");
+Object.defineProperty(exports, "getNodeEssentialsDoc", { enumerable: true, get: function () { return get_node_essentials_1.getNodeEssentialsDoc; } });
+var get_node_documentation_1 = require("./get-node-documentation");
+Object.defineProperty(exports, "getNodeDocumentationDoc", { enumerable: true, get: function () { return get_node_documentation_1.getNodeDocumentationDoc; } });
+var search_node_properties_1 = require("./search-node-properties");
+Object.defineProperty(exports, "searchNodePropertiesDoc", { enumerable: true, get: function () { return search_node_properties_1.searchNodePropertiesDoc; } });
+var get_node_as_tool_info_1 = require("./get-node-as-tool-info");
+Object.defineProperty(exports, "getNodeAsToolInfoDoc", { enumerable: true, get: function () { return get_node_as_tool_info_1.getNodeAsToolInfoDoc; } });
+var get_property_dependencies_1 = require("./get-property-dependencies");
+Object.defineProperty(exports, "getPropertyDependenciesDoc", { enumerable: true, get: function () { return get_property_dependencies_1.getPropertyDependenciesDoc; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/configuration/index.ts"],"names":[],"mappings":";;;AAAA,iDAAiD;AAAxC,+GAAA,cAAc,OAAA;AACvB,6DAA6D;AAApD,2HAAA,oBAAoB,OAAA;AAC7B,mEAAmE;AAA1D,iIAAA,uBAAuB,OAAA;AAChC,mEAAmE;AAA1D,iIAAA,uBAAuB,OAAA;AAChC,iEAA+D;AAAtD,6HAAA,oBAAoB,OAAA;AAC7B,yEAAyE;AAAhE,uIAAA,0BAA0B,OAAA"}

package/dist/mcp/tool-docs/configuration/search-node-properties.d.ts

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

package/dist/mcp/tool-docs/configuration/search-node-properties.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-node-properties.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/configuration/search-node-properties.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,uBAAuB,EAAE,iBA8FrC,CAAC"}

package/dist/mcp/tool-docs/configuration/search-node-properties.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchNodePropertiesDoc = void 0;
+exports.searchNodePropertiesDoc = {
+    name: 'search_node_properties',
+    category: 'configuration',
+    essentials: {
+        description: 'Find specific properties in a node without downloading all 200+ properties.',
+        keyParameters: ['nodeType', 'query'],
+        example: 'search_node_properties({nodeType: "nodes-base.httpRequest", query: "auth"})',
+        performance: 'Fast - searches indexed properties',
+        tips: [
+            'Search for "auth", "header", "body", "json", "credential"',
+            'Returns property paths and descriptions',
+            'Much faster than get_node_info for finding specific fields'
+        ]
+    },
+    full: {
+        description: `Searches for specific properties within a node's configuration schema. Essential for finding authentication fields, headers, body parameters, or any specific property without downloading the entire node schema (which can be 100KB+). Returns matching properties with their paths, types, and descriptions.`,
+        parameters: {
+            nodeType: {
+                type: 'string',
+                required: true,
+                description: 'Full type with prefix',
+                examples: [
+                    'nodes-base.httpRequest',
+                    'nodes-base.slack',
+                    'nodes-base.postgres',
+                    'nodes-base.googleSheets'
+                ]
+            },
+            query: {
+                type: 'string',
+                required: true,
+                description: 'Property to find: "auth", "header", "body", "json"',
+                examples: [
+                    'auth',
+                    'header',
+                    'body',
+                    'json',
+                    'credential',
+                    'timeout',
+                    'retry',
+                    'pagination'
+                ]
+            },
+            maxResults: {
+                type: 'number',
+                required: false,
+                description: 'Max results (default 20)',
+                default: 20
+            }
+        },
+        returns: `Object containing:
+- nodeType: The searched node type
+- query: Your search term
+- matches: Array of matching properties with:
+  - name: Property identifier
+  - displayName: Human-readable name
+  - type: Property type (string, number, options, etc.)
+  - description: Property description
+  - path: Full path to property (for nested properties)
+  - required: Whether property is required
+  - default: Default value if any
+  - options: Available options for selection properties
+  - showWhen: Visibility conditions
+- totalMatches: Number of matches found
+- searchedIn: Total properties searched`,
+        examples: [
+            'search_node_properties({nodeType: "nodes-base.httpRequest", query: "auth"}) - Find authentication fields',
+            'search_node_properties({nodeType: "nodes-base.slack", query: "channel"}) - Find channel-related properties',
+            'search_node_properties({nodeType: "nodes-base.postgres", query: "query"}) - Find query fields',
+            'search_node_properties({nodeType: "nodes-base.webhook", query: "response"}) - Find response options'
+        ],
+        useCases: [
+            'Finding authentication/credential fields quickly',
+            'Locating specific parameters without full node info',
+            'Discovering header or body configuration options',
+            'Finding nested properties in complex nodes',
+            'Checking if a node supports specific features (retry, pagination, etc.)'
+        ],
+        performance: 'Very fast - searches pre-indexed property metadata',
+        bestPractices: [
+            'Use before get_node_info to find specific properties',
+            'Search for common terms: auth, header, body, credential',
+            'Check showWhen conditions to understand visibility',
+            'Use with get_property_dependencies for complete understanding',
+            'Limit results if you only need to check existence'
+        ],
+        pitfalls: [
+            'Some properties may be hidden due to visibility conditions',
+            'Property names may differ from display names',
+            'Nested properties show full path (e.g., "options.retry.limit")',
+            'Search is case-sensitive for property names'
+        ],
+        relatedTools: ['get_node_essentials', 'get_property_dependencies', 'get_node_info']
+    }
+};
+//# sourceMappingURL=search-node-properties.js.map

package/dist/mcp/tool-docs/configuration/search-node-properties.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-node-properties.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/configuration/search-node-properties.ts"],"names":[],"mappings":";;;AAEa,QAAA,uBAAuB,GAAsB;IACxD,IAAI,EAAE,wBAAwB;IAC9B,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE;QACV,WAAW,EAAE,6EAA6E;QAC1F,aAAa,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC;QACpC,OAAO,EAAE,6EAA6E;QACtF,WAAW,EAAE,oCAAoC;QACjD,IAAI,EAAE;YACJ,2DAA2D;YAC3D,yCAAyC;YACzC,4DAA4D;SAC7D;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,iTAAiT;QAC9T,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,uBAAuB;gBACpC,QAAQ,EAAE;oBACR,wBAAwB;oBACxB,kBAAkB;oBAClB,qBAAqB;oBACrB,yBAAyB;iBAC1B;aACF;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,oDAAoD;gBACjE,QAAQ,EAAE;oBACR,MAAM;oBACN,QAAQ;oBACR,MAAM;oBACN,MAAM;oBACN,YAAY;oBACZ,SAAS;oBACT,OAAO;oBACP,YAAY;iBACb;aACF;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,0BAA0B;gBACvC,OAAO,EAAE,EAAE;aACZ;SACF;QACD,OAAO,EAAE;;;;;;;;;;;;;;wCAc2B;QACpC,QAAQ,EAAE;YACR,0GAA0G;YAC1G,4GAA4G;YAC5G,+FAA+F;YAC/F,qGAAqG;SACtG;QACD,QAAQ,EAAE;YACR,kDAAkD;YAClD,qDAAqD;YACrD,kDAAkD;YAClD,4CAA4C;YAC5C,yEAAyE;SAC1E;QACD,WAAW,EAAE,oDAAoD;QACjE,aAAa,EAAE;YACb,sDAAsD;YACtD,yDAAyD;YACzD,oDAAoD;YACpD,+DAA+D;YAC/D,mDAAmD;SACpD;QACD,QAAQ,EAAE;YACR,4DAA4D;YAC5D,8CAA8C;YAC9C,gEAAgE;YAChE,6CAA6C;SAC9C;QACD,YAAY,EAAE,CAAC,qBAAqB,EAAE,2BAA2B,EAAE,eAAe,CAAC;KACpF;CACF,CAAC"}

package/dist/mcp/tool-docs/discovery/get-database-statistics.d.ts

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

package/dist/mcp/tool-docs/discovery/get-database-statistics.d.ts.map

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