n8n-mcp 2.7.15 → 2.7.20

package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-minimal.d.ts

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

package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-minimal.d.ts.map

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

package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-minimal.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.n8nGetWorkflowMinimalDoc = void 0;
+exports.n8nGetWorkflowMinimalDoc = {
+    name: 'n8n_get_workflow_minimal',
+    category: 'workflow_management',
+    essentials: {
+        description: 'Get minimal info: ID, name, active status, tags. Fast for listings.',
+        keyParameters: ['id'],
+        example: 'n8n_get_workflow_minimal({id: "workflow_123"})',
+        performance: 'Very fast (<50ms)',
+        tips: [
+            'Fastest way to check workflow exists',
+            'Perfect for status checks',
+            'Use in list displays'
+        ]
+    },
+    full: {
+        description: 'Retrieves only essential workflow information without nodes or connections. Returns minimal data needed for listings, status checks, and quick lookups. Optimized for performance when full workflow data is not needed.',
+        parameters: {
+            id: { type: 'string', required: true, description: 'Workflow ID to retrieve minimal info for' }
+        },
+        returns: 'Minimal workflow object with: id, name, active status, tags array, createdAt, updatedAt. No nodes, connections, or settings included.',
+        examples: [
+            'n8n_get_workflow_minimal({id: "abc123"}) - Quick existence check',
+            'const info = n8n_get_workflow_minimal({id: "xyz789"}); // Check if active'
+        ],
+        useCases: [
+            'Quick workflow existence checks',
+            'Display workflow lists',
+            'Check active/inactive status',
+            'Get workflow tags',
+            'Performance-critical operations'
+        ],
+        performance: 'Extremely fast - typically under 50ms. Returns only database metadata without loading workflow definition.',
+        bestPractices: [
+            'Use for list displays and dashboards',
+            'Ideal for existence checks before operations',
+            'Cache results for UI responsiveness',
+            'Combine with list_workflows for bulk checks'
+        ],
+        pitfalls: [
+            'Requires N8N_API_URL and N8N_API_KEY configured',
+            'No workflow content - cannot edit or validate',
+            'Tags may be empty array',
+            'Must use get_workflow for actual workflow data'
+        ],
+        relatedTools: ['n8n_list_workflows', 'n8n_get_workflow', 'n8n_get_workflow_structure', 'n8n_update_partial_workflow']
+    }
+};
+//# sourceMappingURL=n8n-get-workflow-minimal.js.map

package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-minimal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-get-workflow-minimal.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-get-workflow-minimal.ts"],"names":[],"mappings":";;;AAEa,QAAA,wBAAwB,GAAsB;IACzD,IAAI,EAAE,0BAA0B;IAChC,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,qEAAqE;QAClF,aAAa,EAAE,CAAC,IAAI,CAAC;QACrB,OAAO,EAAE,gDAAgD;QACzD,WAAW,EAAE,mBAAmB;QAChC,IAAI,EAAE;YACJ,sCAAsC;YACtC,2BAA2B;YAC3B,sBAAsB;SACvB;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,0NAA0N;QACvO,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,0CAA0C,EAAE;SAChG;QACD,OAAO,EAAE,uIAAuI;QAChJ,QAAQ,EAAE;YACR,kEAAkE;YAClE,2EAA2E;SAC5E;QACD,QAAQ,EAAE;YACR,iCAAiC;YACjC,wBAAwB;YACxB,8BAA8B;YAC9B,mBAAmB;YACnB,iCAAiC;SAClC;QACD,WAAW,EAAE,4GAA4G;QACzH,aAAa,EAAE;YACb,sCAAsC;YACtC,8CAA8C;YAC9C,qCAAqC;YACrC,6CAA6C;SAC9C;QACD,QAAQ,EAAE;YACR,iDAAiD;YACjD,+CAA+C;YAC/C,yBAAyB;YACzB,gDAAgD;SACjD;QACD,YAAY,EAAE,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,6BAA6B,CAAC;KACtH;CACF,CAAC"}

package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-structure.d.ts

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

package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-structure.d.ts.map

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

