chore: update n8n to 2.14.2 and bump version to 2.45.0 (#692 )

Update n8n dependencies: - n8n: 2.13.3 → 2.14.2 - n8n-core: 2.13.1 → 2.14.1 - n8n-workflow: 2.13.1 → 2.14.1 - @n8n/n8n-nodes-langchain: 2.13.1 → 2.14.1 Preserved 584 community nodes and rebuilt FTS5 search index. Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
fix: upgrade GitHub Actions and patch dependency vulnerabilities (v2.44.1) (#690 )
2026-04-02 07:33:07 +00:00 · 2026-04-02 07:38:58 +02:00 · 2026-04-01 21:17:59 +02:00 · 2026-04-01 00:17:27 +02:00
27 changed files with 1476 additions and 1135 deletions
--- a/.github/workflows/docker-build-fast.yml
+++ b/.github/workflows/docker-build-fast.yml
@@ -36,11 +36,11 @@ jobs:
          password: ${{ secrets.DOCKERHUB_TOKEN }}

      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
+        uses: docker/setup-buildx-action@v4

      - name: Log in to GitHub Container Registry
        if: github.event_name != 'pull_request'
-        uses: docker/login-action@v3
+        uses: docker/login-action@v4
        with:
          registry: ${{ env.REGISTRY }}
          username: ${{ github.actor }}
@@ -48,7 +48,7 @@ jobs:
          
      - name: Extract metadata
        id: meta
-        uses: docker/metadata-action@v5
+        uses: docker/metadata-action@v6
        with:
          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
          tags: |
@@ -56,7 +56,7 @@ jobs:
            type=raw,value=test-amd64
            
      - name: Build and push Docker image (AMD64 only)
-        uses: docker/build-push-action@v5
+        uses: docker/build-push-action@v7
        with:
          context: .
          platforms: linux/amd64
--- a/.github/workflows/docker-build-n8n.yml
+++ b/.github/workflows/docker-build-n8n.yml
@@ -53,7 +53,7 @@ jobs:
        uses: actions/checkout@v4

      - name: Set up QEMU
-        uses: docker/setup-qemu-action@v3
+        uses: docker/setup-qemu-action@v4

      - name: Log in to Docker Hub
        uses: docker/login-action@v3
@@ -62,11 +62,11 @@ jobs:
          password: ${{ secrets.DOCKERHUB_TOKEN }}

      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
+        uses: docker/setup-buildx-action@v4

      - name: Log in to GitHub Container Registry
        if: github.event_name != 'pull_request'
-        uses: docker/login-action@v3
+        uses: docker/login-action@v4
        with:
          registry: ${{ env.REGISTRY }}
          username: ${{ github.actor }}
@@ -74,7 +74,7 @@ jobs:

      - name: Extract metadata
        id: meta
-        uses: docker/metadata-action@v5
+        uses: docker/metadata-action@v6
        with:
          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
          tags: |
@@ -85,7 +85,7 @@ jobs:
            type=raw,value=latest,enable={{is_default_branch}}

      - name: Build and push Docker image
-        uses: docker/build-push-action@v5
+        uses: docker/build-push-action@v7
        with:
          context: .
          file: ./Dockerfile
@@ -109,7 +109,7 @@ jobs:
        uses: actions/checkout@v4

      - name: Log in to GitHub Container Registry
-        uses: docker/login-action@v3
+        uses: docker/login-action@v4
        with:
          registry: ${{ env.REGISTRY }}
          username: ${{ github.actor }}
@@ -167,7 +167,7 @@ jobs:
        uses: actions/checkout@v4

      - name: Create Release
-        uses: softprops/action-gh-release@v1
+        uses: softprops/action-gh-release@v2
        with:
          generate_release_notes: true
          body: |
--- a/.github/workflows/docker-build.yml
+++ b/.github/workflows/docker-build.yml
@@ -78,15 +78,15 @@ jobs:
          password: ${{ secrets.DOCKERHUB_TOKEN }}

      - name: Set up QEMU
-        uses: docker/setup-qemu-action@v3
+        uses: docker/setup-qemu-action@v4

      - name: Set up Docker Buildx
        id: buildx
-        uses: docker/setup-buildx-action@v3
+        uses: docker/setup-buildx-action@v4

      - name: Log in to GitHub Container Registry
        if: github.event_name != 'pull_request'
-        uses: docker/login-action@v3
+        uses: docker/login-action@v4
        with:
          registry: ${{ env.REGISTRY }}
          username: ${{ github.actor }}
@@ -94,7 +94,7 @@ jobs:

      - name: Extract metadata
        id: meta
-        uses: docker/metadata-action@v5
+        uses: docker/metadata-action@v6
        with:
          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
          tags: |
@@ -107,7 +107,7 @@ jobs:
            type=raw,value=latest,enable={{is_default_branch}}
            
      - name: Build and push Docker image
-        uses: docker/build-push-action@v5
+        uses: docker/build-push-action@v7
        with:
          context: .
          no-cache: false
@@ -186,15 +186,15 @@ jobs:
          password: ${{ secrets.DOCKERHUB_TOKEN }}

      - name: Set up QEMU
-        uses: docker/setup-qemu-action@v3
+        uses: docker/setup-qemu-action@v4

      - name: Set up Docker Buildx
        id: buildx
-        uses: docker/setup-buildx-action@v3
+        uses: docker/setup-buildx-action@v4

      - name: Log in to GitHub Container Registry
        if: github.event_name != 'pull_request'
-        uses: docker/login-action@v3
+        uses: docker/login-action@v4
        with:
          registry: ${{ env.REGISTRY }}
          username: ${{ github.actor }}
@@ -202,7 +202,7 @@ jobs:
          
      - name: Extract metadata for Railway
        id: meta-railway
-        uses: docker/metadata-action@v5
+        uses: docker/metadata-action@v6
        with:
          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}-railway
          tags: |
@@ -215,7 +215,7 @@ jobs:
            type=raw,value=latest,enable={{is_default_branch}}
            
      - name: Build and push Railway Docker image
-        uses: docker/build-push-action@v5
+        uses: docker/build-push-action@v7
        with:
          context: .
          file: ./Dockerfile.railway
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -389,7 +389,7 @@ jobs:
          echo "Version: $(node -e "console.log(require('./package.json').version)")"
      
      - name: Publish to NPM with retry
-        uses: nick-invision/retry@v2
+        uses: nick-invision/retry@v4
        with:
          timeout_minutes: 5
          max_attempts: 3
@@ -448,13 +448,13 @@ jobs:
          password: ${{ secrets.DOCKERHUB_TOKEN }}

      - name: Set up QEMU
-        uses: docker/setup-qemu-action@v3
+        uses: docker/setup-qemu-action@v4

      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
+        uses: docker/setup-buildx-action@v4

      - name: Log in to GitHub Container Registry
-        uses: docker/login-action@v3
+        uses: docker/login-action@v4
        with:
          registry: ${{ env.REGISTRY }}
          username: ${{ github.actor }}
@@ -462,7 +462,7 @@ jobs:
      
      - name: Extract metadata for standard image
        id: meta
-        uses: docker/metadata-action@v5
+        uses: docker/metadata-action@v6
        with:
          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}
          tags: |
