n8n-mcp 2.7.15 → 2.7.17

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-template.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/templates/get-template.ts"],"names":[],"mappings":";;;AAEa,QAAA,cAAc,GAAsB;IAC/C,IAAI,EAAE,cAAc;IACpB,QAAQ,EAAE,WAAW;IACrB,UAAU,EAAE;QACV,WAAW,EAAE,sGAAsG;QACnH,aAAa,EAAE,CAAC,YAAY,CAAC;QAC7B,OAAO,EAAE,kCAAkC;QAC3C,WAAW,EAAE,wCAAwC;QACrD,IAAI,EAAE;YACJ,qEAAqE;YACrE,0DAA0D;YAC1D,+CAA+C;SAChD;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,qQAAqQ;QAClR,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,kGAAkG;aAChH;SACF;QACD,OAAO,EAAE;;;;;;;;;;;;;;6CAcgC;QACzC,QAAQ,EAAE;YACR,oEAAoE;YACpE,2DAA2D;YAC3D,4DAA4D;SAC7D;QACD,QAAQ,EAAE;YACR,+CAA+C;YAC/C,4CAA4C;YAC5C,8CAA8C;YAC9C,2CAA2C;YAC3C,yCAAyC;SAC1C;QACD,WAAW,EAAE;;;;sCAIqB;QAClC,aAAa,EAAE;YACb,iEAAiE;YACjE,gEAAgE;YAChE,gEAAgE;YAChE,uDAAuD;YACvD,8DAA8D;SAC/D;QACD,QAAQ,EAAE;YACR,gDAAgD;YAChD,iDAAiD;YACjD,gEAAgE;YAChE,8CAA8C;YAC9C,oEAAoE;SACrE;QACD,YAAY,EAAE,CAAC,qBAAqB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,qBAAqB,CAAC;KAC3G;CACF,CAAC"}

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

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

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

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

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

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTemplatesForTaskDoc = void 0;
+exports.getTemplatesForTaskDoc = {
+    name: 'get_templates_for_task',
+    category: 'templates',
+    essentials: {
+        description: 'Curated templates by task: ai_automation, data_sync, webhooks, email, slack, data_transform, files, scheduling, api, database.',
+        keyParameters: ['task'],
+        example: 'get_templates_for_task({task: "slack_integration"})',
+        performance: 'Fast (<100ms) - pre-categorized results',
+        tips: [
+            'Returns hand-picked templates for specific automation tasks',
+            'Use list_tasks to see all available task categories',
+            'Templates are curated for quality and relevance'
+        ]
+    },
+    full: {
+        description: `Retrieves curated workflow templates for specific automation tasks. This tool provides hand-picked templates organized by common use cases, making it easy to find the right workflow for your needs. Each task category contains the most popular and effective templates for that particular automation scenario.`,
+        parameters: {
+            task: {
+                type: 'string',
+                required: true,
+                description: 'The type of task to get templates for. Options: ai_automation, data_sync, webhook_processing, email_automation, slack_integration, data_transformation, file_processing, scheduling, api_integration, database_operations'
+            }
+        },
+        returns: `Returns an object containing:
+- task: The requested task type
+- templates: Array of curated templates
+  - id: Template ID
+  - name: Template name
+  - description: What the workflow does
+  - author: Creator information
+  - nodes: Array of node types used
+  - views: Popularity metric
+  - created: Creation date
+  - url: Link to template
+- totalFound: Number of templates in this category
+- availableTasks: List of all task categories (if no templates found)`,
+        examples: [
+            'get_templates_for_task({task: "slack_integration"}) - Get Slack automation workflows',
+            'get_templates_for_task({task: "ai_automation"}) - Get AI-powered workflows',
+            'get_templates_for_task({task: "data_sync"}) - Get data synchronization workflows',
+            'get_templates_for_task({task: "webhook_processing"}) - Get webhook handler workflows',
+            'get_templates_for_task({task: "email_automation"}) - Get email automation workflows'
+        ],
+        useCases: [
+            'Find workflows for specific business needs',
+            'Discover best practices for common automations',
+            'Get started quickly with pre-built solutions',
+            'Learn patterns for specific integration types',
+            'Browse curated collections of quality workflows'
+        ],
+        performance: `Excellent performance with pre-categorized templates:
+- Query time: <10ms (indexed by task)
+- No filtering needed (pre-curated)
+- Returns 5-20 templates per category
+- Total response time: <100ms`,
+        bestPractices: [
+            'Start with task-based search for faster results',
+            'Review multiple templates to find best patterns',
+            'Check template age for most current approaches',
+            'Combine templates from same category for complex workflows',
+            'Use returned node lists to understand requirements'
+        ],
+        pitfalls: [
+            'Not all tasks have many templates available',
+            'Task categories are predefined - no custom categories',
+            'Some templates may overlap between categories',
+            'Curation is subjective - browse all results',
+            'Templates may need updates for latest n8n features'
+        ],
+        relatedTools: ['search_templates', 'list_node_templates', 'get_template', 'list_tasks']
+    }
+};
+//# sourceMappingURL=get-templates-for-task.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"get-templates-for-task.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/templates/get-templates-for-task.ts"],"names":[],"mappings":";;;AAEa,QAAA,sBAAsB,GAAsB;IACvD,IAAI,EAAE,wBAAwB;IAC9B,QAAQ,EAAE,WAAW;IACrB,UAAU,EAAE;QACV,WAAW,EAAE,gIAAgI;QAC7I,aAAa,EAAE,CAAC,MAAM,CAAC;QACvB,OAAO,EAAE,qDAAqD;QAC9D,WAAW,EAAE,yCAAyC;QACtD,IAAI,EAAE;YACJ,6DAA6D;YAC7D,qDAAqD;YACrD,iDAAiD;SAClD;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,qTAAqT;QAClU,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,2NAA2N;aACzO;SACF;QACD,OAAO,EAAE;;;;;;;;;;;;sEAYyD;QAClE,QAAQ,EAAE;YACR,sFAAsF;YACtF,4EAA4E;YAC5E,kFAAkF;YAClF,sFAAsF;YACtF,qFAAqF;SACtF;QACD,QAAQ,EAAE;YACR,4CAA4C;YAC5C,gDAAgD;YAChD,8CAA8C;YAC9C,+CAA+C;YAC/C,iDAAiD;SAClD;QACD,WAAW,EAAE;;;;8BAIa;QAC1B,aAAa,EAAE;YACb,iDAAiD;YACjD,iDAAiD;YACjD,gDAAgD;YAChD,4DAA4D;YAC5D,oDAAoD;SACrD;QACD,QAAQ,EAAE;YACR,6CAA6C;YAC7C,uDAAuD;YACvD,+CAA+C;YAC/C,6CAA6C;YAC7C,oDAAoD;SACrD;QACD,YAAY,EAAE,CAAC,kBAAkB,EAAE,qBAAqB,EAAE,cAAc,EAAE,YAAY,CAAC;KACxF;CACF,CAAC"}

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