package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-structure.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.n8nGetWorkflowStructureDoc = void 0;
+exports.n8nGetWorkflowStructureDoc = {
+    name: 'n8n_get_workflow_structure',
+    category: 'workflow_management',
+    essentials: {
+        description: 'Get workflow structure: nodes and connections only. No parameter details.',
+        keyParameters: ['id'],
+        example: 'n8n_get_workflow_structure({id: "workflow_123"})',
+        performance: 'Fast (75-150ms)',
+        tips: [
+            'Shows workflow topology',
+            'Node types without parameters',
+            'Perfect for visualization'
+        ]
+    },
+    full: {
+        description: 'Retrieves workflow structural information including node types, positions, and connections, but without detailed node parameters. Ideal for understanding workflow topology, creating visualizations, or analyzing workflow complexity without the overhead of full parameter data.',
+        parameters: {
+            id: { type: 'string', required: true, description: 'Workflow ID to retrieve structure for' }
+        },
+        returns: 'Workflow structure with: id, name, nodes array (id, name, type, position only), connections object. No node parameters, credentials, or settings included.',
+        examples: [
+            'n8n_get_workflow_structure({id: "abc123"}) - Visualize workflow',
+            'const structure = n8n_get_workflow_structure({id: "xyz789"}); // Analyze complexity'
+        ],
+        useCases: [
+            'Generate workflow visualizations',
+            'Analyze workflow complexity',
+            'Understand node relationships',
+            'Create workflow diagrams',
+            'Quick topology validation'
+        ],
+        performance: 'Fast retrieval - typically 75-150ms. Faster than get_workflow as parameters are stripped.',
+        bestPractices: [
+            'Use for visualization tools',
+            'Ideal for workflow analysis',
+            'Good for connection validation',
+            'Cache for UI diagram rendering'
+        ],
+        pitfalls: [
+            'Requires N8N_API_URL and N8N_API_KEY configured',
+            'No parameter data for configuration',
+            'Cannot validate node settings',
+            'Must use get_workflow for editing'
+        ],
+        relatedTools: ['n8n_get_workflow', 'n8n_validate_workflow_connections', 'n8n_get_workflow_minimal', 'validate_workflow_connections']
+    }
+};
+//# sourceMappingURL=n8n-get-workflow-structure.js.map

package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-structure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-get-workflow-structure.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-get-workflow-structure.ts"],"names":[],"mappings":";;;AAEa,QAAA,0BAA0B,GAAsB;IAC3D,IAAI,EAAE,4BAA4B;IAClC,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,2EAA2E;QACxF,aAAa,EAAE,CAAC,IAAI,CAAC;QACrB,OAAO,EAAE,kDAAkD;QAC3D,WAAW,EAAE,iBAAiB;QAC9B,IAAI,EAAE;YACJ,yBAAyB;YACzB,+BAA+B;YAC/B,2BAA2B;SAC5B;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,qRAAqR;QAClS,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uCAAuC,EAAE;SAC7F;QACD,OAAO,EAAE,4JAA4J;QACrK,QAAQ,EAAE;YACR,iEAAiE;YACjE,qFAAqF;SACtF;QACD,QAAQ,EAAE;YACR,kCAAkC;YAClC,6BAA6B;YAC7B,+BAA+B;YAC/B,0BAA0B;YAC1B,2BAA2B;SAC5B;QACD,WAAW,EAAE,2FAA2F;QACxG,aAAa,EAAE;YACb,6BAA6B;YAC7B,6BAA6B;YAC7B,gCAAgC;YAChC,gCAAgC;SACjC;QACD,QAAQ,EAAE;YACR,iDAAiD;YACjD,qCAAqC;YACrC,+BAA+B;YAC/B,mCAAmC;SACpC;QACD,YAAY,EAAE,CAAC,kBAAkB,EAAE,mCAAmC,EAAE,0BAA0B,EAAE,+BAA+B,CAAC;KACrI;CACF,CAAC"}

package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow.d.ts

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

package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow.d.ts.map

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