@@ -472,7 +472,7 @@ jobs:
            type=raw,value=latest,enable={{is_default_branch}}
      
      - name: Build and push standard Docker image
-        uses: docker/build-push-action@v5
+        uses: docker/build-push-action@v7
        with:
          context: .
          platforms: linux/amd64,linux/arm64
@@ -553,7 +553,7 @@ jobs:

      - name: Extract metadata for Railway image
        id: meta-railway
-        uses: docker/metadata-action@v5
+        uses: docker/metadata-action@v6
        with:
          images: ${{ env.REGISTRY }}/${{ env.IMAGE_NAME }}-railway
          tags: |
@@ -563,7 +563,7 @@ jobs:
            type=raw,value=latest,enable={{is_default_branch}}
      
      - name: Build and push Railway Docker image
-        uses: docker/build-push-action@v5
+        uses: docker/build-push-action@v7
        with:
          context: .
          file: ./Dockerfile.railway
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -116,7 +116,7 @@ jobs:
      # Upload coverage to Codecov
      - name: Upload coverage to Codecov
        if: always()
-        uses: codecov/codecov-action@v4
+        uses: codecov/codecov-action@v5
        with:
          token: ${{ secrets.CODECOV_TOKEN }}
          files: ./coverage/lcov.info
@@ -250,7 +250,7 @@ jobs:
          path: artifacts

      - name: Publish test results
-        uses: dorny/test-reporter@v1
+        uses: dorny/test-reporter@v3
        if: always()
        continue-on-error: true
        with:
--- a/.github/workflows/update-n8n-deps.yml
+++ b/.github/workflows/update-n8n-deps.yml
@@ -129,7 +129,7 @@ jobs:
      
      - name: Create Pull Request
        if: steps.branch.outputs.branch_name != ''
-        uses: peter-evans/create-pull-request@v5
+        uses: peter-evans/create-pull-request@v8
        with:
          token: ${{ secrets.GITHUB_TOKEN }}
          branch: ${{ steps.branch.outputs.branch_name }}
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,50 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

 ## [Unreleased]

+## [2.45.0] - 2026-04-01
+
+### Changed
+
+- **Update n8n dependencies** to latest versions:
+  - `n8n`: 2.13.3 → 2.14.2
+  - `n8n-core`: 2.13.1 → 2.14.1
+  - `n8n-workflow`: 2.13.1 → 2.14.1
+  - `@n8n/n8n-nodes-langchain`: 2.13.1 → 2.14.1
+- **Rebuild FTS5 search index** with all 1396 nodes (812 base + 584 community)
+
+Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en
+
+## [2.44.1] - 2026-04-01
+
+### Security
+
+- **Bump axios** from `^1.11.0` to `^1.14.0` to patch known vulnerability
+- **Bump nodemon** from `^3.1.10` to `^3.1.14` to patch transitive dependency vulnerabilities
+
+### Changed
+
+- **Upgrade GitHub Actions** to latest versions across all CI/CD workflows (docker, release, test, update-n8n-deps) — contributed by @salmanmkc in #663
+
+Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en
+
+## [2.44.0] - 2026-04-01
+
+### Added
+
+- **Multi-step workflow generation flow**: `n8n_generate_workflow` now supports a three-step flow where AI agents act as quality gates — get proposals, review, then deploy. New parameters: `deploy_id` (deploy a specific proposal), `confirm_deploy` (deploy a previously generated preview).
+
+- **`GenerateWorkflowProposal` type**: New exported type for workflow proposals with `id`, `name`, `description`, `flow_summary`, and `credentials_needed` fields.
+
+- **`status` field on `GenerateWorkflowResult`**: Indicates the current phase — `proposals`, `preview`, `deployed`, or `error`.
+
+### Changed
+
+- **Tool description updated**: `n8n_generate_workflow` description now explains the multi-step flow instead of auto-deploy behavior.
+
+- **Tool documentation updated**: Essentials and full docs reflect the three-step flow with examples for each step.
+
+Conceived by Romuald Członkowski - https://www.aiadvisors.pl/en
+
 ## [2.43.0] - 2026-03-31

 ### Added
