n8n-mcp 2.7.14 → 2.7.17

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

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.n8nDeleteWorkflowDoc = void 0;
+exports.n8nDeleteWorkflowDoc = {
+    name: 'n8n_delete_workflow',
+    category: 'workflow_management',
+    essentials: {
+        description: 'Permanently delete a workflow. This action cannot be undone.',
+        keyParameters: ['id'],
+        example: 'n8n_delete_workflow({id: "workflow_123"})',
+        performance: 'Fast (50-150ms)',
+        tips: [
+            'Action is irreversible',
+            'Deletes all execution history',
+            'Check workflow first with get_minimal'
+        ]
+    },
+    full: {
+        description: 'Permanently deletes a workflow from n8n including all associated data, execution history, and settings. This is an irreversible operation that should be used with caution. The workflow must exist and the user must have appropriate permissions.',
+        parameters: {
+            id: { type: 'string', required: true, description: 'Workflow ID to delete permanently' }
+        },
+        returns: 'Success confirmation or error if workflow not found/cannot be deleted',
+        examples: [
+            'n8n_delete_workflow({id: "abc123"}) - Delete specific workflow',
+            'if (confirm) { n8n_delete_workflow({id: wf.id}); } // With confirmation'
+        ],
+        useCases: [
+            'Remove obsolete workflows',
+            'Clean up test workflows',
+            'Delete failed experiments',
+            'Manage workflow limits',
+            'Remove duplicates'
+        ],
+        performance: 'Fast operation - typically 50-150ms. May take longer if workflow has extensive execution history.',
+        bestPractices: [
+            'Always confirm before deletion',
+            'Check workflow with get_minimal first',
+            'Consider deactivating instead of deleting',
+            'Export workflow before deletion for backup'
+        ],
+        pitfalls: [
+            'Requires N8N_API_URL and N8N_API_KEY configured',
+            'Cannot be undone - permanent deletion',
+            'Deletes all execution history',
+            'Active workflows can be deleted',
+            'No built-in confirmation'
+        ],
+        relatedTools: ['n8n_get_workflow_minimal', 'n8n_list_workflows', 'n8n_update_partial_workflow', 'n8n_delete_execution']
+    }
+};
+//# sourceMappingURL=n8n-delete-workflow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-delete-workflow.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-delete-workflow.ts"],"names":[],"mappings":";;;AAEa,QAAA,oBAAoB,GAAsB;IACrD,IAAI,EAAE,qBAAqB;IAC3B,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,8DAA8D;QAC3E,aAAa,EAAE,CAAC,IAAI,CAAC;QACrB,OAAO,EAAE,2CAA2C;QACpD,WAAW,EAAE,iBAAiB;QAC9B,IAAI,EAAE;YACJ,wBAAwB;YACxB,+BAA+B;YAC/B,uCAAuC;SACxC;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,qPAAqP;QAClQ,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,mCAAmC,EAAE;SACzF;QACD,OAAO,EAAE,uEAAuE;QAChF,QAAQ,EAAE;YACR,gEAAgE;YAChE,yEAAyE;SAC1E;QACD,QAAQ,EAAE;YACR,2BAA2B;YAC3B,yBAAyB;YACzB,2BAA2B;YAC3B,wBAAwB;YACxB,mBAAmB;SACpB;QACD,WAAW,EAAE,mGAAmG;QAChH,aAAa,EAAE;YACb,gCAAgC;YAChC,uCAAuC;YACvC,2CAA2C;YAC3C,4CAA4C;SAC7C;QACD,QAAQ,EAAE;YACR,iDAAiD;YACjD,uCAAuC;YACvC,+BAA+B;YAC/B,iCAAiC;YACjC,0BAA0B;SAC3B;QACD,YAAY,EAAE,CAAC,0BAA0B,EAAE,oBAAoB,EAAE,6BAA6B,EAAE,sBAAsB,CAAC;KACxH;CACF,CAAC"}

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

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

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

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

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

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.n8nGetExecutionDoc = void 0;
+exports.n8nGetExecutionDoc = {
+    name: 'n8n_get_execution',
+    category: 'workflow_management',
+    essentials: {
+        description: 'Get details of a specific execution by ID, including status, timing, and error information.',
+        keyParameters: ['id', 'includeData'],
+        example: 'n8n_get_execution({id: "12345"})',
+        performance: 'Fast lookup, data inclusion may increase response size significantly',
+        tips: [
+            'Use includeData:true to see full execution data and node outputs',
+            'Execution IDs come from list_executions or webhook responses',
+            'Check status field for success/error/waiting states'
+        ]
+    },
+    full: {
+        description: `Retrieves detailed information about a specific workflow execution. This tool is essential for monitoring workflow runs, debugging failures, and accessing execution results. Returns execution metadata by default, with optional full data inclusion for complete visibility into node inputs/outputs.`,
+        parameters: {
+            id: {
+                type: 'string',
+                required: true,
+                description: 'The execution ID to retrieve. Obtained from list_executions or webhook trigger responses'
+            },
+            includeData: {
+                type: 'boolean',
+                required: false,
+                description: 'Include full execution data with node inputs/outputs (default: false). Significantly increases response size'
+            }
+        },
+        returns: `Execution object containing status, timing, error details, and optionally full execution data with all node inputs/outputs.`,
+        examples: [
+            'n8n_get_execution({id: "12345"}) - Get execution summary only',
+            'n8n_get_execution({id: "12345", includeData: true}) - Get full execution with all data',
+            'n8n_get_execution({id: "67890"}) - Check status of a running execution',
+            'n8n_get_execution({id: "failed-123", includeData: true}) - Debug failed execution with error details'
+        ],
+        useCases: [
+            'Monitor status of triggered workflow executions',
+            'Debug failed workflows by examining error messages',
+            'Access execution results and node output data',
+            'Track execution duration and performance metrics',
+            'Verify successful completion of critical workflows'
+        ],
+        performance: `Metadata retrieval is fast (< 100ms). Including full data (includeData: true) can significantly increase response time and size, especially for workflows processing large datasets. Use data inclusion judiciously.`,
+        bestPractices: [
+            'Start with includeData:false to check status first',
+            'Only include data when you need to see node outputs',
+            'Store execution IDs from trigger responses for tracking',
+            'Check status field to determine if execution completed',
+            'Use error field to diagnose execution failures'
+        ],
+        pitfalls: [
+            'Large executions with includeData:true can timeout or exceed limits',
+            'Execution data is retained based on n8n settings - old executions may be purged',
+            'Waiting status indicates execution is still running',
+            'Error executions may have partial data from successful nodes',
+            'Execution IDs are unique per n8n instance'
+        ],
+        relatedTools: ['n8n_list_executions', 'n8n_trigger_webhook_workflow', 'n8n_delete_execution', 'n8n_get_workflow']
+    }
+};
+//# sourceMappingURL=n8n-get-execution.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-get-execution.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-get-execution.ts"],"names":[],"mappings":";;;AAEa,QAAA,kBAAkB,GAAsB;IACnD,IAAI,EAAE,mBAAmB;IACzB,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,6FAA6F;QAC1G,aAAa,EAAE,CAAC,IAAI,EAAE,aAAa,CAAC;QACpC,OAAO,EAAE,kCAAkC;QAC3C,WAAW,EAAE,sEAAsE;QACnF,IAAI,EAAE;YACJ,kEAAkE;YAClE,8DAA8D;YAC9D,qDAAqD;SACtD;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,0SAA0S;QACvT,UAAU,EAAE;YACV,EAAE,EAAE;gBACF,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,0FAA0F;aACxG;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,8GAA8G;aAC5H;SACF;QACD,OAAO,EAAE,6HAA6H;QACtI,QAAQ,EAAE;YACR,+DAA+D;YAC/D,wFAAwF;YACxF,wEAAwE;YACxE,sGAAsG;SACvG;QACD,QAAQ,EAAE;YACR,iDAAiD;YACjD,oDAAoD;YACpD,+CAA+C;YAC/C,kDAAkD;YAClD,oDAAoD;SACrD;QACD,WAAW,EAAE,sNAAsN;QACnO,aAAa,EAAE;YACb,oDAAoD;YACpD,qDAAqD;YACrD,yDAAyD;YACzD,wDAAwD;YACxD,gDAAgD;SACjD;QACD,QAAQ,EAAE;YACR,qEAAqE;YACrE,iFAAiF;YACjF,qDAAqD;YACrD,8DAA8D;YAC9D,2CAA2C;SAC5C;QACD,YAAY,EAAE,CAAC,qBAAqB,EAAE,8BAA8B,EAAE,sBAAsB,EAAE,kBAAkB,CAAC;KAClH;CACF,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-get-workflow-details.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-get-workflow-details.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-details.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.n8nGetWorkflowDetailsDoc = void 0;
+exports.n8nGetWorkflowDetailsDoc = {
+    name: 'n8n_get_workflow_details',
+    category: 'workflow_management',
+    essentials: {
+        description: 'Get workflow details with metadata, version, execution stats. More info than get_workflow.',
+        keyParameters: ['id'],
+        example: 'n8n_get_workflow_details({id: "workflow_123"})',
+        performance: 'Fast (100-300ms)',
+        tips: [
+            'Includes execution statistics',
+            'Shows version history info',
+            'Contains metadata like tags'
+        ]
+    },
+    full: {
+        description: 'Retrieves comprehensive workflow details including metadata, execution statistics, version information, and usage analytics. Provides more information than get_workflow, including data not typically needed for editing but useful for monitoring and analysis.',
+        parameters: {
+            id: { type: 'string', required: true, description: 'Workflow ID to retrieve details for' }
+        },
+        returns: 'Extended workflow object with: id, name, nodes, connections, settings, plus metadata (tags, owner, shared users), execution stats (success/error counts, average runtime), version info, created/updated timestamps',
+        examples: [
+            'n8n_get_workflow_details({id: "abc123"}) - Get workflow with stats',
+            'const details = n8n_get_workflow_details({id: "xyz789"}); // Analyze performance'
+        ],
+        useCases: [
+            'Monitor workflow performance',
+            'Analyze execution patterns',
+            'View workflow metadata',
+            'Check version information',
+            'Audit workflow usage'
+        ],
+        performance: 'Slightly slower than get_workflow due to additional metadata - typically 100-300ms. Stats may be cached.',
+        bestPractices: [
+            'Use for monitoring and analysis',
+            'Check execution stats before optimization',
+            'Review error counts for debugging',
+            'Monitor average execution times'
+        ],
+        pitfalls: [
+            'Requires N8N_API_URL and N8N_API_KEY configured',
+            'More data than needed for simple edits',
+            'Stats may have slight delay',
+            'Not all n8n versions support all fields'
+        ],
+        relatedTools: ['n8n_get_workflow', 'n8n_list_executions', 'n8n_get_execution', 'n8n_list_workflows']
+    }
+};
+//# sourceMappingURL=n8n-get-workflow-details.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-get-workflow-details.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-get-workflow-details.ts"],"names":[],"mappings":";;;AAEa,QAAA,wBAAwB,GAAsB;IACzD,IAAI,EAAE,0BAA0B;IAChC,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,4FAA4F;QACzG,aAAa,EAAE,CAAC,IAAI,CAAC;QACrB,OAAO,EAAE,gDAAgD;QACzD,WAAW,EAAE,kBAAkB;QAC/B,IAAI,EAAE;YACJ,+BAA+B;YAC/B,4BAA4B;YAC5B,6BAA6B;SAC9B;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,qCAAqC,EAAE;SAC3F;QACD,OAAO,EAAE,qNAAqN;QAC9N,QAAQ,EAAE;YACR,oEAAoE;YACpE,kFAAkF;SACnF;QACD,QAAQ,EAAE;YACR,8BAA8B;YAC9B,4BAA4B;YAC5B,wBAAwB;YACxB,2BAA2B;YAC3B,sBAAsB;SACvB;QACD,WAAW,EAAE,0GAA0G;QACvH,aAAa,EAAE;YACb,iCAAiC;YACjC,2CAA2C;YAC3C,mCAAmC;YACnC,iCAAiC;SAClC;QACD,QAAQ,EAAE;YACR,iDAAiD;YACjD,wCAAwC;YACxC,6BAA6B;YAC7B,yCAAyC;SAC1C;QACD,YAAY,EAAE,CAAC,kBAAkB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,oBAAoB,CAAC;KACrG;CACF,CAAC"}

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 with optional filters. 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 including active status, tags, and project assignment. Supports cursor-based pagination for large workflow collections. Returns minimal workflow information by default for performance.',
+        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: data array (workflows with id, name, active, tags, dates), nextCursor (for pagination), and metadata (total count if available)',
+        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: 'Fast listing - typically 100-300ms for standard page sizes. Excludes workflow content for speed.',
+        bestPractices: [
+            'Use pagination for large instances',
+            'Cache results for UI responsiveness',
+            'Filter to reduce result set',
+            'Combine with get_workflow_minimal for details'
+        ],
+        pitfalls: [
+            'Requires N8N_API_URL and N8N_API_KEY configured',
+            'Maximum 100 workflows per request',
+            'Tags must match exactly (case-sensitive)',
+            'No workflow content in results'
+        ],
+        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,uEAAuE;QACpF,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,mPAAmP;QAChQ,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,8IAA8I;QACvJ,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,kGAAkG;QAC/G,aAAa,EAAE;YACb,oCAAoC;YACpC,qCAAqC;YACrC,6BAA6B;YAC7B,+CAA+C;SAChD;QACD,QAAQ,EAAE;YACR,iDAAiD;YACjD,mCAAmC;YACnC,0CAA0C;YAC1C,gCAAgC;SACjC;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"}