package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.n8nGetWorkflowDoc = void 0;
+exports.n8nGetWorkflowDoc = {
+    name: 'n8n_get_workflow',
+    category: 'workflow_management',
+    essentials: {
+        description: 'Get a workflow by ID. Returns the complete workflow including nodes, connections, and settings.',
+        keyParameters: ['id'],
+        example: 'n8n_get_workflow({id: "workflow_123"})',
+        performance: 'Fast (50-200ms)',
+        tips: [
+            'Returns complete workflow JSON',
+            'Includes all node parameters',
+            'Use get_workflow_minimal for faster listings'
+        ]
+    },
+    full: {
+        description: 'Retrieves a complete workflow from n8n by its ID. Returns full workflow definition including all nodes with their parameters, connections between nodes, and workflow settings. This is the primary tool for fetching workflows for viewing, editing, or cloning.',
+        parameters: {
+            id: { type: 'string', required: true, description: 'Workflow ID to retrieve' }
+        },
+        returns: 'Complete workflow object containing: id, name, active status, nodes array (with full parameters), connections object, settings, createdAt, updatedAt',
+        examples: [
+            'n8n_get_workflow({id: "abc123"}) - Get workflow for editing',
+            'const wf = n8n_get_workflow({id: "xyz789"}); // Clone workflow structure'
+        ],
+        useCases: [
+            'View workflow configuration',
+            'Export workflow for backup',
+            'Clone workflow structure',
+            'Debug workflow issues',
+            'Prepare for updates'
+        ],
+        performance: 'Fast retrieval - typically 50-200ms depending on workflow size. Cached by n8n for performance.',
+        bestPractices: [
+            'Check workflow exists before updating',
+            'Use for complete workflow data needs',
+            'Cache results when making multiple operations',
+            'Validate after retrieving if modifying'
+        ],
+        pitfalls: [
+            'Requires N8N_API_URL and N8N_API_KEY configured',
+            'Returns all data - use minimal/structure for performance',
+            'Workflow must exist or returns 404',
+            'Credentials are referenced but not included'
+        ],
+        relatedTools: ['n8n_get_workflow_minimal', 'n8n_get_workflow_structure', 'n8n_update_full_workflow', 'n8n_validate_workflow']
+    }
+};
+//# sourceMappingURL=n8n-get-workflow.js.map

package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-get-workflow.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-get-workflow.ts"],"names":[],"mappings":";;;AAEa,QAAA,iBAAiB,GAAsB;IAClD,IAAI,EAAE,kBAAkB;IACxB,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,iGAAiG;QAC9G,aAAa,EAAE,CAAC,IAAI,CAAC;QACrB,OAAO,EAAE,wCAAwC;QACjD,WAAW,EAAE,iBAAiB;QAC9B,IAAI,EAAE;YACJ,gCAAgC;YAChC,8BAA8B;YAC9B,8CAA8C;SAC/C;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,mQAAmQ;QAChR,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,yBAAyB,EAAE;SAC/E;QACD,OAAO,EAAE,sJAAsJ;QAC/J,QAAQ,EAAE;YACR,6DAA6D;YAC7D,0EAA0E;SAC3E;QACD,QAAQ,EAAE;YACR,6BAA6B;YAC7B,4BAA4B;YAC5B,0BAA0B;YAC1B,uBAAuB;YACvB,qBAAqB;SACtB;QACD,WAAW,EAAE,gGAAgG;QAC7G,aAAa,EAAE;YACb,uCAAuC;YACvC,sCAAsC;YACtC,+CAA+C;YAC/C,wCAAwC;SACzC;QACD,QAAQ,EAAE;YACR,iDAAiD;YACjD,0DAA0D;YAC1D,oCAAoC;YACpC,6CAA6C;SAC9C;QACD,YAAY,EAAE,CAAC,0BAA0B,EAAE,4BAA4B,EAAE,0BAA0B,EAAE,uBAAuB,CAAC;KAC9H;CACF,CAAC"}

package/dist/mcp/tool-docs/workflow_management/n8n-list-executions.d.ts

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

package/dist/mcp/tool-docs/workflow_management/n8n-list-executions.d.ts.map

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