--- a/README.md
+++ b/README.md
@@ -5,7 +5,7 @@
 [![npm version](https://img.shields.io/npm/v/n8n-mcp.svg)](https://www.npmjs.com/package/n8n-mcp)
 [![codecov](https://codecov.io/gh/czlonkowski/n8n-mcp/graph/badge.svg?token=YOUR_TOKEN)](https://codecov.io/gh/czlonkowski/n8n-mcp)
 [![Tests](https://img.shields.io/badge/tests-3336%20passing-brightgreen.svg)](https://github.com/czlonkowski/n8n-mcp/actions)
-[![n8n version](https://img.shields.io/badge/n8n-2.13.3-orange.svg)](https://github.com/n8n-io/n8n)
+[![n8n version](https://img.shields.io/badge/n8n-2.14.2-orange.svg)](https://github.com/n8n-io/n8n)
 [![Docker](https://img.shields.io/badge/docker-ghcr.io%2Fczlonkowski%2Fn8n--mcp-green.svg)](https://github.com/czlonkowski/n8n-mcp/pkgs/container/n8n-mcp)
 [![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/n8n-mcp?referralCode=n8n-mcp)

--- a/data/nodes.db
+++ b/data/nodes.db
--- a/dist/index.d.ts
+++ b/dist/index.d.ts
@@ -5,7 +5,7 @@ export { N8NDocumentationMCPServer } from './mcp/server';
 export type { InstanceContext } from './types/instance-context';
 export { validateInstanceContext, isInstanceContext } from './types/instance-context';
 export type { SessionState } from './types/session-state';
-export type { GenerateWorkflowArgs, GenerateWorkflowResult, GenerateWorkflowHandler, GenerateWorkflowHelpers } from './types/generate-workflow';
+export type { GenerateWorkflowArgs, GenerateWorkflowResult, GenerateWorkflowProposal, GenerateWorkflowHandler, GenerateWorkflowHelpers } from './types/generate-workflow';
 export type { UIAppConfig, UIMetadata } from './mcp/ui/types';
 export { UI_APP_CONFIGS } from './mcp/ui/app-configs';
 export type { Tool, CallToolResult, ListToolsResult } from '@modelcontextprotocol/sdk/types.js';
--- a/dist/index.d.ts.map
+++ b/dist/index.d.ts.map
@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAGzD,YAAY,EACV,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,YAAY,EACb,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,2BAA2B,CAAC;AAGnC,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,YAAY,EACV,IAAI,EACJ,cAAc,EACd,eAAe,EAChB,MAAM,oCAAoC,CAAC;AAG5C,OAAO,YAAY,MAAM,cAAc,CAAC;AACxC,eAAe,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAGzD,YAAY,EACV,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,YAAY,EACb,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,oBAAoB,EACpB,sBAAsB,EACtB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,2BAA2B,CAAC;AAGnC,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,YAAY,EACV,IAAI,EACJ,cAAc,EACd,eAAe,EAChB,MAAM,oCAAoC,CAAC;AAG5C,OAAO,YAAY,MAAM,cAAc,CAAC;AACxC,eAAe,YAAY,CAAC"}
--- a/dist/index.js.map
+++ b/dist/index.js.map
@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAOA,2CAAyE;AAAhE,0GAAA,YAAY,OAAA;AACrB,2EAAuE;AAA9D,qIAAA,uBAAuB,OAAA;AAChC,2DAAyD;AAAhD,iHAAA,cAAc,OAAA;AACvB,uCAAyD;AAAhD,mHAAA,yBAAyB,OAAA;AAMlC,6DAGkC;AAFhC,2HAAA,uBAAuB,OAAA;AACvB,qHAAA,iBAAiB,OAAA;AAcnB,oDAAsD;AAA7C,6GAAA,cAAc,OAAA;AAUvB,8DAAwC;AACxC,kBAAe,oBAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAOA,2CAAyE;AAAhE,0GAAA,YAAY,OAAA;AACrB,2EAAuE;AAA9D,qIAAA,uBAAuB,OAAA;AAChC,2DAAyD;AAAhD,iHAAA,cAAc,OAAA;AACvB,uCAAyD;AAAhD,mHAAA,yBAAyB,OAAA;AAMlC,6DAGkC;AAFhC,2HAAA,uBAAuB,OAAA;AACvB,qHAAA,iBAAiB,OAAA;AAenB,oDAAsD;AAA7C,6GAAA,cAAc,OAAA;AAUvB,8DAAwC;AACxC,kBAAe,oBAAY,CAAC"}
--- a/dist/mcp/server.d.ts.map
+++ b/dist/mcp/server.d.ts.map
@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}
--- a/dist/mcp/server.js
+++ b/dist/mcp/server.js
@@ -1156,7 +1156,7 @@ class N8NDocumentationMCPServer {
                        getWorkflow: (id) => n8nHandlers.handleGetWorkflow({ id }, ctx),
                    };
                    try {
-                        const result = await this.generateWorkflowHandler({ description: args.description, skip_cache: args.skip_cache }, ctx, helpers);
+                        const result = await this.generateWorkflowHandler(args, ctx, helpers);
                        return result ?? { success: false, error: 'Handler returned no result' };
                    }
                    catch (err) {
--- a/dist/mcp/server.js.map
+++ b/dist/mcp/server.js.map
--- a/dist/mcp/tools-n8n-manager.d.ts.map
+++ b/dist/mcp/tools-n8n-manager.d.ts.map
@@ -1 +1 @@
-{"version":3,"file":"tools-n8n-manager.d.ts","sourceRoot":"","sources":["../../src/mcp/tools-n8n-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAQ1C,eAAO,MAAM,kBAAkB,EAAE,cAAc,EAsqB9C,CAAC"}
+{"version":3,"file":"tools-n8n-manager.d.ts","sourceRoot":"","sources":["../../src/mcp/tools-n8n-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAQ1C,eAAO,MAAM,kBAAkB,EAAE,cAAc,EAgrB9C,CAAC"}
--- a/dist/mcp/tools-n8n-manager.js
+++ b/dist/mcp/tools-n8n-manager.js
@@ -638,9 +638,10 @@ exports.n8nManagementTools = [
    {
        name: 'n8n_generate_workflow',
        description: 'Generate an n8n workflow from a natural language description using AI. ' +
-            'Describe what the workflow should do (trigger type, services, logic) and this tool ' +
-            'will create and deploy a ready-to-use workflow to your n8n instance. ' +
-            'Set skip_cache=true to force fresh generation instead of using pre-built templates.',
+            'Call with just a description to get workflow proposals. ' +
+            'Then call again with deploy_id to deploy a chosen proposal, ' +
+            'or set skip_cache=true to generate a fresh workflow. ' +
+            'Use confirm_deploy=true to deploy a previously generated workflow.',
        inputSchema: {
            type: 'object',
            properties: {
@@ -651,8 +652,17 @@ exports.n8nManagementTools = [
                },
                skip_cache: {
                    type: 'boolean',
-                    description: 'Set to true to bypass the workflow cache and force fresh AI generation. ' +
-                        'Default: false (uses cached workflows when a good match exists).'
+                    description: 'Set to true to skip proposals and generate a fresh workflow from scratch. ' +
+                        'Returns a preview — call again with confirm_deploy=true to deploy it.'
+                },
+                deploy_id: {
+                    type: 'string',
+                    description: 'ID of a proposal to deploy. Get proposal IDs from a previous call ' +
+                        'that returned status "proposals".'
+                },
+                confirm_deploy: {
+                    type: 'boolean',
+                    description: 'Set to true to deploy the workflow from the last generation preview.'
                }
            },
            required: ['description'],
--- a/dist/mcp/tools-n8n-manager.js.map
+++ b/dist/mcp/tools-n8n-manager.js.map
--- a/package-lock.json
+++ b/package-lock.json
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
  "name": "n8n-mcp",
-  "version": "2.43.0",
+  "version": "2.45.0",
  "description": "Integration between n8n workflow automation and Model Context Protocol (MCP)",
  "main": "dist/index.js",
  "types": "dist/index.d.ts",
@@ -140,27 +140,27 @@
    "@vitest/coverage-v8": "^3.2.4",
    "@vitest/runner": "^3.2.4",
    "@vitest/ui": "^3.2.4",
-    "axios": "^1.11.0",
+    "axios": "^1.14.0",
    "axios-mock-adapter": "^2.1.0",
    "fishery": "^2.3.1",
    "msw": "^2.10.4",
-    "nodemon": "^3.1.10",
+    "nodemon": "^3.1.14",
    "ts-node": "^10.9.2",
    "typescript": "^5.8.3",
    "vitest": "^3.2.4"
  },
  "dependencies": {
    "@modelcontextprotocol/sdk": "1.28.0",
-    "@n8n/n8n-nodes-langchain": "^2.13.1",
+    "@n8n/n8n-nodes-langchain": "^2.14.1",
    "@supabase/supabase-js": "^2.57.4",
    "dotenv": "^16.5.0",
    "express": "^5.1.0",
    "express-rate-limit": "^7.1.5",
    "form-data": "^4.0.5",
    "lru-cache": "^11.2.1",
-    "n8n": "^2.13.3",
-    "n8n-core": "^2.13.1",
-    "n8n-workflow": "^2.13.1",
+    "n8n": "^2.14.2",
+    "n8n-core": "^2.14.1",
+    "n8n-workflow": "^2.14.1",
    "openai": "^4.77.0",
    "sql.js": "^1.13.0",
    "tslib": "^2.6.2",
--- a/package.runtime.json
+++ b/package.runtime.json
@@ -1,6 +1,6 @@
 {
  "name": "n8n-mcp-runtime",
-  "version": "2.33.2",
+  "version": "2.45.0",
  "description": "n8n MCP Server Runtime Dependencies Only",
  "private": true,
  "dependencies": {
--- a/src/index.ts
+++ b/src/index.ts
@@ -24,6 +24,7 @@ export type {
 export type {
  GenerateWorkflowArgs,
  GenerateWorkflowResult,
+  GenerateWorkflowProposal,
  GenerateWorkflowHandler,
  GenerateWorkflowHelpers
 } from './types/generate-workflow';
--- a/src/mcp/server.ts
+++ b/src/mcp/server.ts
@@ -1561,11 +1561,7 @@ export class N8NDocumentationMCPServer {
          };

          try {
-            const result = await this.generateWorkflowHandler(
-              { description: args.description, skip_cache: args.skip_cache },
-              ctx,
-              helpers
-            );
+            const result = await this.generateWorkflowHandler(args, ctx, helpers);
            return result ?? { success: false, error: 'Handler returned no result' };
          } catch (err: any) {
            const message = err instanceof Error ? err.message : String(err);
--- a/src/mcp/tool-docs/workflow_management/n8n-generate-workflow.ts
+++ b/src/mcp/tool-docs/workflow_management/n8n-generate-workflow.ts
@@ -4,58 +4,84 @@ export const n8nGenerateWorkflowDoc: ToolDocumentation = {
  name: 'n8n_generate_workflow',
  category: 'workflow_management',
  essentials: {
-    description: 'Generate an n8n workflow from a natural language description using AI. Creates and deploys a ready-to-use workflow to your n8n instance.',
-    keyParameters: ['description', 'skip_cache'],
+    description: 'Generate workflows from natural language. Three-step flow:\n' +
+      '1. Call with description → get proposals\n' +
+      '2. Call with deploy_id → deploy a proposal, OR skip_cache=true → fresh generation preview\n' +
+      '3. Call with confirm_deploy=true → deploy the preview',
+    keyParameters: ['description', 'skip_cache', 'deploy_id', 'confirm_deploy'],
    example: 'n8n_generate_workflow({description: "Send a Slack message every morning at 9am"})',
    performance: 'Network-dependent (2-15s depending on cache hit vs fresh generation)',
    tips: [
      'Include trigger type (webhook, schedule, manual) in the description',
      'Mention specific services to integrate (Slack, Gmail, Google Sheets, etc.)',
-      'Use skip_cache=true to force fresh AI generation instead of cached templates',
+      'Review proposals before deploying — use deploy_id to pick one',
+      'Use skip_cache=true to generate fresh, then confirm_deploy=true to deploy',
      'Available exclusively on the hosted version of n8n-mcp'
    ]
  },
  full: {
-    description: 'Generates an n8n workflow from a natural language description using AI. On the hosted service, this tool first searches a cache of 73,000+ pre-built workflows for a match, and falls back to AI-powered fresh generation for custom workflows. Generated workflows are automatically validated and error-corrected before deployment. On self-hosted instances, this tool returns a message directing users to the hosted service.',
+    description: 'Generates n8n workflows from natural language using a multi-step flow. ' +
+      'Step 1: Call with description to get up to 5 proposals (not deployed). ' +
+      'Step 2a: Call with deploy_id to deploy a chosen proposal. ' +
+      'Step 2b: Call with skip_cache=true to generate a fresh workflow (returns preview, not deployed). ' +
+      'Step 3: Call with confirm_deploy=true to deploy the preview. ' +
+      'On self-hosted instances, returns a message directing users to the hosted service.',
    parameters: {
      description: { type: 'string', required: true, description: 'Clear description of what the workflow should do. Include: trigger type (webhook, schedule, manual), services to integrate (Slack, Gmail, etc.), and the logic/flow.' },
-      skip_cache: { type: 'boolean', description: 'Set to true to bypass the workflow cache and force fresh AI generation. Default: false (uses cached workflows when a good match exists).' }
+      skip_cache: { type: 'boolean', description: 'Set to true to skip proposals and generate a fresh workflow from scratch. Returns a preview — call again with confirm_deploy=true to deploy it.' },
+      deploy_id: { type: 'string', description: 'ID of a proposal to deploy. Get proposal IDs from a previous call that returned status "proposals".' },
+      confirm_deploy: { type: 'boolean', description: 'Set to true to deploy the workflow from the last generation preview.' }
    },
-    returns: 'Object with success, source (cache/generated), workflow_id, workflow_name, workflow_url, node_count, node_summary, and message. On self-hosted instances, returns hosted_only: true with information about the hosted service.',
+    returns: 'Object with success, status (proposals/preview/deployed/error), and context-dependent fields. ' +
+      'For proposals: proposals[] with id, name, description, flow_summary, credentials_needed. ' +
+      'For preview: workflow structure details. ' +
+      'For deployed: workflow_id, workflow_name, workflow_url, node_count, node_summary. ' +
+      'On self-hosted instances, returns hosted_only: true.',
    examples: [
-      `// Generate a simple scheduled workflow
+      `// Step 1: Get proposals
 n8n_generate_workflow({
  description: "Send a Slack message every morning at 9am with a daily standup reminder"
-})`,
-      `// Generate with specific services
+})
+// Returns: { status: "proposals", proposals: [{ id: "uuid-1", name: "...", ... }, ...] }`,
+      `// Step 2a: Deploy a chosen proposal
 n8n_generate_workflow({
-  description: "When a new row is added to Google Sheets, create a task in Notion and notify via email"
-})`,
-      `// Force fresh generation (skip cache)
+  description: "Send a Slack message every morning at 9am",
+  deploy_id: "uuid-1"
+})
+// Returns: { status: "deployed", workflow_id: "123", ... }`,
+      `// Step 2b: Fresh generation (skip cache)
 n8n_generate_workflow({
  description: "Webhook that receives JSON data, transforms it, and posts to a REST API",
  skip_cache: true
-})`
+})
+// Returns: { status: "preview", ... }`,
+      `// Step 3: Deploy the preview
+n8n_generate_workflow({
+  description: "Webhook that receives JSON data, transforms it, and posts to a REST API",
+  confirm_deploy: true
+})
+// Returns: { status: "deployed", workflow_id: "456", ... }`
    ],
    useCases: [
      'Quickly create workflows from natural language descriptions',
-      'Generate complex multi-service integrations',
-      'Bootstrap automation projects with AI-generated workflows',
+      'Review proposals before deploying to maintain quality',
+      'Generate complex multi-service integrations with agent oversight',
      'Create workflows without deep knowledge of n8n node configuration'
    ],
-    performance: 'Cache hit: ~2s. Fresh generation: 5-15s. Both within typical MCP client timeout.',
+    performance: 'Proposals: ~2s. Fresh generation: 5-15s. Deploy: ~3s. All within typical MCP client timeout.',
    bestPractices: [
      'Be specific about trigger type and services in the description',
-      'Review generated workflows before activating',
-      'Use n8n_validate_workflow to check the generated workflow',
-      'Configure credentials in n8n UI before activating',
-      'Use skip_cache only when cached results do not match your needs'
+      'Review proposals before deploying — pick the best match with deploy_id',
+      'Use skip_cache only when proposals do not match your needs',
+      'After deployment, use n8n_validate_workflow to verify the result',
+      'Configure credentials in n8n UI before activating'
    ],
    pitfalls: [
      '**Hosted-only feature** — self-hosted instances receive a redirect message',
+      'Proposals are NOT deployed — you must call again with deploy_id or confirm_deploy',
      'Generated workflows are created in INACTIVE state',
      'Credentials must be configured manually in the n8n UI',
-      'Complex workflows may need manual adjustments after generation'
+      'Session state for pending proposals/preview is per MCP session'
    ],
    relatedTools: ['n8n_create_workflow', 'n8n_deploy_template', 'n8n_validate_workflow', 'n8n_autofix_workflow', 'search_templates']
  }
--- a/src/mcp/tools-n8n-manager.ts
+++ b/src/mcp/tools-n8n-manager.ts
@@ -657,9 +657,10 @@ export const n8nManagementTools: ToolDefinition[] = [
  {
    name: 'n8n_generate_workflow',
    description: 'Generate an n8n workflow from a natural language description using AI. ' +
-      'Describe what the workflow should do (trigger type, services, logic) and this tool ' +
-      'will create and deploy a ready-to-use workflow to your n8n instance. ' +
-      'Set skip_cache=true to force fresh generation instead of using pre-built templates.',
+      'Call with just a description to get workflow proposals. ' +
+      'Then call again with deploy_id to deploy a chosen proposal, ' +
+      'or set skip_cache=true to generate a fresh workflow. ' +
+      'Use confirm_deploy=true to deploy a previously generated workflow.',
    inputSchema: {
      type: 'object',
      properties: {
@@ -670,8 +671,17 @@ export const n8nManagementTools: ToolDefinition[] = [
        },
        skip_cache: {
          type: 'boolean',
-          description: 'Set to true to bypass the workflow cache and force fresh AI generation. ' +
-            'Default: false (uses cached workflows when a good match exists).'
+          description: 'Set to true to skip proposals and generate a fresh workflow from scratch. ' +
+            'Returns a preview — call again with confirm_deploy=true to deploy it.'
+        },
+        deploy_id: {
+          type: 'string',
+          description: 'ID of a proposal to deploy. Get proposal IDs from a previous call ' +
+            'that returned status "proposals".'
+        },
+        confirm_deploy: {
+          type: 'boolean',
+          description: 'Set to true to deploy the workflow from the last generation preview.'
        }
      },
      required: ['description'],
--- a/src/types/generate-workflow.ts
+++ b/src/types/generate-workflow.ts
@@ -3,11 +3,23 @@ import { InstanceContext } from './instance-context';
 export interface GenerateWorkflowArgs {
  description: string;
  skip_cache?: boolean;
+  deploy_id?: string;
+  confirm_deploy?: boolean;
+}
+
+export interface GenerateWorkflowProposal {
+  id: string;
+  name: string;
+  description: string;
+  flow_summary: string;
+  credentials_needed: string[];
 }

 export interface GenerateWorkflowResult {
  success: boolean;
  source?: 'cache' | 'generated';
+  status?: 'proposals' | 'preview' | 'deployed' | 'error';
+  proposals?: GenerateWorkflowProposal[];
  workflow_id?: string;
  workflow_name?: string;
  workflow_url?: string;
--- a/tests/unit/mcp/generate-workflow-tool.test.ts
+++ b/tests/unit/mcp/generate-workflow-tool.test.ts
@@ -4,6 +4,7 @@ import type {
  GenerateWorkflowHandler,
  GenerateWorkflowArgs,
  GenerateWorkflowResult,
+  GenerateWorkflowProposal,
  GenerateWorkflowHelpers,
 } from '@/types/generate-workflow';

@@ -18,6 +19,8 @@ describe('n8n_generate_workflow', () => {
    it('has correct input schema', () => {
      expect(tool!.inputSchema.properties).toHaveProperty('description');
      expect(tool!.inputSchema.properties).toHaveProperty('skip_cache');
+      expect(tool!.inputSchema.properties).toHaveProperty('deploy_id');
+      expect(tool!.inputSchema.properties).toHaveProperty('confirm_deploy');
      expect(tool!.inputSchema.required).toEqual(['description']);
    });

@@ -78,13 +81,69 @@ describe('n8n_generate_workflow', () => {
      expect(failure.success).toBe(false);
    });

-    it('GenerateWorkflowArgs has description and optional skip_cache', () => {
+    it('GenerateWorkflowResult supports proposal status', () => {
+      const proposals: GenerateWorkflowResult = {
+        success: true,
+        status: 'proposals',
+        proposals: [
+          {
+            id: 'uuid-1',
+            name: 'Slack Reminder',
+            description: 'Send scheduled Slack messages',
+            flow_summary: 'Schedule Trigger → Set → Slack',
+            credentials_needed: ['slackApi'],
+          },
+        ],
+      };
+      expect(proposals.status).toBe('proposals');
+      expect(proposals.proposals).toHaveLength(1);
+      expect(proposals.proposals![0].id).toBe('uuid-1');
+    });
+
+    it('GenerateWorkflowResult supports preview and deployed status', () => {
+      const preview: GenerateWorkflowResult = {
+        success: true,
+        status: 'preview',
+        node_summary: 'Webhook → HTTP Request → Slack',
+      };
+      expect(preview.status).toBe('preview');
+
+      const deployed: GenerateWorkflowResult = {
+        success: true,
+        status: 'deployed',
+        workflow_id: '123',
+        workflow_name: 'My Workflow',
+      };
+      expect(deployed.status).toBe('deployed');
+    });
+
+    it('GenerateWorkflowProposal has required fields', () => {
+      const proposal: GenerateWorkflowProposal = {
+        id: 'uuid-123',
+        name: 'Test Workflow',
+        description: 'A test workflow',
+        flow_summary: 'Trigger → Action',
+        credentials_needed: ['slackApi', 'gmailOAuth2'],
+      };
+      expect(proposal.id).toBe('uuid-123');
+      expect(proposal.credentials_needed).toHaveLength(2);
+    });
+
+    it('GenerateWorkflowArgs has description and optional fields', () => {
      const minimal: GenerateWorkflowArgs = { description: 'test' };
      expect(minimal.description).toBe('test');
      expect(minimal.skip_cache).toBeUndefined();
+      expect(minimal.deploy_id).toBeUndefined();
+      expect(minimal.confirm_deploy).toBeUndefined();

      const withSkip: GenerateWorkflowArgs = { description: 'test', skip_cache: true };
      expect(withSkip.skip_cache).toBe(true);
+
+      const withDeploy: GenerateWorkflowArgs = { description: 'test', deploy_id: 'uuid-1' };
+      expect(withDeploy.deploy_id).toBe('uuid-1');
+
+      const withConfirm: GenerateWorkflowArgs = { description: 'test', confirm_deploy: true };
+      expect(withConfirm.confirm_deploy).toBe(true);
    });
  });
 });