n8n-mcp 2.7.14 → 2.7.17

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

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

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.n8nValidateWorkflowDoc = void 0;
+exports.n8nValidateWorkflowDoc = {
+    name: 'n8n_validate_workflow',
+    category: 'workflow_management',
+    essentials: {
+        description: 'Validate workflow from n8n instance by ID - checks nodes, connections, expressions, and returns errors/warnings',
+        keyParameters: ['id'],
+        example: 'n8n_validate_workflow({id: "wf_abc123"})',
+        performance: 'Network-dependent (100-500ms) - fetches and validates workflow',
+        tips: [
+            'Use options.profile to control validation strictness (minimal/runtime/ai-friendly/strict)',
+            'Validation includes node configs, connections, and n8n expression syntax',
+            'Returns categorized errors, warnings, and actionable fix suggestions'
+        ]
+    },
+    full: {
+        description: `Validates a workflow stored in your n8n instance by fetching it via API and running comprehensive validation checks. This tool:
+
+- Fetches the workflow from n8n using the workflow ID
+- Validates all node configurations based on their schemas
+- Checks workflow connections and data flow
+- Validates n8n expression syntax in all fields
+- Returns categorized issues with fix suggestions
+
+The validation uses the same engine as validate_workflow but works with workflows already in n8n, making it perfect for validating existing workflows before execution.
+
+Requires N8N_API_URL and N8N_API_KEY environment variables to be configured.`,
+        parameters: {
+            id: {
+                type: 'string',
+                required: true,
+                description: 'The workflow ID to validate from your n8n instance'
+            },
+            options: {
+                type: 'object',
+                required: false,
+                description: 'Validation options: {validateNodes: bool (default true), validateConnections: bool (default true), validateExpressions: bool (default true), profile: "minimal"|"runtime"|"ai-friendly"|"strict" (default "runtime")}'
+            }
+        },
+        returns: 'ValidationResult object containing isValid boolean, arrays of errors/warnings, and suggestions for fixes',
+        examples: [
+            'n8n_validate_workflow({id: "wf_abc123"}) - Validate with default settings',
+            'n8n_validate_workflow({id: "wf_abc123", options: {profile: "strict"}}) - Strict validation',
+            'n8n_validate_workflow({id: "wf_abc123", options: {validateExpressions: false}}) - Skip expression validation'
+        ],
+        useCases: [
+            'Validating workflows before running them in production',
+            'Checking imported workflows for compatibility',
+            'Debugging workflow execution failures',
+            'Ensuring workflows follow best practices',
+            'Pre-deployment validation in CI/CD pipelines'
+        ],
+        performance: 'Depends on workflow size and API latency. Typically 100-500ms for medium workflows.',
+        bestPractices: [
+            'Run validation before activating workflows in production',
+            'Use "runtime" profile for pre-execution checks',
+            'Use "strict" profile for code review and best practices',
+            'Fix errors before warnings - errors will likely cause execution failures',
+            'Pay attention to expression validation - syntax errors are common'
+        ],
+        pitfalls: [
+            'Requires valid API credentials - check n8n_health_check first',
+            'Large workflows may take longer to validate',
+            'Some warnings may be intentional (e.g., optional parameters)',
+            'Profile affects validation time - strict is slower but more thorough',
+            'Expression validation may flag working but non-standard syntax'
+        ],
+        relatedTools: ['validate_workflow', 'n8n_get_workflow', 'validate_workflow_expressions', 'n8n_health_check']
+    }
+};
+//# sourceMappingURL=n8n-validate-workflow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-validate-workflow.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-validate-workflow.ts"],"names":[],"mappings":";;;AAEa,QAAA,sBAAsB,GAAsB;IACvD,IAAI,EAAE,uBAAuB;IAC7B,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,iHAAiH;QAC9H,aAAa,EAAE,CAAC,IAAI,CAAC;QACrB,OAAO,EAAE,0CAA0C;QACnD,WAAW,EAAE,gEAAgE;QAC7E,IAAI,EAAE;YACJ,2FAA2F;YAC3F,0EAA0E;YAC1E,sEAAsE;SACvE;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE;;;;;;;;;;6EAU4D;QACzE,UAAU,EAAE;YACV,EAAE,EAAE;gBACF,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,oDAAoD;aAClE;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,uNAAuN;aACrO;SACF;QACD,OAAO,EAAE,0GAA0G;QACnH,QAAQ,EAAE;YACR,2EAA2E;YAC3E,4FAA4F;YAC5F,8GAA8G;SAC/G;QACD,QAAQ,EAAE;YACR,wDAAwD;YACxD,+CAA+C;YAC/C,uCAAuC;YACvC,0CAA0C;YAC1C,8CAA8C;SAC/C;QACD,WAAW,EAAE,qFAAqF;QAClG,aAAa,EAAE;YACb,0DAA0D;YAC1D,gDAAgD;YAChD,yDAAyD;YACzD,0EAA0E;YAC1E,mEAAmE;SACpE;QACD,QAAQ,EAAE;YACR,+DAA+D;YAC/D,6CAA6C;YAC7C,8DAA8D;YAC9D,sEAAsE;YACtE,gEAAgE;SACjE;QACD,YAAY,EAAE,CAAC,mBAAmB,EAAE,kBAAkB,EAAE,+BAA+B,EAAE,kBAAkB,CAAC;KAC7G;CACF,CAAC"}