package/dist/mcp/tool-docs/workflow_management/n8n-list-executions.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.n8nListExecutionsDoc = void 0;
+exports.n8nListExecutionsDoc = {
+    name: 'n8n_list_executions',
+    category: 'workflow_management',
+    essentials: {
+        description: 'List workflow executions with optional filters. Supports pagination for large result sets.',
+        keyParameters: ['workflowId', 'status', 'limit'],
+        example: 'n8n_list_executions({workflowId: "abc123", status: "error"})',
+        performance: 'Fast metadata retrieval, use pagination for large datasets',
+        tips: [
+            'Filter by status (success/error/waiting) to find specific execution types',
+            'Use workflowId to see all executions for a specific workflow',
+            'Pagination via cursor allows retrieving large execution histories'
+        ]
+    },
+    full: {
+        description: `Lists workflow executions with powerful filtering options. This tool is essential for monitoring workflow performance, finding failed executions, and tracking workflow activity. Supports pagination for retrieving large execution histories and filtering by workflow, status, and project.`,
+        parameters: {
+            limit: {
+                type: 'number',
+                required: false,
+                description: 'Number of executions to return (1-100, default: 100). Use with cursor for pagination'
+            },
+            cursor: {
+                type: 'string',
+                required: false,
+                description: 'Pagination cursor from previous response. Used to retrieve next page of results'
+            },
+            workflowId: {
+                type: 'string',
+                required: false,
+                description: 'Filter executions by specific workflow ID. Shows all executions for that workflow'
+            },
+            projectId: {
+                type: 'string',
+                required: false,
+                description: 'Filter by project ID (enterprise feature). Groups executions by project'
+            },
+            status: {
+                type: 'string',
+                required: false,
+                enum: ['success', 'error', 'waiting'],
+                description: 'Filter by execution status. Success = completed, Error = failed, Waiting = running'
+            },
+            includeData: {
+                type: 'boolean',
+                required: false,
+                description: 'Include execution data in results (default: false). Significantly increases response size'
+            }
+        },
+        returns: `Array of execution objects with metadata, pagination cursor for next page, and optionally execution data. Each execution includes ID, status, start/end times, and workflow reference.`,
+        examples: [
+            'n8n_list_executions({limit: 10}) - Get 10 most recent executions',
+            'n8n_list_executions({workflowId: "abc123"}) - All executions for specific workflow',
+            'n8n_list_executions({status: "error", limit: 50}) - Find failed executions',
+            'n8n_list_executions({status: "waiting"}) - Monitor currently running workflows',
+            'n8n_list_executions({cursor: "next-page-token"}) - Get next page of results'
+        ],
+        useCases: [
+            'Monitor workflow execution history and patterns',
+            'Find and debug failed workflow executions',
+            'Track currently running workflows (waiting status)',
+            'Analyze workflow performance and execution frequency',
+            'Generate execution reports for specific workflows'
+        ],
+        performance: `Listing executions is fast for metadata only. Including data (includeData: true) significantly impacts performance. Use pagination (limit + cursor) for large result sets. Default limit of 100 balances performance with usability.`,
+        bestPractices: [
+            'Use status filters to focus on specific execution types',
+            'Implement pagination for large execution histories',
+            'Avoid includeData unless you need execution details',
+            'Filter by workflowId when monitoring specific workflows',
+            'Check for cursor in response to detect more pages'
+        ],
+        pitfalls: [
+            'Large limits with includeData can cause timeouts',
+            'Execution retention depends on n8n configuration',
+            'Cursor tokens expire - use them promptly',
+            'Status "waiting" includes both running and queued executions',
+            'Deleted workflows still show in execution history'
+        ],
+        relatedTools: ['n8n_get_execution', 'n8n_trigger_webhook_workflow', 'n8n_delete_execution', 'n8n_list_workflows']
+    }
+};
+//# sourceMappingURL=n8n-list-executions.js.map

package/dist/mcp/tool-docs/workflow_management/n8n-list-executions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-list-executions.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-list-executions.ts"],"names":[],"mappings":";;;AAEa,QAAA,oBAAoB,GAAsB;IACrD,IAAI,EAAE,qBAAqB;IAC3B,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,4FAA4F;QACzG,aAAa,EAAE,CAAC,YAAY,EAAE,QAAQ,EAAE,OAAO,CAAC;QAChD,OAAO,EAAE,8DAA8D;QACvE,WAAW,EAAE,4DAA4D;QACzE,IAAI,EAAE;YACJ,2EAA2E;YAC3E,8DAA8D;YAC9D,mEAAmE;SACpE;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,gSAAgS;QAC7S,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,sFAAsF;aACpG;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,iFAAiF;aAC/F;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,mFAAmF;aACjG;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,yEAAyE;aACvF;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,IAAI,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC;gBACrC,WAAW,EAAE,oFAAoF;aAClG;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,2FAA2F;aACzG;SACF;QACD,OAAO,EAAE,wLAAwL;QACjM,QAAQ,EAAE;YACR,kEAAkE;YAClE,oFAAoF;YACpF,4EAA4E;YAC5E,gFAAgF;YAChF,6EAA6E;SAC9E;QACD,QAAQ,EAAE;YACR,iDAAiD;YACjD,2CAA2C;YAC3C,oDAAoD;YACpD,sDAAsD;YACtD,mDAAmD;SACpD;QACD,WAAW,EAAE,sOAAsO;QACnP,aAAa,EAAE;YACb,yDAAyD;YACzD,oDAAoD;YACpD,qDAAqD;YACrD,yDAAyD;YACzD,mDAAmD;SACpD;QACD,QAAQ,EAAE;YACR,kDAAkD;YAClD,kDAAkD;YAClD,0CAA0C;YAC1C,8DAA8D;YAC9D,mDAAmD;SACpD;QACD,YAAY,EAAE,CAAC,mBAAmB,EAAE,8BAA8B,EAAE,sBAAsB,EAAE,oBAAoB,CAAC;KAClH;CACF,CAAC"}

