n8n-atom-mcp 0.0.1

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

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.n8nAutofixWorkflowDoc = void 0;
+exports.n8nAutofixWorkflowDoc = {
+    name: 'n8n_autofix_workflow',
+    category: 'workflow_management',
+    essentials: {
+        description: 'Automatically fix common workflow validation errors - expression formats, typeVersions, error outputs, webhook paths, and smart version upgrades',
+        keyParameters: ['id', 'applyFixes'],
+        example: 'n8n_autofix_workflow({id: "wf_abc123", applyFixes: false})',
+        performance: 'Network-dependent (200-1500ms) - fetches, validates, and optionally updates workflow with smart migrations',
+        tips: [
+            'Use applyFixes: false to preview changes before applying',
+            'Set confidenceThreshold to control fix aggressiveness (high/medium/low)',
+            'Supports expression formats, typeVersion issues, error outputs, node corrections, webhook paths, AND version upgrades',
+            'High-confidence fixes (≥90%) are safe for auto-application',
+            'Version upgrades include smart migration with breaking change detection',
+            'Post-update guidance provides AI-friendly step-by-step instructions for manual changes'
+        ]
+    },
+    full: {
+        description: `Automatically detects and fixes common workflow validation errors in n8n workflows. This tool:
+
+- Fetches the workflow from your n8n instance
+- Runs comprehensive validation to detect issues
+- Generates targeted fixes for common problems
+- Optionally applies the fixes back to the workflow
+
+The auto-fixer can resolve:
+1. **Expression Format Issues**: Missing '=' prefix in n8n expressions (e.g., {{ $json.field }} → ={{ $json.field }})
+2. **TypeVersion Corrections**: Downgrades nodes with unsupported typeVersions to maximum supported
+3. **Error Output Configuration**: Removes conflicting onError settings when error connections are missing
+4. **Node Type Corrections**: Intelligently fixes unknown node types using similarity matching:
+   - Handles deprecated package prefixes (n8n-nodes-base. → nodes-base.)
+   - Corrects capitalization mistakes (HttpRequest → httpRequest)
+   - Suggests correct packages (nodes-base.openai → nodes-langchain.openAi)
+   - Uses multi-factor scoring: name similarity, category match, package match, pattern match
+   - Only auto-fixes suggestions with ≥90% confidence
+   - Leverages NodeSimilarityService with 5-minute caching for performance
+5. **Webhook Path Generation**: Automatically generates UUIDs for webhook nodes missing path configuration:
+   - Generates a unique UUID for webhook path
+   - Sets both 'path' parameter and 'webhookId' field to the same UUID
+   - Ensures webhook nodes become functional with valid endpoints
+   - High confidence fix as UUID generation is deterministic
+6. **Smart Version Upgrades** (NEW): Proactively upgrades nodes to their latest versions:
+   - Detects outdated node versions and recommends upgrades
+   - Applies smart migrations with auto-migratable property changes
+   - Handles breaking changes intelligently (Execute Workflow v1.0→v1.1, Webhook v2.0→v2.1, etc.)
+   - Generates UUIDs for required fields (webhookId), sets sensible defaults
+   - HIGH confidence for non-breaking upgrades, MEDIUM for breaking changes with auto-migration
+   - Example: Execute Workflow v1.0→v1.1 adds inputFieldMapping automatically
+7. **Version Migration Guidance** (NEW): Documents complex migrations requiring manual intervention:
+   - Identifies breaking changes that cannot be auto-migrated
+   - Provides AI-friendly post-update guidance with step-by-step instructions
+   - Lists required actions by priority (CRITICAL, HIGH, MEDIUM, LOW)
+   - Documents behavior changes and their impact
+   - Estimates time required for manual migration steps
+   - MEDIUM/LOW confidence - requires review before applying
+
+The tool uses a confidence-based system to ensure safe fixes:
+- **High (≥90%)**: Safe to auto-apply (exact matches, known patterns)
+- **Medium (70-89%)**: Generally safe but review recommended
+- **Low (<70%)**: Manual review strongly recommended
+
+Requires N8N_API_URL and N8N_API_KEY environment variables to be configured.`,
+        parameters: {
+            id: {
+                type: 'string',
+                required: true,
+                description: 'The workflow ID to fix in your n8n instance'
+            },
+            applyFixes: {
+                type: 'boolean',
+                required: false,
+                description: 'Whether to apply fixes to the workflow (default: false - preview mode). When false, returns proposed fixes without modifying the workflow.'
+            },
+            fixTypes: {
+                type: 'array',
+                required: false,
+                description: 'Types of fixes to apply. Options: ["expression-format", "typeversion-correction", "error-output-config", "node-type-correction", "webhook-missing-path", "typeversion-upgrade", "version-migration"]. Default: all types. NEW: "typeversion-upgrade" for smart version upgrades, "version-migration" for complex migration guidance.'
+            },
+            confidenceThreshold: {
+                type: 'string',
+                required: false,
+                description: 'Minimum confidence level for fixes: "high" (≥90%), "medium" (≥70%), "low" (any). Default: "medium".'
+            },
+            maxFixes: {
+                type: 'number',
+                required: false,
+                description: 'Maximum number of fixes to apply (default: 50). Useful for limiting scope of changes.'
+            }
+        },
+        returns: `AutoFixResult object containing:
+- operations: Array of diff operations that will be/were applied
+- fixes: Detailed list of individual fixes with before/after values
+- summary: Human-readable summary of fixes
+- stats: Statistics by fix type and confidence level
+- applied: Boolean indicating if fixes were applied (when applyFixes: true)
+- postUpdateGuidance: (NEW) Array of AI-friendly migration guidance for version upgrades, including:
+  * Required actions by priority (CRITICAL, HIGH, MEDIUM, LOW)
+  * Deprecated properties to remove
+  * Behavior changes and their impact
+  * Step-by-step migration instructions
+  * Estimated time for manual changes`,
+        examples: [
+            'n8n_autofix_workflow({id: "wf_abc123"}) - Preview all possible fixes including version upgrades',
+            'n8n_autofix_workflow({id: "wf_abc123", applyFixes: true}) - Apply all medium+ confidence fixes',
+            'n8n_autofix_workflow({id: "wf_abc123", applyFixes: true, confidenceThreshold: "high"}) - Only apply high-confidence fixes',
+            'n8n_autofix_workflow({id: "wf_abc123", fixTypes: ["expression-format"]}) - Only fix expression format issues',
+            'n8n_autofix_workflow({id: "wf_abc123", fixTypes: ["webhook-missing-path"]}) - Only fix webhook path issues',
+            'n8n_autofix_workflow({id: "wf_abc123", fixTypes: ["typeversion-upgrade"]}) - NEW: Only upgrade node versions with smart migrations',
+            'n8n_autofix_workflow({id: "wf_abc123", fixTypes: ["typeversion-upgrade", "version-migration"]}) - NEW: Upgrade versions and provide migration guidance',
+            'n8n_autofix_workflow({id: "wf_abc123", applyFixes: true, maxFixes: 10}) - Apply up to 10 fixes'
+        ],
+        useCases: [
+            'Fixing workflows imported from older n8n versions',
+            'Correcting expression syntax after manual edits',
+            'Resolving typeVersion conflicts after n8n upgrades',
+            'Cleaning up workflows before production deployment',
+            'Batch fixing common issues across multiple workflows',
+            'Migrating workflows between n8n instances with different versions',
+            'Repairing webhook nodes that lost their path configuration',
+            'Upgrading Execute Workflow nodes from v1.0 to v1.1+ with automatic inputFieldMapping',
+            'Modernizing webhook nodes to v2.1+ with stable webhookId fields',
+            'Proactively keeping workflows up-to-date with latest node versions',
+            'Getting detailed migration guidance for complex breaking changes'
+        ],
+        performance: 'Depends on workflow size and number of issues. Preview mode: 200-500ms. Apply mode: 500-1500ms for medium workflows with version upgrades. Node similarity matching and version metadata are cached for 5 minutes for improved performance on repeated validations.',
+        bestPractices: [
+            'Always preview fixes first (applyFixes: false) before applying',
+            'Start with high confidence threshold for production workflows',
+            'Review the fix summary to understand what changed',
+            'Test workflows after auto-fixing to ensure expected behavior',
+            'Use fixTypes parameter to target specific issue categories',
+            'Keep maxFixes reasonable to avoid too many changes at once',
+            'NEW: Review postUpdateGuidance for version upgrades - contains step-by-step migration instructions',
+            'NEW: Test workflows after version upgrades - behavior may change even with successful auto-migration',
+            'NEW: Apply version upgrades incrementally - start with high-confidence, non-breaking upgrades'
+        ],
+        pitfalls: [
+            'Some fixes may change workflow behavior - always test after fixing',
+            'Low confidence fixes might not be the intended solution',
+            'Expression format fixes assume standard n8n syntax requirements',
+            'Node type corrections only work for known node types in the database',
+            'Cannot fix structural issues like missing nodes or invalid connections',
+            'TypeVersion downgrades might remove node features added in newer versions',
+            'Generated webhook paths are new UUIDs - existing webhook URLs will change',
+            'NEW: Version upgrades may introduce breaking changes - review postUpdateGuidance carefully',
+            'NEW: Auto-migrated properties use sensible defaults which may not match your use case',
+            'NEW: Execute Workflow v1.1+ requires explicit inputFieldMapping - automatic mapping uses empty array',
+            'NEW: Some breaking changes cannot be auto-migrated and require manual intervention',
+            'NEW: Version history is based on registry - unknown nodes cannot be upgraded'
+        ],
+        relatedTools: [
+            'n8n_validate_workflow',
+            'validate_workflow',
+            'validate_node',
+            'n8n_update_partial_workflow'
+        ]
+    }
+};
+//# sourceMappingURL=n8n-autofix-workflow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-autofix-workflow.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-autofix-workflow.ts"],"names":[],"mappings":";;;AAEa,QAAA,qBAAqB,GAAsB;IACtD,IAAI,EAAE,sBAAsB;IAC5B,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,kJAAkJ;QAC/J,aAAa,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC;QACnC,OAAO,EAAE,4DAA4D;QACrE,WAAW,EAAE,4GAA4G;QACzH,IAAI,EAAE;YACJ,0DAA0D;YAC1D,yEAAyE;YACzE,uHAAuH;YACvH,4DAA4D;YAC5D,yEAAyE;YACzE,wFAAwF;SACzF;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6EA2C4D;QACzE,UAAU,EAAE;YACV,EAAE,EAAE;gBACF,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,6CAA6C;aAC3D;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,4IAA4I;aAC1J;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,sUAAsU;aACpV;YACD,mBAAmB,EAAE;gBACnB,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,qGAAqG;aACnH;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,uFAAuF;aACrG;SACF;QACD,OAAO,EAAE;;;;;;;;;;;sCAWyB;QAClC,QAAQ,EAAE;YACR,iGAAiG;YACjG,gGAAgG;YAChG,2HAA2H;YAC3H,8GAA8G;YAC9G,4GAA4G;YAC5G,oIAAoI;YACpI,wJAAwJ;YACxJ,gGAAgG;SACjG;QACD,QAAQ,EAAE;YACR,mDAAmD;YACnD,iDAAiD;YACjD,oDAAoD;YACpD,oDAAoD;YACpD,sDAAsD;YACtD,mEAAmE;YACnE,4DAA4D;YAC5D,sFAAsF;YACtF,iEAAiE;YACjE,oEAAoE;YACpE,kEAAkE;SACnE;QACD,WAAW,EAAE,qQAAqQ;QAClR,aAAa,EAAE;YACb,gEAAgE;YAChE,+DAA+D;YAC/D,mDAAmD;YACnD,8DAA8D;YAC9D,4DAA4D;YAC5D,4DAA4D;YAC5D,oGAAoG;YACpG,sGAAsG;YACtG,+FAA+F;SAChG;QACD,QAAQ,EAAE;YACR,oEAAoE;YACpE,yDAAyD;YACzD,iEAAiE;YACjE,sEAAsE;YACtE,wEAAwE;YACxE,2EAA2E;YAC3E,2EAA2E;YAC3E,4FAA4F;YAC5F,uFAAuF;YACvF,sGAAsG;YACtG,oFAAoF;YACpF,8EAA8E;SAC/E;QACD,YAAY,EAAE;YACZ,uBAAuB;YACvB,mBAAmB;YACnB,eAAe;YACf,6BAA6B;SAC9B;KACF;CACF,CAAC"}

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

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

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

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

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

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.n8nCreateWorkflowDoc = void 0;
+exports.n8nCreateWorkflowDoc = {
+    name: 'n8n_create_workflow',
+    category: 'workflow_management',
+    essentials: {
+        description: 'Create workflow. Requires: name, nodes[], connections{}. Created inactive. Returns workflow with ID.',
+        keyParameters: ['name', 'nodes', 'connections'],
+        example: 'n8n_create_workflow({name: "My Flow", nodes: [...], connections: {...}})',
+        performance: 'Network-dependent',
+        tips: [
+            'Workflow created inactive',
+            'Returns ID for future updates',
+            'Validate first with validate_workflow',
+            'Auto-sanitization fixes operator structures and missing metadata during creation'
+        ]
+    },
+    full: {
+        description: 'Creates a new workflow in n8n with specified nodes and connections. Workflow is created in inactive state. Each node requires: id, name, type, typeVersion, position, and parameters.',
+        parameters: {
+            name: { type: 'string', required: true, description: 'Workflow name' },
+            nodes: { type: 'array', required: true, description: 'Array of nodes with id, name, type, typeVersion, position, parameters' },
+            connections: { type: 'object', required: true, description: 'Node connections. Keys are source node names (not IDs)' },
+            settings: { type: 'object', description: 'Optional workflow settings (timezone, error handling, etc.)' }
+        },
+        returns: 'Minimal summary (id, name, active, nodeCount) for token efficiency. Use n8n_get_workflow with mode "structure" to verify current state if needed.',
+        examples: [
+            `// Basic webhook to Slack workflow
+n8n_create_workflow({
+  name: "Webhook to Slack",
+  nodes: [
+    {
+      id: "webhook_1",
+      name: "Webhook",
+      type: "n8n-nodes-base.webhook",
+      typeVersion: 1,
+      position: [250, 300],
+      parameters: {
+        httpMethod: "POST",
+        path: "slack-notify"
+      }
+    },
+    {
+      id: "slack_1",
+      name: "Slack",
+      type: "n8n-nodes-base.slack",
+      typeVersion: 1,
+      position: [450, 300],
+      parameters: {
+        resource: "message",
+        operation: "post",
+        channel: "#general",
+        text: "={{$json.message}}"
+      }
+    }
+  ],
+  connections: {
+    "Webhook": {
+      "main": [[{node: "Slack", type: "main", index: 0}]]
+    }
+  }
+})`,
+            `// Workflow with settings and error handling
+n8n_create_workflow({
+  name: "Data Processing",
+  nodes: [...],
+  connections: {...},
+  settings: {
+    timezone: "America/New_York",
+    errorWorkflow: "error_handler_workflow_id",
+    saveDataSuccessExecution: "all",
+    saveDataErrorExecution: "all"
+  }
+})`
+        ],
+        useCases: [
+            'Deploy validated workflows',
+            'Automate workflow creation',
+            'Clone workflow structures',
+            'Template deployment'
+        ],
+        performance: 'Network-dependent - Typically 100-500ms depending on workflow size',
+        bestPractices: [
+            'Validate with validate_workflow first',
+            'Use unique node IDs',
+            'Position nodes for readability',
+            'Test with n8n_test_workflow'
+        ],
+        pitfalls: [
+            '**REQUIRES N8N_API_URL and N8N_API_KEY environment variables** - tool unavailable without n8n API access',
+            'Workflows created in INACTIVE state - must activate separately',
+            'Node IDs must be unique within workflow',
+            'Credentials must be configured separately in n8n',
+            'Node type names must include package prefix (e.g., "n8n-nodes-base.slack")',
+            '**Auto-sanitization runs on creation**: All nodes sanitized before workflow created (operator structures fixed, missing metadata added)',
+            '**Auto-sanitization cannot prevent all failures**: Broken connections or invalid node configurations may still cause creation to fail'
+        ],
+        relatedTools: ['validate_workflow', 'n8n_update_partial_workflow', 'n8n_test_workflow']
+    }
+};
+//# sourceMappingURL=n8n-create-workflow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-create-workflow.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-create-workflow.ts"],"names":[],"mappings":";;;AAEa,QAAA,oBAAoB,GAAsB;IACrD,IAAI,EAAE,qBAAqB;IAC3B,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,sGAAsG;QACnH,aAAa,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC;QAC/C,OAAO,EAAE,0EAA0E;QACnF,WAAW,EAAE,mBAAmB;QAChC,IAAI,EAAE;YACJ,2BAA2B;YAC3B,+BAA+B;YAC/B,uCAAuC;YACvC,kFAAkF;SACnF;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,uLAAuL;QACpM,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE;YACtE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uEAAuE,EAAE;YAC9H,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,wDAAwD,EAAE;YACtH,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6DAA6D,EAAE;SACzG;QACD,OAAO,EAAE,mJAAmJ;QAC5J,QAAQ,EAAE;YACR;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCH;YACG;;;;;;;;;;;GAWH;SACE;QACD,QAAQ,EAAE;YACR,4BAA4B;YAC5B,4BAA4B;YAC5B,2BAA2B;YAC3B,qBAAqB;SACtB;QACD,WAAW,EAAE,oEAAoE;QACjF,aAAa,EAAE;YACb,uCAAuC;YACvC,qBAAqB;YACrB,gCAAgC;YAChC,6BAA6B;SAC9B;QACD,QAAQ,EAAE;YACR,0GAA0G;YAC1G,gEAAgE;YAChE,yCAAyC;YACzC,kDAAkD;YAClD,4EAA4E;YAC5E,yIAAyI;YACzI,uIAAuI;SACxI;QACD,YAAY,EAAE,CAAC,mBAAmB,EAAE,6BAA6B,EAAE,mBAAmB,CAAC;KACxF;CACF,CAAC"}

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

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

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

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

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

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

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

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

