n8n-mcp 2.7.15 → 2.7.17

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"}

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"}

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

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.n8nUpdatePartialWorkflowDoc = void 0;
+exports.n8nUpdatePartialWorkflowDoc = {
+    name: 'n8n_update_partial_workflow',
+    category: 'workflow_management',
+    essentials: {
+        description: 'Update workflow incrementally with diff operations. Max 5 ops. Types: addNode, removeNode, updateNode, moveNode, enable/disableNode, addConnection, removeConnection, updateSettings, updateName, add/removeTag.',
+        keyParameters: ['id', 'operations'],
+        example: 'n8n_update_partial_workflow({id: "wf_123", operations: [{type: "updateNode", ...}]})',
+        performance: 'Fast (50-200ms)',
+        tips: [
+            'Use for targeted changes',
+            'Supports up to 5 operations',
+            'Validate with validateOnly first'
+        ]
+    },
+    full: {
+        description: `Updates workflows using surgical diff operations instead of full replacement. Supports 13 operation types for precise modifications. Operations are validated and applied atomically - all succeed or none are applied. Maximum 5 operations per call for safety.
+
+## Available Operations:
+
+### Node Operations (6 types):
+- **addNode**: Add a new node with name, type, and position (required)
+- **removeNode**: Remove a node by ID or name
+- **updateNode**: Update node properties using dot notation (e.g., 'parameters.url')
+- **moveNode**: Change node position [x, y]
+- **enableNode**: Enable a disabled node
+- **disableNode**: Disable an active node
+
+### Connection Operations (3 types):
+- **addConnection**: Connect nodes (source→target)
+- **removeConnection**: Remove connection between nodes
+- **updateConnection**: Modify connection properties
+
+### Metadata Operations (4 types):
+- **updateSettings**: Modify workflow settings
+- **updateName**: Rename the workflow
+- **addTag**: Add a workflow tag
+- **removeTag**: Remove a workflow tag`,
+        parameters: {
+            id: { type: 'string', required: true, description: 'Workflow ID to update' },
+            operations: {
+                type: 'array',
+                required: true,
+                description: 'Array of diff operations. Each must have "type" field and operation-specific properties. Max 5 operations. Nodes can be referenced by ID or name.'
+            },
+            validateOnly: { type: 'boolean', description: 'If true, only validate operations without applying them' }
+        },
+        returns: 'Updated workflow object or validation results if validateOnly=true',
+        examples: [
+            '// Update node parameter\nn8n_update_partial_workflow({id: "abc", operations: [{type: "updateNode", nodeName: "HTTP Request", changes: {"parameters.url": "https://api.example.com"}}]})',
+            '// Add connection between nodes\nn8n_update_partial_workflow({id: "xyz", operations: [{type: "addConnection", source: "Webhook", target: "Slack", sourceOutput: "main", targetInput: "main"}]})',
+            '// Multiple operations in one call\nn8n_update_partial_workflow({id: "123", operations: [\n  {type: "addNode", node: {name: "Transform", type: "n8n-nodes-base.code", position: [400, 300]}},\n  {type: "addConnection", source: "Webhook", target: "Transform"},\n  {type: "updateSettings", settings: {timezone: "America/New_York"}}\n]})',
+            '// Validate before applying\nn8n_update_partial_workflow({id: "456", operations: [{type: "removeNode", nodeName: "Old Process"}], validateOnly: true})'
+        ],
+        useCases: [
+            'Update single node parameters',
+            'Add/remove connections',
+            'Enable/disable nodes',
+            'Rename workflows or nodes',
+            'Manage tags efficiently'
+        ],
+        performance: 'Very fast - typically 50-200ms. Much faster than full updates as only changes are processed.',
+        bestPractices: [
+            'Use validateOnly to test operations',
+            'Group related changes in one call',
+            'Keep operations under 5 for clarity',
+            'Check operation order for dependencies'
+        ],
+        pitfalls: [
+            '**REQUIRES N8N_API_URL and N8N_API_KEY environment variables** - will not work without n8n API access',
+            'Maximum 5 operations per call - split larger updates',
+            'Operations validated together - all must be valid',
+            'Order matters for dependent operations (e.g., must add node before connecting to it)',
+            'Node references accept ID or name, but name must be unique',
+            'Dot notation for nested updates: use "parameters.url" not nested objects'
+        ],
+        relatedTools: ['n8n_update_full_workflow', 'n8n_get_workflow', 'validate_workflow', 'tools_documentation']
+    }
+};
+//# sourceMappingURL=n8n-update-partial-workflow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-update-partial-workflow.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-update-partial-workflow.ts"],"names":[],"mappings":";;;AAEa,QAAA,2BAA2B,GAAsB;IAC5D,IAAI,EAAE,6BAA6B;IACnC,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,kNAAkN;QAC/N,aAAa,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC;QACnC,OAAO,EAAE,sFAAsF;QAC/F,WAAW,EAAE,iBAAiB;QAC9B,IAAI,EAAE;YACJ,0BAA0B;YAC1B,6BAA6B;YAC7B,kCAAkC;SACnC;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;uCAqBsB;QACnC,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uBAAuB,EAAE;YAC5E,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,mJAAmJ;aACjK;YACD,YAAY,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,yDAAyD,EAAE;SAC1G;QACD,OAAO,EAAE,oEAAoE;QAC7E,QAAQ,EAAE;YACR,0LAA0L;YAC1L,iMAAiM;YACjM,8UAA8U;YAC9U,wJAAwJ;SACzJ;QACD,QAAQ,EAAE;YACR,+BAA+B;YAC/B,wBAAwB;YACxB,sBAAsB;YACtB,2BAA2B;YAC3B,yBAAyB;SAC1B;QACD,WAAW,EAAE,8FAA8F;QAC3G,aAAa,EAAE;YACb,qCAAqC;YACrC,mCAAmC;YACnC,qCAAqC;YACrC,wCAAwC;SACzC;QACD,QAAQ,EAAE;YACR,uGAAuG;YACvG,sDAAsD;YACtD,mDAAmD;YACnD,sFAAsF;YACtF,4DAA4D;YAC5D,0EAA0E;SAC3E;QACD,YAAY,EAAE,CAAC,0BAA0B,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,qBAAqB,CAAC;KAC3G;CACF,CAAC"}

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

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

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

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