package/dist/mcp/tool-docs/workflow_management/n8n-list-workflows.d.ts

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

package/dist/mcp/tool-docs/workflow_management/n8n-list-workflows.d.ts.map

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

package/dist/mcp/tool-docs/workflow_management/n8n-list-workflows.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.n8nListWorkflowsDoc = void 0;
+exports.n8nListWorkflowsDoc = {
+    name: 'n8n_list_workflows',
+    category: 'workflow_management',
+    essentials: {
+        description: 'List workflows (minimal metadata only - no nodes/connections). Supports pagination via cursor.',
+        keyParameters: ['limit', 'active', 'tags'],
+        example: 'n8n_list_workflows({limit: 20, active: true})',
+        performance: 'Fast (100-300ms)',
+        tips: [
+            'Use cursor for pagination',
+            'Filter by active status',
+            'Tag filtering for organization'
+        ]
+    },
+    full: {
+        description: 'Lists workflows from n8n with powerful filtering options. Returns ONLY minimal metadata (id, name, active, dates, tags, nodeCount) - no workflow structure, nodes, or connections. Use n8n_get_workflow to fetch full workflow details.',
+        parameters: {
+            limit: { type: 'number', description: 'Number of workflows to return (1-100, default: 100)' },
+            cursor: { type: 'string', description: 'Pagination cursor from previous response for next page' },
+            active: { type: 'boolean', description: 'Filter by active/inactive status' },
+            tags: { type: 'array', description: 'Filter by exact tag matches (AND logic)' },
+            projectId: { type: 'string', description: 'Filter by project ID (enterprise feature)' },
+            excludePinnedData: { type: 'boolean', description: 'Exclude pinned data from response (default: true)' }
+        },
+        returns: 'Object with: workflows array (minimal fields: id, name, active, createdAt, updatedAt, tags, nodeCount), returned (count in this response), hasMore (boolean), nextCursor (for pagination), and _note (guidance when more data exists)',
+        examples: [
+            'n8n_list_workflows({limit: 20}) - First 20 workflows',
+            'n8n_list_workflows({active: true, tags: ["production"]}) - Active production workflows',
+            'n8n_list_workflows({cursor: "abc123", limit: 50}) - Next page of results'
+        ],
+        useCases: [
+            'Build workflow dashboards',
+            'Find workflows by status',
+            'Organize by tags',
+            'Bulk workflow operations',
+            'Generate workflow reports'
+        ],
+        performance: 'Very fast - typically 50-200ms. Returns only minimal metadata without workflow structure.',
+        bestPractices: [
+            'Always check hasMore flag to determine if pagination is needed',
+            'Use cursor from previous response to get next page',
+            'The returned count is NOT the total in the system',
+            'Iterate with cursor until hasMore is false for complete list'
+        ],
+        pitfalls: [
+            'Requires N8N_API_URL and N8N_API_KEY configured',
+            'Maximum 100 workflows per request',
+            'Server may return fewer than requested limit',
+            'returned field is count of current page only, not system total'
+        ],
+        relatedTools: ['n8n_get_workflow_minimal', 'n8n_get_workflow', 'n8n_update_partial_workflow', 'n8n_list_executions']
+    }
+};
+//# sourceMappingURL=n8n-list-workflows.js.map

