chore: add pre-built dist folder for npx usage

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

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,iBA+E5B,CAAC"}

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

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTemplateDoc = void 0;
+exports.getTemplateDoc = {
+    name: 'get_template',
+    category: 'templates',
+    essentials: {
+        description: 'Get workflow template by ID with configurable detail level. Ready to import. IDs from search_templates.',
+        keyParameters: ['templateId', 'mode'],
+        example: 'get_template({templateId: 1234, mode: "full"})',
+        performance: 'Fast (<100ms) - single database lookup',
+        tips: [
+            'Get template IDs from search_templates first',
+            'Use mode="nodes_only" for quick overview, "structure" for topology, "full" for import',
+            'Returns complete workflow JSON ready for import into n8n'
+        ]
+    },
+    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 2,700+ curated workflows.`,
+        parameters: {
+            templateId: {
+                type: 'number',
+                required: true,
+                description: 'The numeric ID of the template to retrieve. Get IDs from search_templates'
+            },
+            mode: {
+                type: 'string',
+                required: false,
+                description: 'Response detail level: "nodes_only" (minimal - just node list), "structure" (nodes + connections), "full" (complete workflow JSON, default)',
+                default: 'full',
+                enum: ['nodes_only', 'structure', 'full']
+            }
+        },
+        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 complete workflow (default mode="full")',
+            'get_template({templateId: 1234, mode: "nodes_only"}) - Get just the node list',
+            'get_template({templateId: 1234, mode: "structure"}) - Get nodes and connections',
+            'get_template({templateId: 5678, mode: "full"}) - Get complete workflow JSON for import'
+        ],
+        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: ['search_templates', 'n8n_create_workflow']
+    }
+};
+//# sourceMappingURL=get-template.js.map

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,yGAAyG;QACtH,aAAa,EAAE,CAAC,YAAY,EAAE,MAAM,CAAC;QACrC,OAAO,EAAE,gDAAgD;QACzD,WAAW,EAAE,wCAAwC;QACrD,IAAI,EAAE;YACJ,8CAA8C;YAC9C,uFAAuF;YACvF,0DAA0D;SAC3D;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,uQAAuQ;QACpR,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,2EAA2E;aACzF;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,6IAA6I;gBAC1J,OAAO,EAAE,MAAM;gBACf,IAAI,EAAE,CAAC,YAAY,EAAE,WAAW,EAAE,MAAM,CAAC;aAC1C;SACF;QACD,OAAO,EAAE;;;;;;;;;;;;;;6CAcgC;QACzC,QAAQ,EAAE;YACR,gFAAgF;YAChF,+EAA+E;YAC/E,iFAAiF;YACjF,wFAAwF;SACzF;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,kBAAkB,EAAE,qBAAqB,CAAC;KAC1D;CACF,CAAC"}

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

@@ -0,0 +1,3 @@
+export { getTemplateDoc } from './get-template';
+export { searchTemplatesDoc } from './search-templates';
+//# sourceMappingURL=index.d.ts.map

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,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchTemplatesDoc = exports.getTemplateDoc = void 0;
+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; } });
+//# sourceMappingURL=index.js.map

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,+CAAgD;AAAvC,8GAAA,cAAc,OAAA;AACvB,uDAAwD;AAA/C,sHAAA,kBAAkB,OAAA"}

dist/mcp/tool-docs/templates/search-templates.d.ts

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

dist/mcp/tool-docs/templates/search-templates.d.ts.map

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

dist/mcp/tool-docs/templates/search-templates.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchTemplatesDoc = void 0;
+exports.searchTemplatesDoc = {
+    name: 'search_templates',
+    category: 'templates',
+    essentials: {
+        description: 'Unified template search with multiple modes: keyword search, by node types, by task type, or by metadata. 2,700+ templates available.',
+        keyParameters: ['searchMode', 'query', 'nodeTypes', 'task', 'limit'],
+        example: 'search_templates({searchMode: "by_task", task: "webhook_processing"})',
+        performance: 'Fast (<100ms) - FTS5 full-text search',
+        tips: [
+            'searchMode="keyword" (default): Search by name/description',
+            'searchMode="by_nodes": Find templates using specific nodes',
+            'searchMode="by_task": Get curated templates for common tasks',
+            'searchMode="by_metadata": Filter by complexity, services, audience'
+        ]
+    },
+    full: {
+        description: `**Search Modes:**
+- keyword (default): Full-text search across template names and descriptions
+- by_nodes: Find templates that use specific node types
+- by_task: Get curated templates for predefined task categories
+- by_metadata: Filter by complexity, setup time, required services, or target audience
+
+**Available Task Types (for searchMode="by_task"):**
+ai_automation, data_sync, webhook_processing, email_automation, slack_integration, data_transformation, file_processing, scheduling, api_integration, database_operations`,
+        parameters: {
+            searchMode: {
+                type: 'string',
+                required: false,
+                description: 'Search mode: "keyword" (default), "by_nodes", "by_task", "by_metadata"'
+            },
+            query: {
+                type: 'string',
+                required: false,
+                description: 'For searchMode=keyword: Search keywords (e.g., "chatbot", "automation")'
+            },
+            nodeTypes: {
+                type: 'array',
+                required: false,
+                description: 'For searchMode=by_nodes: Array of node types (e.g., ["n8n-nodes-base.httpRequest", "n8n-nodes-base.slack"])'
+            },
+            task: {
+                type: 'string',
+                required: false,
+                description: 'For searchMode=by_task: Task type (ai_automation, data_sync, webhook_processing, email_automation, slack_integration, data_transformation, file_processing, scheduling, api_integration, database_operations)'
+            },
+            complexity: {
+                type: 'string',
+                required: false,
+                description: 'For searchMode=by_metadata: Filter by complexity ("simple", "medium", "complex")'
+            },
+            maxSetupMinutes: {
+                type: 'number',
+                required: false,
+                description: 'For searchMode=by_metadata: Maximum setup time in minutes (5-480)'
+            },
+            minSetupMinutes: {
+                type: 'number',
+                required: false,
+                description: 'For searchMode=by_metadata: Minimum setup time in minutes (5-480)'
+            },
+            requiredService: {
+                type: 'string',
+                required: false,
+                description: 'For searchMode=by_metadata: Filter by required service (e.g., "openai", "slack", "google")'
+            },
+            targetAudience: {
+                type: 'string',
+                required: false,
+                description: 'For searchMode=by_metadata: Filter by target audience (e.g., "developers", "marketers")'
+            },
+            category: {
+                type: 'string',
+                required: false,
+                description: 'For searchMode=by_metadata: Filter by category (e.g., "automation", "integration")'
+            },
+            fields: {
+                type: 'array',
+                required: false,
+                description: 'For searchMode=keyword: Fields to include (id, name, description, author, nodes, views, created, url, metadata)'
+            },
+            limit: {
+                type: 'number',
+                required: false,
+                description: 'Maximum results (default 20, max 100)'
+            },
+            offset: {
+                type: 'number',
+                required: false,
+                description: 'Pagination offset (default 0)'
+            }
+        },
+        returns: `Returns an object containing:
+- templates: Array of matching templates
+  - id: Template ID for get_template()
+  - 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
+  - metadata: AI-generated metadata (complexity, services, etc.)
+- totalFound: Total matching templates
+- searchMode: The mode used`,
+        examples: [
+            '// Keyword search (default)\nsearch_templates({query: "chatbot"})',
+            '// Find templates using specific nodes\nsearch_templates({searchMode: "by_nodes", nodeTypes: ["n8n-nodes-base.httpRequest", "n8n-nodes-base.slack"]})',
+            '// Get templates for a task type\nsearch_templates({searchMode: "by_task", task: "webhook_processing"})',
+            '// Filter by metadata\nsearch_templates({searchMode: "by_metadata", complexity: "simple", requiredService: "openai"})',
+            '// Combine metadata filters\nsearch_templates({searchMode: "by_metadata", maxSetupMinutes: 30, targetAudience: "developers"})'
+        ],
+        useCases: [
+            'Find workflows by business purpose (keyword search)',
+            'Find templates using specific integrations (by_nodes)',
+            'Get pre-built solutions for common tasks (by_task)',
+            'Filter by complexity for team skill level (by_metadata)',
+            'Find templates requiring specific services (by_metadata)'
+        ],
+        performance: `Fast performance across all modes:
+- keyword: <50ms with FTS5 indexing
+- by_nodes: <100ms with indexed lookups
+- by_task: <50ms from curated cache
+- by_metadata: <100ms with filtered queries`,
+        bestPractices: [
+            'Use searchMode="by_task" for common automation patterns',
+            'Use searchMode="by_nodes" when you know which integrations you need',
+            'Use searchMode="keyword" for general discovery',
+            'Combine by_metadata filters for precise matching',
+            'Use get_template(id) to get the full workflow JSON'
+        ],
+        pitfalls: [
+            'searchMode="keyword" searches names/descriptions, not node types',
+            'by_nodes requires full node type with prefix (n8n-nodes-base.xxx)',
+            'by_metadata filters may return fewer results',
+            'Not all templates have complete metadata'
+        ],
+        relatedTools: ['get_template', 'search_nodes', 'validate_workflow']
+    }
+};
+//# sourceMappingURL=search-templates.js.map

dist/mcp/tool-docs/templates/search-templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-templates.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/templates/search-templates.ts"],"names":[],"mappings":";;;AAEa,QAAA,kBAAkB,GAAsB;IACnD,IAAI,EAAE,kBAAkB;IACxB,QAAQ,EAAE,WAAW;IACrB,UAAU,EAAE;QACV,WAAW,EAAE,uIAAuI;QACpJ,aAAa,EAAE,CAAC,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC;QACpE,OAAO,EAAE,uEAAuE;QAChF,WAAW,EAAE,uCAAuC;QACpD,IAAI,EAAE;YACJ,4DAA4D;YAC5D,4DAA4D;YAC5D,8DAA8D;YAC9D,oEAAoE;SACrE;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE;;;;;;;0KAOyJ;QACtK,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,wEAAwE;aACtF;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,yEAAyE;aACvF;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,6GAA6G;aAC3H;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,+MAA+M;aAC7N;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,kFAAkF;aAChG;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,mEAAmE;aACjF;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,mEAAmE;aACjF;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,4FAA4F;aAC1G;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,yFAAyF;aACvG;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,oFAAoF;aAClG;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,iHAAiH;aAC/H;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,uCAAuC;aACrD;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,+BAA+B;aAC7C;SACF;QACD,OAAO,EAAE;;;;;;;;;;;;4BAYe;QACxB,QAAQ,EAAE;YACR,mEAAmE;YACnE,uJAAuJ;YACvJ,yGAAyG;YACzG,uHAAuH;YACvH,+HAA+H;SAChI;QACD,QAAQ,EAAE;YACR,qDAAqD;YACrD,uDAAuD;YACvD,oDAAoD;YACpD,yDAAyD;YACzD,0DAA0D;SAC3D;QACD,WAAW,EAAE;;;;4CAI2B;QACxC,aAAa,EAAE;YACb,yDAAyD;YACzD,qEAAqE;YACrE,gDAAgD;YAChD,kDAAkD;YAClD,oDAAoD;SACrD;QACD,QAAQ,EAAE;YACR,kEAAkE;YAClE,mEAAmE;YACnE,8CAA8C;YAC9C,0CAA0C;SAC3C;QACD,YAAY,EAAE,CAAC,cAAc,EAAE,cAAc,EAAE,mBAAmB,CAAC;KACpE;CACF,CAAC"}