n8n-atom-mcp 0.0.1

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

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.n8nGetWorkflowDoc = void 0;
+exports.n8nGetWorkflowDoc = {
+    name: 'n8n_get_workflow',
+    category: 'workflow_management',
+    essentials: {
+        description: 'Get workflow by ID with different detail levels. Use mode to control response size and content.',
+        keyParameters: ['id', 'mode'],
+        example: 'n8n_get_workflow({id: "workflow_123", mode: "structure"})',
+        performance: 'Fast (50-200ms)',
+        tips: [
+            'mode="full" (default): Complete workflow with all data',
+            'mode="details": Full workflow + execution stats',
+            'mode="structure": Just nodes and connections (topology)',
+            'mode="minimal": Only id, name, active status, tags'
+        ]
+    },
+    full: {
+        description: `**Modes:**
+- full (default): Complete workflow including all nodes with parameters, connections, and settings
+- details: Full workflow plus execution statistics (success/error counts, last execution time)
+- structure: Nodes and connections only - useful for topology analysis
+- minimal: Just id, name, active status, and tags - fastest response`,
+        parameters: {
+            id: { type: 'string', required: true, description: 'Workflow ID to retrieve' },
+            mode: { type: 'string', required: false, description: 'Detail level: "full" (default), "details", "structure", "minimal"' }
+        },
+        returns: `Depends on mode:
+- full: Complete workflow object (id, name, active, nodes[], connections{}, settings, createdAt, updatedAt)
+- details: Full workflow + executionStats (successCount, errorCount, lastExecution, etc.)
+- structure: { nodes: [...], connections: {...} } - topology only
+- minimal: { id, name, active, tags, createdAt, updatedAt }`,
+        examples: [
+            '// Get complete workflow (default)\nn8n_get_workflow({id: "abc123"})',
+            '// Get workflow with execution stats\nn8n_get_workflow({id: "abc123", mode: "details"})',
+            '// Get just the topology\nn8n_get_workflow({id: "abc123", mode: "structure"})',
+            '// Quick metadata check\nn8n_get_workflow({id: "abc123", mode: "minimal"})'
+        ],
+        useCases: [
+            'View and edit workflow (mode=full)',
+            'Analyze workflow performance (mode=details)',
+            'Clone or compare workflow structure (mode=structure)',
+            'List workflows with status (mode=minimal)',
+            'Debug workflow issues'
+        ],
+        performance: `Response times vary by mode:
+- minimal: ~20-50ms (smallest response)
+- structure: ~30-80ms (nodes + connections only)
+- full: ~50-200ms (complete workflow)
+- details: ~100-300ms (includes execution queries)`,
+        bestPractices: [
+            'Use mode="minimal" when listing or checking status',
+            'Use mode="structure" for workflow analysis or cloning',
+            'Use mode="full" (default) when editing',
+            'Use mode="details" for debugging execution issues',
+            'Validate workflow after retrieval if planning modifications'
+        ],
+        pitfalls: [
+            'Requires N8N_API_URL and N8N_API_KEY configured',
+            'mode="details" adds database queries for execution stats',
+            'Workflow must exist or returns 404 error',
+            'Credentials are referenced by ID but values not included'
+        ],
+        relatedTools: ['n8n_list_workflows', 'n8n_update_full_workflow', 'n8n_update_partial_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,EAAE,MAAM,CAAC;QAC7B,OAAO,EAAE,2DAA2D;QACpE,WAAW,EAAE,iBAAiB;QAC9B,IAAI,EAAE;YACJ,wDAAwD;YACxD,iDAAiD;YACjD,yDAAyD;YACzD,oDAAoD;SACrD;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE;;;;qEAIoD;QACjE,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,yBAAyB,EAAE;YAC9E,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,mEAAmE,EAAE;SAC5H;QACD,OAAO,EAAE;;;;4DAI+C;QACxD,QAAQ,EAAE;YACR,sEAAsE;YACtE,yFAAyF;YACzF,+EAA+E;YAC/E,4EAA4E;SAC7E;QACD,QAAQ,EAAE;YACR,oCAAoC;YACpC,6CAA6C;YAC7C,sDAAsD;YACtD,2CAA2C;YAC3C,uBAAuB;SACxB;QACD,WAAW,EAAE;;;;mDAIkC;QAC/C,aAAa,EAAE;YACb,oDAAoD;YACpD,uDAAuD;YACvD,wCAAwC;YACxC,mDAAmD;YACnD,6DAA6D;SAC9D;QACD,QAAQ,EAAE;YACR,iDAAiD;YACjD,0DAA0D;YAC1D,0CAA0C;YAC1C,0DAA0D;SAC3D;QACD,YAAY,EAAE,CAAC,oBAAoB,EAAE,0BAA0B,EAAE,6BAA6B,EAAE,uBAAuB,CAAC;KACzH;CACF,CAAC"}

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.n8nTestWorkflowDoc = void 0;
+exports.n8nTestWorkflowDoc = {
+    name: 'n8n_test_workflow',
+    category: 'workflow_management',
+    essentials: {
+        description: 'Test/trigger workflow execution. Auto-detects trigger type (webhook/form/chat). Only workflows with these triggers can be executed externally.',
+        keyParameters: ['workflowId', 'triggerType', 'data', 'message'],
+        example: 'n8n_test_workflow({workflowId: "123"}) - auto-detect trigger',
+        performance: 'Immediate trigger, response time depends on workflow complexity',
+        tips: [
+            'Auto-detects trigger type from workflow if not specified',
+            'Workflow must have a webhook, form, or chat trigger to be executable',
+            'For chat triggers, message is required',
+            'All trigger types require the workflow to be ACTIVE'
+        ]
+    },
+    full: {
+        description: `Test and trigger n8n workflows through HTTP-based methods. This unified tool supports multiple trigger types:
+
+**Trigger Types:**
+- **webhook**: HTTP-based triggers (GET/POST/PUT/DELETE)
+- **form**: Form submission triggers
+- **chat**: AI chat triggers with conversation support
+
+**Important:** n8n's public API does not support direct workflow execution. Only workflows with webhook, form, or chat triggers can be executed externally. Workflows with schedule, manual, or other trigger types cannot be triggered via this API.
+
+The tool auto-detects the appropriate trigger type by analyzing the workflow's trigger node. You can override this with the triggerType parameter.`,
+        parameters: {
+            workflowId: {
+                type: 'string',
+                required: true,
+                description: 'Workflow ID to execute'
+            },
+            triggerType: {
+                type: 'string',
+                required: false,
+                enum: ['webhook', 'form', 'chat'],
+                description: 'Trigger type. Auto-detected if not specified. Workflow must have matching trigger node.'
+            },
+            httpMethod: {
+                type: 'string',
+                required: false,
+                enum: ['GET', 'POST', 'PUT', 'DELETE'],
+                description: 'For webhook: HTTP method (default: from workflow config or POST)'
+            },
+            webhookPath: {
+                type: 'string',
+                required: false,
+                description: 'For webhook: override the webhook path'
+            },
+            message: {
+                type: 'string',
+                required: false,
+                description: 'For chat: message to send (required for chat triggers)'
+            },
+            sessionId: {
+                type: 'string',
+                required: false,
+                description: 'For chat: session ID for conversation continuity'
+            },
+            data: {
+                type: 'object',
+                required: false,
+                description: 'Input data/payload for webhook or form fields'
+            },
+            headers: {
+                type: 'object',
+                required: false,
+                description: 'Custom HTTP headers'
+            },
+            timeout: {
+                type: 'number',
+                required: false,
+                description: 'Timeout in ms (default: 120000)'
+            },
+            waitForResponse: {
+                type: 'boolean',
+                required: false,
+                description: 'Wait for workflow completion (default: true)'
+            }
+        },
+        returns: `Execution response including:
+- success: boolean
+- data: workflow output data
+- executionId: for tracking/debugging
+- triggerType: detected or specified trigger type
+- metadata: timing and request details`,
+        examples: [
+            'n8n_test_workflow({workflowId: "123"}) - Auto-detect and trigger',
+            'n8n_test_workflow({workflowId: "123", triggerType: "webhook", data: {name: "John"}}) - Webhook with data',
+            'n8n_test_workflow({workflowId: "123", triggerType: "chat", message: "Hello AI"}) - Chat trigger',
+            'n8n_test_workflow({workflowId: "123", triggerType: "form", data: {email: "test@example.com"}}) - Form submission'
+        ],
+        useCases: [
+            'Test workflows during development',
+            'Trigger AI chat workflows with messages',
+            'Submit form data to form-triggered workflows',
+            'Integrate n8n workflows with external systems via webhooks'
+        ],
+        performance: `Performance varies based on workflow complexity and waitForResponse setting:
+- Webhook: Immediate trigger, depends on workflow
+- Form: Immediate trigger, depends on workflow
+- Chat: May have additional AI processing time`,
+        errorHandling: `**Error Response with Execution Guidance**
+
+When execution fails, the response includes guidance for debugging:
+
+**With Execution ID** (workflow started but failed):
+- Use n8n_executions({action: 'get', id: executionId, mode: 'preview'}) to investigate
+
+**Without Execution ID** (workflow didn't start):
+- Use n8n_executions({action: 'list', workflowId: 'wf_id'}) to find recent executions
+
+**Common Errors:**
+- "Workflow not found" - Check workflow ID exists
+- "Workflow not active" - Activate workflow (required for all trigger types)
+- "Workflow cannot be triggered externally" - Workflow has no webhook/form/chat trigger
+- "Chat message required" - Provide message parameter for chat triggers
+- "SSRF protection" - URL validation failed`,
+        bestPractices: [
+            'Let auto-detection choose the trigger type when possible',
+            'Ensure workflow has a webhook, form, or chat trigger before testing',
+            'For chat workflows, provide sessionId for multi-turn conversations',
+            'Use mode="preview" with n8n_executions for efficient debugging',
+            'Test with small data payloads first',
+            'Activate workflows before testing (use n8n_update_partial_workflow with activateWorkflow)'
+        ],
+        pitfalls: [
+            'All trigger types require the workflow to be ACTIVE',
+            'Workflows without webhook/form/chat triggers cannot be executed externally',
+            'Chat trigger requires message parameter',
+            'Form data must match expected form fields',
+            'Webhook method must match node configuration'
+        ],
+        relatedTools: ['n8n_executions', 'n8n_get_workflow', 'n8n_create_workflow', 'n8n_validate_workflow']
+    }
+};
+//# sourceMappingURL=n8n-test-workflow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-test-workflow.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-test-workflow.ts"],"names":[],"mappings":";;;AAEa,QAAA,kBAAkB,GAAsB;IACnD,IAAI,EAAE,mBAAmB;IACzB,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,gJAAgJ;QAC7J,aAAa,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC;QAC/D,OAAO,EAAE,8DAA8D;QACvE,WAAW,EAAE,iEAAiE;QAC9E,IAAI,EAAE;YACJ,0DAA0D;YAC1D,sEAAsE;YACtE,wCAAwC;YACxC,qDAAqD;SACtD;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE;;;;;;;;;mJASkI;QAC/I,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,wBAAwB;aACtC;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC;gBACjC,WAAW,EAAE,yFAAyF;aACvG;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,kEAAkE;aAChF;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,wCAAwC;aACtD;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,wDAAwD;aACtE;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,kDAAkD;aAChE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,+CAA+C;aAC7D;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,qBAAqB;aACnC;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,iCAAiC;aAC/C;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,8CAA8C;aAC5D;SACF;QACD,OAAO,EAAE;;;;;uCAK0B;QACnC,QAAQ,EAAE;YACR,kEAAkE;YAClE,0GAA0G;YAC1G,iGAAiG;YACjG,kHAAkH;SACnH;QACD,QAAQ,EAAE;YACR,mCAAmC;YACnC,yCAAyC;YACzC,8CAA8C;YAC9C,4DAA4D;SAC7D;QACD,WAAW,EAAE;;;+CAG8B;QAC3C,aAAa,EAAE;;;;;;;;;;;;;;;4CAeyB;QACxC,aAAa,EAAE;YACb,0DAA0D;YAC1D,qEAAqE;YACrE,oEAAoE;YACpE,gEAAgE;YAChE,qCAAqC;YACrC,2FAA2F;SAC5F;QACD,QAAQ,EAAE;YACR,qDAAqD;YACrD,4EAA4E;YAC5E,yCAAyC;YACzC,2CAA2C;YAC3C,8CAA8C;SAC/C;QACD,YAAY,EAAE,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,uBAAuB,CAAC;KACrG;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,iBAwDtC,CAAC"}

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

@@ -0,0 +1,61 @@
+"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: [
+            'Include intent parameter in every call - helps to return better responses',
+            '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.)' },
+            intent: { type: 'string', description: 'Intent of the change - helps to return better response. Include in every tool call. Example: "Migrate workflow to new node versions".' }
+        },
+        returns: 'Minimal summary (id, name, active, nodeCount) for token efficiency. Use n8n_get_workflow with mode "structure" to verify current state if needed.',
+        examples: [
+            'n8n_update_full_workflow({id: "abc", intent: "Rename workflow for clarity", name: "New Name"}) - Rename with intent',
+            'n8n_update_full_workflow({id: "abc", name: "New Name"}) - Rename only',
+            'n8n_update_full_workflow({id: "xyz", intent: "Add error handling nodes", nodes: [...], connections: {...}}) - Full structure update',
+            'const wf = n8n_get_workflow({id}); wf.nodes.push(newNode); n8n_update_full_workflow({...wf, intent: "Add data processing node"}); // 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: [
+            'Always include intent parameter - it helps provide better responses',
+            '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,2EAA2E;YAC3E,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;YACzG,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uIAAuI,EAAE;SACjL;QACD,OAAO,EAAE,mJAAmJ;QAC5J,QAAQ,EAAE;YACR,qHAAqH;YACrH,uEAAuE;YACvE,qIAAqI;YACrI,+IAA+I;SAChJ;QACD,QAAQ,EAAE;YACR,8BAA8B;YAC9B,mBAAmB;YACnB,0BAA0B;YAC1B,+BAA+B;YAC/B,kBAAkB;SACnB;QACD,WAAW,EAAE,wHAAwH;QACrI,aAAa,EAAE;YACb,qEAAqE;YACrE,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,iBA+ZzC,CAAC"}