package/dist/mcp/tools-documentation-new.d.ts

@@ -0,0 +1,6 @@
+export declare function getToolDocumentation(toolName: string, depth?: 'essentials' | 'full'): string;
+export declare function getToolsOverview(depth?: 'essentials' | 'full'): string;
+export declare function searchToolDocumentation(keyword: string): string[];
+export declare function getToolsByCategory(category: string): string[];
+export declare function getAllCategories(): string[];
+//# sourceMappingURL=tools-documentation-new.d.ts.map

package/dist/mcp/tools-documentation-new.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-documentation-new.d.ts","sourceRoot":"","sources":["../../src/mcp/tools-documentation-new.ts"],"names":[],"mappings":"AAEA,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,YAAY,GAAG,MAAqB,GAAG,MAAM,CAuD1G;AAED,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,YAAY,GAAG,MAAqB,GAAG,MAAM,CAkFpF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAWjE;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAI7D;AAED,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAM3C"}

package/dist/mcp/tools-documentation-new.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getToolDocumentation = getToolDocumentation;
+exports.getToolsOverview = getToolsOverview;
+exports.searchToolDocumentation = searchToolDocumentation;
+exports.getToolsByCategory = getToolsByCategory;
+exports.getAllCategories = getAllCategories;
+const tool_docs_1 = require("./tool-docs");
+function getToolDocumentation(toolName, depth = 'essentials') {
+    const tool = tool_docs_1.toolsDocumentation[toolName];
+    if (!tool) {
+        return `Tool '${toolName}' not found. Use tools_documentation() to see available tools.`;
+    }
+    if (depth === 'essentials') {
+        const { essentials } = tool;
+        return `# ${tool.name}
+
+${essentials.description}
+
+**Example**: ${essentials.example}
+
+**Key parameters**: ${essentials.keyParameters.join(', ')}
+
+**Performance**: ${essentials.performance}
+
+**Tips**:
+${essentials.tips.map(tip => `- ${tip}`).join('\n')}
+
+For full documentation, use: tools_documentation({topic: "${toolName}", depth: "full"})`;
+    }
+    const { full } = tool;
+    return `# ${tool.name}
+
+${full.description}
+
+## Parameters
+${Object.entries(full.parameters).map(([param, info]) => `- **${param}** (${info.type}${info.required ? ', required' : ''}): ${info.description}`).join('\n')}
+
+## Returns
+${full.returns}
+
+## Examples
+${full.examples.map(ex => `\`\`\`javascript\n${ex}\n\`\`\``).join('\n\n')}
+
+## Common Use Cases
+${full.useCases.map(uc => `- ${uc}`).join('\n')}
+
+## Performance
+${full.performance}
+
+## Best Practices
+${full.bestPractices.map(bp => `- ${bp}`).join('\n')}
+
+## Common Pitfalls
+${full.pitfalls.map(p => `- ${p}`).join('\n')}
+
+## Related Tools
+${full.relatedTools.map(t => `- ${t}`).join('\n')}`;
+}
+function getToolsOverview(depth = 'essentials') {
+    if (depth === 'essentials') {
+        return `# n8n MCP Tools Quick Reference
+
+Welcome to n8n-mcp! This tool provides comprehensive access to n8n node documentation.
+
+## Most Used Tools
+
+### 🔍 Discovery
+- **search_nodes**: Search nodes by keyword
+- **list_nodes**: List all nodes with filters
+- **list_ai_tools**: See all AI-capable nodes
+
+### ⚙️ Configuration  
+- **get_node_essentials**: Get key properties only (<5KB vs 100KB+)
+- **get_node_info**: Get complete node schema
+- **search_node_properties**: Find specific properties
+
+### ✅ Validation
+- **validate_node_minimal**: Quick required field check
+- **validate_node_operation**: Full validation with fixes
+- **validate_workflow**: Complete workflow validation
+
+### 📋 Templates
+- **list_tasks**: See common task templates
+- **get_node_for_task**: Get pre-configured nodes
+- **search_templates**: Find workflow templates
+
+### 🔧 n8n Management (requires API config)
+- **n8n_create_workflow**: Create workflows
+- **n8n_update_partial_workflow**: Update with diffs
+- **n8n_health_check**: Test API connectivity
+
+## Quick Start Examples
+
+\`\`\`javascript
+// Find a node
+search_nodes({query: "slack"})
+
+// Get essential config
+get_node_essentials("nodes-base.slack")
+
+// Validate configuration
+validate_node_minimal("nodes-base.slack", {resource: "message", operation: "post"})
+\`\`\`
+
+## Performance Guide
+- **Instant**: <10ms (static/cached)
+- **Fast**: <100ms (queries/generation)
+- **Moderate**: 100-500ms (validation/analysis)
+- **Network-dependent**: Varies with API
+
+For detailed tool documentation, use:
+\`tools_documentation({topic: "tool_name", depth: "full"})\``;
+    }
+    const categories = getAllCategories();
+    return `# n8n MCP Tools Complete Reference
+
+## Available Tools by Category
+
+${categories.map(cat => {
+        const tools = getToolsByCategory(cat);
+        return `### ${cat.charAt(0).toUpperCase() + cat.slice(1)}
+${tools.map(toolName => {
+            const tool = tool_docs_1.toolsDocumentation[toolName];
+            return `- **${toolName}**: ${tool.essentials.description}`;
+        }).join('\n')}`;
+    }).join('\n\n')}
+
+## Tool Categories Explained
+
+- **discovery**: Find and explore n8n nodes
+- **configuration**: Configure and understand nodes
+- **validation**: Validate node and workflow configurations
+- **templates**: Pre-built configurations and examples
+- **workflow_management**: Create and manage n8n workflows (requires API)
+- **system**: MCP system tools and diagnostics
+
+For specific tool documentation, use:
+\`tools_documentation({topic: "tool_name", depth: "full"})\``;
+}
+function searchToolDocumentation(keyword) {
+    const results = [];
+    for (const [toolName, tool] of Object.entries(tool_docs_1.toolsDocumentation)) {
+        const searchText = `${toolName} ${tool.essentials.description} ${tool.full.description}`.toLowerCase();
+        if (searchText.includes(keyword.toLowerCase())) {
+            results.push(toolName);
+        }
+    }
+    return results;
+}
+function getToolsByCategory(category) {
+    return Object.entries(tool_docs_1.toolsDocumentation)
+        .filter(([_, tool]) => tool.category === category)
+        .map(([name, _]) => name);
+}
+function getAllCategories() {
+    const categories = new Set();
+    Object.values(tool_docs_1.toolsDocumentation).forEach(tool => {
+        categories.add(tool.category);
+    });
+    return Array.from(categories);
+}
+//# sourceMappingURL=tools-documentation-new.js.map