package/dist/mcp/tool-docs/workflow_management/n8n-deploy-template.d.ts

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

package/dist/mcp/tool-docs/workflow_management/n8n-deploy-template.d.ts.map

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

package/dist/mcp/tool-docs/workflow_management/n8n-deploy-template.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.n8nDeployTemplateDoc = void 0;
+exports.n8nDeployTemplateDoc = {
+    name: 'n8n_deploy_template',
+    category: 'workflow_management',
+    essentials: {
+        description: 'Deploy a workflow template from n8n.io directly to your n8n instance. Deploys first, then auto-fixes common issues (expression format, typeVersions).',
+        keyParameters: ['templateId', 'name', 'autoUpgradeVersions', 'autoFix', 'stripCredentials'],
+        example: 'n8n_deploy_template({templateId: 2776, name: "My Deployed Template"})',
+        performance: 'Network-dependent',
+        tips: [
+            'Auto-fixes expression format issues after deployment',
+            'Workflow created inactive - configure credentials in n8n UI first',
+            'Returns list of required credentials and fixes applied',
+            'Use search_templates to find template IDs'
+        ]
+    },
+    full: {
+        description: 'Deploys a workflow template from n8n.io directly to your n8n instance. This tool deploys first, then automatically fixes common issues like missing expression prefixes (=) and outdated typeVersions. Templates are stored locally and fetched from the database. The workflow is always created in an inactive state, allowing you to configure credentials before activation.',
+        parameters: {
+            templateId: { type: 'number', required: true, description: 'Template ID from n8n.io (find via search_templates)' },
+            name: { type: 'string', description: 'Custom workflow name (default: template name)' },
+            autoUpgradeVersions: { type: 'boolean', description: 'Upgrade node typeVersions to latest supported (default: true)' },
+            autoFix: { type: 'boolean', description: 'Auto-apply fixes after deployment for expression format issues, missing = prefix, etc. (default: true)' },
+            stripCredentials: { type: 'boolean', description: 'Remove credential references - user configures in n8n UI (default: true)' }
+        },
+        returns: 'Object with workflowId, name, nodeCount, triggerType, requiredCredentials array, url, templateId, templateUrl, autoFixStatus (success/failed/skipped), and fixesApplied array',
+        examples: [
+            `// Deploy template with default settings (auto-fix enabled)
+n8n_deploy_template({templateId: 2776})`,
+            `// Deploy with custom name
+n8n_deploy_template({
+  templateId: 2776,
+  name: "My Google Drive to Airtable Sync"
+})`,
+            `// Deploy without auto-fix (not recommended)
+n8n_deploy_template({
+  templateId: 2776,
+  autoFix: false
+})`,
+            `// Keep original node versions (useful for compatibility)
+n8n_deploy_template({
+  templateId: 2776,
+  autoUpgradeVersions: false
+})`
+        ],
+        useCases: [
+            'Quickly deploy pre-built workflow templates',
+            'Set up common automation patterns',
+            'Bootstrap new projects with proven workflows',
+            'Deploy templates found via search_templates'
+        ],
+        performance: 'Network-dependent - Typically 300-800ms (template fetch + workflow creation + autofix)',
+        bestPractices: [
+            'Use search_templates to find templates by use case',
+            'Review required credentials in the response',
+            'Check autoFixStatus in response - "success", "failed", or "skipped"',
+            'Check fixesApplied in response to see what was automatically corrected',
+            'Configure credentials in n8n UI before activating',
+            'Test workflow before connecting to production systems'
+        ],
+        pitfalls: [
+            '**REQUIRES N8N_API_URL and N8N_API_KEY environment variables** - tool unavailable without n8n API access',
+            'Workflows created in INACTIVE state - must configure credentials and activate in n8n',
+            'Templates may reference services you do not have (Slack, Google, etc.)',
+            'Template database must be populated - run npm run fetch:templates if templates not found',
+            'Some issues may not be auto-fixable (e.g., missing required fields that need user input)'
+        ],
+        relatedTools: ['search_templates', 'get_template', 'n8n_create_workflow', 'n8n_autofix_workflow']
+    }
+};
+//# sourceMappingURL=n8n-deploy-template.js.map