package/dist/mcp/tool-docs/workflow_management/n8n-list-workflows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-list-workflows.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-list-workflows.ts"],"names":[],"mappings":";;;AAEa,QAAA,mBAAmB,GAAsB;IACpD,IAAI,EAAE,oBAAoB;IAC1B,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,gGAAgG;QAC7G,aAAa,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC;QAC1C,OAAO,EAAE,+CAA+C;QACxD,WAAW,EAAE,kBAAkB;QAC/B,IAAI,EAAE;YACJ,2BAA2B;YAC3B,yBAAyB;YACzB,gCAAgC;SACjC;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,yOAAyO;QACtP,UAAU,EAAE;YACV,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,qDAAqD,EAAE;YAC7F,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wDAAwD,EAAE;YACjG,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,kCAAkC,EAAE;YAC5E,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,yCAAyC,EAAE;YAC/E,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2CAA2C,EAAE;YACvF,iBAAiB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,mDAAmD,EAAE;SACzG;QACD,OAAO,EAAE,uOAAuO;QAChP,QAAQ,EAAE;YACR,sDAAsD;YACtD,wFAAwF;YACxF,0EAA0E;SAC3E;QACD,QAAQ,EAAE;YACR,2BAA2B;YAC3B,0BAA0B;YAC1B,kBAAkB;YAClB,0BAA0B;YAC1B,2BAA2B;SAC5B;QACD,WAAW,EAAE,2FAA2F;QACxG,aAAa,EAAE;YACb,gEAAgE;YAChE,oDAAoD;YACpD,mDAAmD;YACnD,8DAA8D;SAC/D;QACD,QAAQ,EAAE;YACR,iDAAiD;YACjD,mCAAmC;YACnC,8CAA8C;YAC9C,gEAAgE;SACjE;QACD,YAAY,EAAE,CAAC,0BAA0B,EAAE,kBAAkB,EAAE,6BAA6B,EAAE,qBAAqB,CAAC;KACrH;CACF,CAAC"}

package/dist/mcp/tool-docs/workflow_management/n8n-trigger-webhook-workflow.d.ts

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

package/dist/mcp/tool-docs/workflow_management/n8n-trigger-webhook-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-trigger-webhook-workflow.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-trigger-webhook-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,4BAA4B,EAAE,iBA2E1C,CAAC"}

package/dist/mcp/tool-docs/workflow_management/n8n-trigger-webhook-workflow.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.n8nTriggerWebhookWorkflowDoc = void 0;
+exports.n8nTriggerWebhookWorkflowDoc = {
+    name: 'n8n_trigger_webhook_workflow',
+    category: 'workflow_management',
+    essentials: {
+        description: 'Trigger workflow via webhook. Must be ACTIVE with Webhook node. Method must match config.',
+        keyParameters: ['webhookUrl', 'httpMethod', 'data'],
+        example: 'n8n_trigger_webhook_workflow({webhookUrl: "https://n8n.example.com/webhook/abc-def-ghi"})',
+        performance: 'Immediate trigger, response time depends on workflow complexity',
+        tips: [
+            'Workflow MUST be active and contain a Webhook node for triggering',
+            'HTTP method must match webhook node configuration (often GET)',
+            'Use waitForResponse:false for async execution without waiting'
+        ]
+    },
+    full: {
+        description: `Triggers a workflow execution via its webhook URL. This is the primary method for external systems to start n8n workflows. The target workflow must be active and contain a properly configured Webhook node as the trigger. The HTTP method used must match the webhook configuration.`,
+        parameters: {
+            webhookUrl: {
+                type: 'string',
+                required: true,
+                description: 'Full webhook URL from n8n workflow (e.g., https://n8n.example.com/webhook/abc-def-ghi)'
+            },
+            httpMethod: {
+                type: 'string',
+                required: false,
+                enum: ['GET', 'POST', 'PUT', 'DELETE'],
+                description: 'HTTP method (must match webhook configuration, often GET). Defaults to GET if not specified'
+            },
+            data: {
+                type: 'object',
+                required: false,
+                description: 'Data to send with the webhook request. For GET requests, becomes query parameters'
+            },
+            headers: {
+                type: 'object',
+                required: false,
+                description: 'Additional HTTP headers to include in the request'
+            },
+            waitForResponse: {
+                type: 'boolean',
+                required: false,
+                description: 'Wait for workflow completion and return results (default: true). Set to false for fire-and-forget'
+            }
+        },
+        returns: `Webhook response data if waitForResponse is true, or immediate acknowledgment if false. Response format depends on webhook node configuration.`,
+        examples: [
+            'n8n_trigger_webhook_workflow({webhookUrl: "https://n8n.example.com/webhook/order-process"}) - Trigger with GET',
+            'n8n_trigger_webhook_workflow({webhookUrl: "https://n8n.example.com/webhook/data-import", httpMethod: "POST", data: {name: "John", email: "john@example.com"}}) - POST with data',
+            'n8n_trigger_webhook_workflow({webhookUrl: "https://n8n.example.com/webhook/async-job", waitForResponse: false}) - Fire and forget',
+            'n8n_trigger_webhook_workflow({webhookUrl: "https://n8n.example.com/webhook/api", headers: {"API-Key": "secret"}}) - With auth headers'
+        ],
+        useCases: [
+            'Trigger data processing workflows from external applications',
+            'Start scheduled jobs manually via webhook',
+            'Integrate n8n workflows with third-party services',
+            'Create REST API endpoints using n8n workflows',
+            'Implement event-driven architectures with n8n'
+        ],
+        performance: `Performance varies based on workflow complexity and waitForResponse setting. Synchronous calls (waitForResponse: true) block until workflow completes. For long-running workflows, use async mode (waitForResponse: false) and monitor execution separately.`,
+        bestPractices: [
+            'Always verify workflow is active before attempting webhook triggers',
+            'Match HTTP method exactly with webhook node configuration',
+            'Use async mode (waitForResponse: false) for long-running workflows',
+            'Include authentication headers when webhook requires them',
+            'Test webhook URL manually first to ensure it works'
+        ],
+        pitfalls: [
+            'Workflow must be ACTIVE - inactive workflows cannot be triggered',
+            'HTTP method mismatch returns 404 even if URL is correct',
+            'Webhook node must be the trigger node in the workflow',
+            'Timeout errors occur with long workflows in sync mode',
+            'Data format must match webhook node expectations'
+        ],
+        relatedTools: ['n8n_get_execution', 'n8n_list_executions', 'n8n_get_workflow', 'n8n_create_workflow']
+    }
+};
+//# sourceMappingURL=n8n-trigger-webhook-workflow.js.map