package/dist/mcp/tools-documentation-new.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools-documentation-new.js","sourceRoot":"","sources":["../../src/mcp/tools-documentation-new.ts"],"names":[],"mappings":"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"}

package/dist/mcp/tools-documentation.d.ts

@@ -1,34 +1,6 @@
-interface ToolDocumentation {
-    name: string;
-    category: string;
-    essentials: {
-        description: string;
-        keyParameters: string[];
-        example: string;
-        performance: string;
-        tips: string[];
-    };
-    full: {
-        description: string;
-        parameters: Record<string, {
-            type: string;
-            description: string;
-            required?: boolean;
-        }>;
-        returns: string;
-        examples: string[];
-        useCases: string[];
-        performance: string;
-        bestPractices: string[];
-        pitfalls: string[];
-        relatedTools: string[];
-    };
-}
-export declare const toolsDocumentation: Record<string, ToolDocumentation>;
 export declare function getToolDocumentation(toolName: string, depth?: 'essentials' | 'full'): string;
 export declare function getToolsOverview(depth?: 'essentials' | 'full'): string;
-export declare function searchToolDocumentation(query: string): string[];
+export declare function searchToolDocumentation(keyword: string): string[];
 export declare function getToolsByCategory(category: string): string[];
 export declare function getAllCategories(): string[];
-export {};
 //# sourceMappingURL=tools-documentation.d.ts.map

package/dist/mcp/tools-documentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tools-documentation.d.ts","sourceRoot":"","sources":["../../src/mcp/tools-documentation.ts"],"names":[],"mappings":"AAAA,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE;QACV,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,IAAI,EAAE,MAAM,EAAE,CAAC;KAChB,CAAC;IACF,IAAI,EAAE;QACJ,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC,CAAC;QACtF,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,YAAY,EAAE,MAAM,EAAE,CAAC;KACxB,CAAC;CACH;AAED,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAqmChE,CAAC;AAEF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,YAAY,GAAG,MAAqB,GAAG,MAAM,CAuD1G;AAED,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,YAAY,GAAG,MAAqB,GAAG,MAAM,CA8LpF;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAY/D;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAI7D;AAED,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAM3C"}
+{"version":3,"file":"tools-documentation.d.ts","sourceRoot":"","sources":["../../src/mcp/tools-documentation.ts"],"names":[],"mappings":"AAEA,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,YAAY,GAAG,MAAqB,GAAG,MAAM,CA+D1G;AAED,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,YAAY,GAAG,MAAqB,GAAG,MAAM,CA8FpF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAWjE;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAI7D;AAED,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAM3C"}