package/dist/mcp/tool-docs/workflow_management/n8n-deploy-template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-deploy-template.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-deploy-template.ts"],"names":[],"mappings":";;;AAEa,QAAA,oBAAoB,GAAsB;IACrD,IAAI,EAAE,qBAAqB;IAC3B,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,uJAAuJ;QACpK,aAAa,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,qBAAqB,EAAE,SAAS,EAAE,kBAAkB,CAAC;QAC3F,OAAO,EAAE,uEAAuE;QAChF,WAAW,EAAE,mBAAmB;QAChC,IAAI,EAAE;YACJ,sDAAsD;YACtD,mEAAmE;YACnE,wDAAwD;YACxD,2CAA2C;SAC5C;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,kXAAkX;QAC/X,UAAU,EAAE;YACV,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,qDAAqD,EAAE;YAClH,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+CAA+C,EAAE;YACtF,mBAAmB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,+DAA+D,EAAE;YACtH,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,wGAAwG,EAAE;YACnJ,gBAAgB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0EAA0E,EAAE;SAC/H;QACD,OAAO,EAAE,+KAA+K;QACxL,QAAQ,EAAE;YACR;wCACkC;YAClC;;;;GAIH;YACG;;;;GAIH;YACG;;;;GAIH;SACE;QACD,QAAQ,EAAE;YACR,6CAA6C;YAC7C,mCAAmC;YACnC,8CAA8C;YAC9C,6CAA6C;SAC9C;QACD,WAAW,EAAE,wFAAwF;QACrG,aAAa,EAAE;YACb,oDAAoD;YACpD,6CAA6C;YAC7C,qEAAqE;YACrE,wEAAwE;YACxE,mDAAmD;YACnD,uDAAuD;SACxD;QACD,QAAQ,EAAE;YACR,0GAA0G;YAC1G,sFAAsF;YACtF,wEAAwE;YACxE,0FAA0F;YAC1F,0FAA0F;SAC3F;QACD,YAAY,EAAE,CAAC,kBAAkB,EAAE,cAAc,EAAE,qBAAqB,EAAE,sBAAsB,CAAC;KAClG;CACF,CAAC"}

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

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

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

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

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

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.n8nExecutionsDoc = void 0;
+exports.n8nExecutionsDoc = {
+    name: 'n8n_executions',
+    category: 'workflow_management',
+    essentials: {
+        description: 'Manage workflow executions: get details, list, or delete. Unified tool for all execution operations.',
+        keyParameters: ['action', 'id', 'workflowId', 'status', 'mode'],
+        example: 'n8n_executions({action: "get", id: "exec_456", mode: "error"})',
+        performance: 'Fast (50-200ms)',
+        tips: [
+            'action="get": Get execution details by ID',
+            'action="list": List executions with filters',
+            'action="delete": Delete execution record',
+            'Use mode="error" for efficient failure debugging (80-90% token savings)',
+            'Use mode parameter for action=get to control detail level'
+        ]
+    },
+    full: {
+        description: `**Actions:**
+- get: Retrieve execution details by ID with configurable detail level
+- list: List executions with filtering and pagination
+- delete: Remove an execution record from history
+
+**Detail Modes for action="get":**
+- preview: Structure only, no data
+- summary: 2 items per node (default)
+- filtered: Custom items limit, optionally filter by node names
+- full: All execution data (can be very large)
+- error: Optimized for debugging failures - extracts error info, upstream context, and AI suggestions
+
+**Error Mode Features:**
+- Extracts error message, type, and node configuration
+- Samples input data from upstream node (configurable limit)
+- Shows execution path leading to error
+- Provides AI-friendly fix suggestions based on error patterns
+- Token-efficient (80-90% smaller than full mode)`,
+        parameters: {
+            action: { type: 'string', required: true, description: 'Operation: "get", "list", or "delete"' },
+            id: { type: 'string', required: false, description: 'Execution ID (required for action=get or action=delete)' },
+            mode: { type: 'string', required: false, description: 'For action=get: "preview", "summary" (default), "filtered", "full", "error"' },
+            nodeNames: { type: 'array', required: false, description: 'For action=get with mode=filtered: Filter to specific nodes by name' },
+            itemsLimit: { type: 'number', required: false, description: 'For action=get with mode=filtered: Items per node (0=structure, 2=default, -1=unlimited)' },
+            includeInputData: { type: 'boolean', required: false, description: 'For action=get: Include input data in addition to output (default: false)' },
+            errorItemsLimit: { type: 'number', required: false, description: 'For action=get with mode=error: Sample items from upstream (default: 2, max: 100)' },
+            includeStackTrace: { type: 'boolean', required: false, description: 'For action=get with mode=error: Include full stack trace (default: false, shows truncated)' },
+            includeExecutionPath: { type: 'boolean', required: false, description: 'For action=get with mode=error: Include execution path (default: true)' },
+            fetchWorkflow: { type: 'boolean', required: false, description: 'For action=get with mode=error: Fetch workflow for accurate upstream detection (default: true)' },
+            workflowId: { type: 'string', required: false, description: 'For action=list: Filter by workflow ID' },
+            status: { type: 'string', required: false, description: 'For action=list: Filter by status ("success", "error", "waiting")' },
+            limit: { type: 'number', required: false, description: 'For action=list: Number of results (1-100, default: 100)' },
+            cursor: { type: 'string', required: false, description: 'For action=list: Pagination cursor from previous response' },
+            projectId: { type: 'string', required: false, description: 'For action=list: Filter by project ID (enterprise)' },
+            includeData: { type: 'boolean', required: false, description: 'For action=list: Include execution data (default: false)' }
+        },
+        returns: `Depends on action:
+- get (error mode): { errorInfo: { primaryError, upstreamContext, executionPath, suggestions }, summary }
+- get (other modes): Execution object with data based on mode
+- list: { data: [...executions], nextCursor?: string }
+- delete: { success: boolean, message: string }`,
+        examples: [
+            '// Debug a failed execution (recommended for errors)\nn8n_executions({action: "get", id: "exec_456", mode: "error"})',
+            '// Debug with more sample data from upstream\nn8n_executions({action: "get", id: "exec_456", mode: "error", errorItemsLimit: 5})',
+            '// Debug with full stack trace\nn8n_executions({action: "get", id: "exec_456", mode: "error", includeStackTrace: true})',
+            '// Debug without workflow fetch (faster but less accurate)\nn8n_executions({action: "get", id: "exec_456", mode: "error", fetchWorkflow: false})',
+            '// List recent executions for a workflow\nn8n_executions({action: "list", workflowId: "abc123", limit: 10})',
+            '// List failed executions\nn8n_executions({action: "list", status: "error"})',
+            '// Get execution summary\nn8n_executions({action: "get", id: "exec_456"})',
+            '// Get full execution data\nn8n_executions({action: "get", id: "exec_456", mode: "full"})',
+            '// Get specific nodes from execution\nn8n_executions({action: "get", id: "exec_456", mode: "filtered", nodeNames: ["HTTP Request", "Slack"]})',
+            '// Delete an execution\nn8n_executions({action: "delete", id: "exec_456"})'
+        ],
+        useCases: [
+            'Debug workflow failures efficiently (mode=error) - 80-90% token savings',
+            'Get AI suggestions for fixing common errors',
+            'Analyze input data that caused failure',
+            'Debug workflow failures with full data (mode=full)',
+            'Monitor workflow health (list with status filter)',
+            'Audit execution history',
+            'Clean up old execution records',
+            'Analyze specific node outputs'
+        ],
+        performance: `Response times:
+- list: 50-150ms depending on filters
+- get (preview/summary): 30-100ms
+- get (error): 50-200ms (includes optional workflow fetch)
+- get (full): 100-500ms+ depending on data size
+- delete: 30-80ms`,
+        bestPractices: [
+            'Use mode="error" for debugging failed executions - 80-90% token savings vs full',
+            'Use mode="summary" (default) for quick inspection',
+            'Use mode="filtered" with nodeNames for large workflows',
+            'Filter by workflowId when listing to reduce results',
+            'Use cursor for pagination through large result sets',
+            'Set fetchWorkflow=false if you already know the workflow structure',
+            'Delete old executions to save storage'
+        ],
+        pitfalls: [
+            'Requires N8N_API_URL and N8N_API_KEY configured',
+            'mode="full" can return very large responses for complex workflows',
+            'mode="error" fetches workflow by default (adds ~50-100ms), disable with fetchWorkflow=false',
+            'Execution must exist or returns 404',
+            'Delete is permanent - cannot undo'
+        ],
+        relatedTools: ['n8n_get_workflow', 'n8n_test_workflow', 'n8n_validate_workflow']
+    }
+};
+//# sourceMappingURL=n8n-executions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-executions.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-executions.ts"],"names":[],"mappings":";;;AAEa,QAAA,gBAAgB,GAAsB;IACjD,IAAI,EAAE,gBAAgB;IACtB,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,sGAAsG;QACnH,aAAa,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,CAAC;QAC/D,OAAO,EAAE,gEAAgE;QACzE,WAAW,EAAE,iBAAiB;QAC9B,IAAI,EAAE;YACJ,2CAA2C;YAC3C,6CAA6C;YAC7C,0CAA0C;YAC1C,yEAAyE;YACzE,2DAA2D;SAC5D;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE;;;;;;;;;;;;;;;;;kDAiBiC;QAC9C,UAAU,EAAE;YACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uCAAuC,EAAE;YAChG,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,yDAAyD,EAAE;YAC/G,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,6EAA6E,EAAE;YACrI,SAAS,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,qEAAqE,EAAE;YACjI,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,0FAA0F,EAAE;YACxJ,gBAAgB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,2EAA2E,EAAE;YAChJ,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,mFAAmF,EAAE;YACtJ,iBAAiB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,4FAA4F,EAAE;YAClK,oBAAoB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,wEAAwE,EAAE;YACjJ,aAAa,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,gGAAgG,EAAE;YAClK,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,wCAAwC,EAAE;YACtG,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,mEAAmE,EAAE;YAC7H,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,0DAA0D,EAAE;YACnH,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,2DAA2D,EAAE;YACrH,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,oDAAoD,EAAE;YACjH,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,0DAA0D,EAAE;SAC3H;QACD,OAAO,EAAE;;;;gDAImC;QAC5C,QAAQ,EAAE;YACR,sHAAsH;YACtH,kIAAkI;YAClI,yHAAyH;YACzH,kJAAkJ;YAClJ,6GAA6G;YAC7G,8EAA8E;YAC9E,2EAA2E;YAC3E,2FAA2F;YAC3F,+IAA+I;YAC/I,4EAA4E;SAC7E;QACD,QAAQ,EAAE;YACR,yEAAyE;YACzE,6CAA6C;YAC7C,wCAAwC;YACxC,oDAAoD;YACpD,mDAAmD;YACnD,yBAAyB;YACzB,gCAAgC;YAChC,+BAA+B;SAChC;QACD,WAAW,EAAE;;;;;kBAKC;QACd,aAAa,EAAE;YACb,iFAAiF;YACjF,mDAAmD;YACnD,wDAAwD;YACxD,qDAAqD;YACrD,qDAAqD;YACrD,oEAAoE;YACpE,uCAAuC;SACxC;QACD,QAAQ,EAAE;YACR,iDAAiD;YACjD,mEAAmE;YACnE,6FAA6F;YAC7F,qCAAqC;YACrC,mCAAmC;SACpC;QACD,YAAY,EAAE,CAAC,kBAAkB,EAAE,mBAAmB,EAAE,uBAAuB,CAAC;KACjF;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,iBA+D/B,CAAC"}