package/dist/mcp/tool-docs/workflow_management/n8n-trigger-webhook-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-trigger-webhook-workflow.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-trigger-webhook-workflow.ts"],"names":[],"mappings":";;;AAEa,QAAA,4BAA4B,GAAsB;IAC7D,IAAI,EAAE,8BAA8B;IACpC,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,2FAA2F;QACxG,aAAa,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,MAAM,CAAC;QACnD,OAAO,EAAE,2FAA2F;QACpG,WAAW,EAAE,iEAAiE;QAC9E,IAAI,EAAE;YACJ,mEAAmE;YACnE,+DAA+D;YAC/D,+DAA+D;SAChE;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,yRAAyR;QACtS,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,wFAAwF;aACtG;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC;gBACtC,WAAW,EAAE,6FAA6F;aAC3G;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,mFAAmF;aACjG;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,mDAAmD;aACjE;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,mGAAmG;aACjH;SACF;QACD,OAAO,EAAE,gJAAgJ;QACzJ,QAAQ,EAAE;YACR,gHAAgH;YAChH,iLAAiL;YACjL,mIAAmI;YACnI,uIAAuI;SACxI;QACD,QAAQ,EAAE;YACR,8DAA8D;YAC9D,2CAA2C;YAC3C,mDAAmD;YACnD,+CAA+C;YAC/C,+CAA+C;SAChD;QACD,WAAW,EAAE,8PAA8P;QAC3Q,aAAa,EAAE;YACb,qEAAqE;YACrE,2DAA2D;YAC3D,oEAAoE;YACpE,2DAA2D;YAC3D,oDAAoD;SACrD;QACD,QAAQ,EAAE;YACR,kEAAkE;YAClE,yDAAyD;YACzD,uDAAuD;YACvD,uDAAuD;YACvD,kDAAkD;SACnD;QACD,YAAY,EAAE,CAAC,mBAAmB,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,qBAAqB,CAAC;KACtG;CACF,CAAC"}

package/dist/mcp/tool-docs/workflow_management/n8n-update-full-workflow.d.ts

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

package/dist/mcp/tool-docs/workflow_management/n8n-update-full-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-update-full-workflow.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-update-full-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,wBAAwB,EAAE,iBAoDtC,CAAC"}