@@ -0,0 +1,7 @@
+export { getNodeForTaskDoc } from './get-node-for-task';
+export { listTasksDoc } from './list-tasks';
+export { listNodeTemplatesDoc } from './list-node-templates';
+export { getTemplateDoc } from './get-template';
+export { searchTemplatesDoc } from './search-templates';
+export { getTemplatesForTaskDoc } from './get-templates-for-task';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/templates/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC"}

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

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTemplatesForTaskDoc = exports.searchTemplatesDoc = exports.getTemplateDoc = exports.listNodeTemplatesDoc = exports.listTasksDoc = exports.getNodeForTaskDoc = void 0;
+var get_node_for_task_1 = require("./get-node-for-task");
+Object.defineProperty(exports, "getNodeForTaskDoc", { enumerable: true, get: function () { return get_node_for_task_1.getNodeForTaskDoc; } });
+var list_tasks_1 = require("./list-tasks");
+Object.defineProperty(exports, "listTasksDoc", { enumerable: true, get: function () { return list_tasks_1.listTasksDoc; } });
+var list_node_templates_1 = require("./list-node-templates");
+Object.defineProperty(exports, "listNodeTemplatesDoc", { enumerable: true, get: function () { return list_node_templates_1.listNodeTemplatesDoc; } });
+var get_template_1 = require("./get-template");
+Object.defineProperty(exports, "getTemplateDoc", { enumerable: true, get: function () { return get_template_1.getTemplateDoc; } });
+var search_templates_1 = require("./search-templates");
+Object.defineProperty(exports, "searchTemplatesDoc", { enumerable: true, get: function () { return search_templates_1.searchTemplatesDoc; } });
+var get_templates_for_task_1 = require("./get-templates-for-task");
+Object.defineProperty(exports, "getTemplatesForTaskDoc", { enumerable: true, get: function () { return get_templates_for_task_1.getTemplatesForTaskDoc; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/templates/index.ts"],"names":[],"mappings":";;;AAAA,yDAAwD;AAA/C,sHAAA,iBAAiB,OAAA;AAC1B,2CAA4C;AAAnC,0GAAA,YAAY,OAAA;AACrB,6DAA6D;AAApD,2HAAA,oBAAoB,OAAA;AAC7B,+CAAgD;AAAvC,8GAAA,cAAc,OAAA;AACvB,uDAAwD;AAA/C,sHAAA,kBAAkB,OAAA;AAC3B,mEAAkE;AAAzD,gIAAA,sBAAsB,OAAA"}

package/dist/mcp/tool-docs/templates/list-node-templates.d.ts

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

package/dist/mcp/tool-docs/templates/list-node-templates.d.ts.map

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

package/dist/mcp/tool-docs/templates/list-node-templates.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listNodeTemplatesDoc = void 0;
+exports.listNodeTemplatesDoc = {
+    name: 'list_node_templates',
+    category: 'templates',
+    essentials: {
+        description: 'Find templates using specific nodes. 399 community workflows. Use FULL types: "n8n-nodes-base.httpRequest".',
+        keyParameters: ['nodeTypes', 'limit'],
+        example: 'list_node_templates({nodeTypes: ["n8n-nodes-base.slack"]})',
+        performance: 'Fast (<100ms) - indexed node search',
+        tips: [
+            'Must use FULL node type with package prefix: "n8n-nodes-base.slack"',
+            'Can search for multiple nodes to find workflows using all of them',
+            'Returns templates sorted by popularity (view count)'
+        ]
+    },
+    full: {
+        description: `Finds workflow templates that use specific n8n nodes. This is the best way to discover how particular nodes are used in real workflows. Search the community library of 399+ templates by specifying which nodes you want to see in action. Templates are sorted by popularity to show the most useful examples first.`,
+        parameters: {
+            nodeTypes: {
+                type: 'array',
+                required: true,
+                description: 'Array of node types to search for. Must use full type names with package prefix (e.g., ["n8n-nodes-base.httpRequest", "n8n-nodes-base.openAi"])'
+            },
+            limit: {
+                type: 'number',
+                required: false,
+                description: 'Maximum number of templates to return. Default 10, max 100'
+            }
+        },
+        returns: `Returns an object containing:
+- templates: Array of matching templates
+  - id: Template ID for retrieval
+  - name: Template name
+  - description: What the workflow does
+  - author: Creator details (name, username, verified)
+  - nodes: Complete list of nodes used
+  - views: View count (popularity metric)
+  - created: Creation date
+  - url: Link to template on n8n.io
+- totalFound: Total number of matching templates
+- tip: Usage hints if no results`,
+        examples: [
+            'list_node_templates({nodeTypes: ["n8n-nodes-base.slack"]}) - Find all Slack workflows',
+            'list_node_templates({nodeTypes: ["n8n-nodes-base.httpRequest", "n8n-nodes-base.postgres"]}) - Find workflows using both HTTP and Postgres',
+            'list_node_templates({nodeTypes: ["@n8n/n8n-nodes-langchain.openAi"], limit: 20}) - Find AI workflows with OpenAI',
+            'list_node_templates({nodeTypes: ["n8n-nodes-base.webhook", "n8n-nodes-base.respondToWebhook"]}) - Find webhook examples'
+        ],
+        useCases: [
+            'Learn how to use specific nodes through examples',
+            'Find workflows combining particular integrations',
+            'Discover patterns for node combinations',
+            'See real-world usage of complex nodes',
+            'Find templates for your exact tech stack'
+        ],
+        performance: `Optimized for node-based searches:
+- Indexed by node type for fast lookups
+- Query time: <50ms for single node
+- Multiple nodes: <100ms (uses AND logic)
+- Returns pre-sorted by popularity
+- No full-text search needed`,
+        bestPractices: [
+            'Always use full node type with package prefix',
+            'Search for core nodes that define the workflow purpose',
+            'Start with single node searches, then refine',
+            'Check node types with list_nodes if unsure of names',
+            'Review multiple templates to learn different approaches'
+        ],
+        pitfalls: [
+            'Node types must match exactly - no partial matches',
+            'Package prefix required: "slack" won\'t work, use "n8n-nodes-base.slack"',
+            'Some nodes have version numbers: "n8n-nodes-base.httpRequestV3"',
+            'Templates may use old node versions not in current n8n',
+            'AND logic means all specified nodes must be present'
+        ],
+        relatedTools: ['get_template', 'search_templates', 'get_templates_for_task', 'list_nodes']
+    }
+};
+//# sourceMappingURL=list-node-templates.js.map

package/dist/mcp/tool-docs/templates/list-node-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-node-templates.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/templates/list-node-templates.ts"],"names":[],"mappings":";;;AAEa,QAAA,oBAAoB,GAAsB;IACrD,IAAI,EAAE,qBAAqB;IAC3B,QAAQ,EAAE,WAAW;IACrB,UAAU,EAAE;QACV,WAAW,EAAE,6GAA6G;QAC1H,aAAa,EAAE,CAAC,WAAW,EAAE,OAAO,CAAC;QACrC,OAAO,EAAE,4DAA4D;QACrE,WAAW,EAAE,qCAAqC;QAClD,IAAI,EAAE;YACJ,qEAAqE;YACrE,mEAAmE;YACnE,qDAAqD;SACtD;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,wTAAwT;QACrU,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,iJAAiJ;aAC/J;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,4DAA4D;aAC1E;SACF;QACD,OAAO,EAAE;;;;;;;;;;;iCAWoB;QAC7B,QAAQ,EAAE;YACR,uFAAuF;YACvF,2IAA2I;YAC3I,kHAAkH;YAClH,yHAAyH;SAC1H;QACD,QAAQ,EAAE;YACR,kDAAkD;YAClD,kDAAkD;YAClD,yCAAyC;YACzC,uCAAuC;YACvC,0CAA0C;SAC3C;QACD,WAAW,EAAE;;;;;6BAKY;QACzB,aAAa,EAAE;YACb,+CAA+C;YAC/C,wDAAwD;YACxD,8CAA8C;YAC9C,qDAAqD;YACrD,yDAAyD;SAC1D;QACD,QAAQ,EAAE;YACR,oDAAoD;YACpD,0EAA0E;YAC1E,iEAAiE;YACjE,wDAAwD;YACxD,qDAAqD;SACtD;QACD,YAAY,EAAE,CAAC,cAAc,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,YAAY,CAAC;KAC3F;CACF,CAAC"}

package/dist/mcp/tool-docs/templates/list-tasks.d.ts

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