package/dist/mcp/tool-docs/workflow_management/n8n-update-full-workflow.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.n8nUpdateFullWorkflowDoc = void 0;
+exports.n8nUpdateFullWorkflowDoc = {
+    name: 'n8n_update_full_workflow',
+    category: 'workflow_management',
+    essentials: {
+        description: 'Full workflow update. Requires complete nodes[] and connections{}. For incremental use n8n_update_partial_workflow.',
+        keyParameters: ['id', 'nodes', 'connections'],
+        example: 'n8n_update_full_workflow({id: "wf_123", nodes: [...], connections: {...}})',
+        performance: 'Network-dependent',
+        tips: [
+            'Must provide complete workflow',
+            'Use update_partial for small changes',
+            'Validate before updating'
+        ]
+    },
+    full: {
+        description: 'Performs a complete workflow update by replacing the entire workflow definition. Requires providing the complete nodes array and connections object, even for small changes. This is a full replacement operation - any nodes or connections not included will be removed.',
+        parameters: {
+            id: { type: 'string', required: true, description: 'Workflow ID to update' },
+            name: { type: 'string', description: 'New workflow name (optional)' },
+            nodes: { type: 'array', description: 'Complete array of workflow nodes (required if modifying structure)' },
+            connections: { type: 'object', description: 'Complete connections object (required if modifying structure)' },
+            settings: { type: 'object', description: 'Workflow settings to update (timezone, error handling, etc.)' }
+        },
+        returns: 'Updated workflow object with all fields including the changes applied',
+        examples: [
+            'n8n_update_full_workflow({id: "abc", name: "New Name"}) - Rename only',
+            'n8n_update_full_workflow({id: "xyz", nodes: [...], connections: {...}}) - Full structure update',
+            'const wf = n8n_get_workflow({id}); wf.nodes.push(newNode); n8n_update_full_workflow(wf); // Add node'
+        ],
+        useCases: [
+            'Major workflow restructuring',
+            'Bulk node updates',
+            'Workflow imports/cloning',
+            'Complete workflow replacement',
+            'Settings changes'
+        ],
+        performance: 'Network-dependent - typically 200-500ms. Larger workflows take longer. Consider update_partial for better performance.',
+        bestPractices: [
+            'Get workflow first, modify, then update',
+            'Validate with validate_workflow before updating',
+            'Use update_partial for small changes',
+            'Test updates in non-production first'
+        ],
+        pitfalls: [
+            'Requires N8N_API_URL and N8N_API_KEY configured',
+            'Must include ALL nodes/connections',
+            'Missing nodes will be deleted',
+            'Can break active workflows',
+            'No partial updates - use update_partial instead'
+        ],
+        relatedTools: ['n8n_get_workflow', 'n8n_update_partial_workflow', 'validate_workflow', 'n8n_create_workflow']
+    }
+};
+//# sourceMappingURL=n8n-update-full-workflow.js.map

package/dist/mcp/tool-docs/workflow_management/n8n-update-full-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-update-full-workflow.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-update-full-workflow.ts"],"names":[],"mappings":";;;AAEa,QAAA,wBAAwB,GAAsB;IACzD,IAAI,EAAE,0BAA0B;IAChC,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,qHAAqH;QAClI,aAAa,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,aAAa,CAAC;QAC7C,OAAO,EAAE,4EAA4E;QACrF,WAAW,EAAE,mBAAmB;QAChC,IAAI,EAAE;YACJ,gCAAgC;YAChC,sCAAsC;YACtC,0BAA0B;SAC3B;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,4QAA4Q;QACzR,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uBAAuB,EAAE;YAC5E,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8BAA8B,EAAE;YACrE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,oEAAoE,EAAE;YAC3G,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+DAA+D,EAAE;YAC7G,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,8DAA8D,EAAE;SAC1G;QACD,OAAO,EAAE,uEAAuE;QAChF,QAAQ,EAAE;YACR,uEAAuE;YACvE,iGAAiG;YACjG,sGAAsG;SACvG;QACD,QAAQ,EAAE;YACR,8BAA8B;YAC9B,mBAAmB;YACnB,0BAA0B;YAC1B,+BAA+B;YAC/B,kBAAkB;SACnB;QACD,WAAW,EAAE,wHAAwH;QACrI,aAAa,EAAE;YACb,yCAAyC;YACzC,iDAAiD;YACjD,sCAAsC;YACtC,sCAAsC;SACvC;QACD,QAAQ,EAAE;YACR,iDAAiD;YACjD,oCAAoC;YACpC,+BAA+B;YAC/B,4BAA4B;YAC5B,iDAAiD;SAClD;QACD,YAAY,EAAE,CAAC,kBAAkB,EAAE,6BAA6B,EAAE,mBAAmB,EAAE,qBAAqB,CAAC;KAC9G;CACF,CAAC"}

package/dist/mcp/tool-docs/workflow_management/n8n-update-partial-workflow.d.ts

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

package/dist/mcp/tool-docs/workflow_management/n8n-update-partial-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-update-partial-workflow.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-update-partial-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,2BAA2B,EAAE,iBA6EzC,CAAC"}