n8n 2.11.2 → 2.12.0

package/dist/modules/mcp/tools/workflow-builder/delete-workflow.tool.js

@@ -0,0 +1,75 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createArchiveWorkflowTool = void 0;
+const zod_1 = __importDefault(require("zod"));
+const mcp_constants_1 = require("../../mcp.constants");
+const constants_1 = require("./constants");
+const inputSchema = {
+    workflowId: zod_1.default.string().describe('The ID of the workflow to archive'),
+};
+const outputSchema = {
+    archived: zod_1.default.boolean().describe('Whether the workflow was archived'),
+    workflowId: zod_1.default.string().describe('The ID of the archived workflow'),
+    name: zod_1.default.string().describe('The name of the archived workflow'),
+};
+const createArchiveWorkflowTool = (user, workflowService, telemetry) => ({
+    name: constants_1.MCP_ARCHIVE_WORKFLOW_TOOL.toolName,
+    config: {
+        description: 'Archive a workflow in n8n by its ID.',
+        inputSchema,
+        outputSchema,
+        annotations: {
+            title: constants_1.MCP_ARCHIVE_WORKFLOW_TOOL.displayTitle,
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    handler: async ({ workflowId }) => {
+        const telemetryPayload = {
+            user_id: user.id,
+            tool_name: constants_1.MCP_ARCHIVE_WORKFLOW_TOOL.toolName,
+            parameters: { workflowId },
+        };
+        try {
+            const workflow = await workflowService.archive(user, workflowId, { skipArchived: true });
+            if (!workflow) {
+                throw new Error("Workflow not found or you don't have permission to archive it.");
+            }
+            telemetryPayload.results = {
+                success: true,
+                data: { workflowId },
+            };
+            telemetry.track(mcp_constants_1.USER_CALLED_MCP_TOOL_EVENT, telemetryPayload);
+            const output = {
+                archived: true,
+                workflowId,
+                name: workflow.name,
+            };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
+                structuredContent: output,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            telemetryPayload.results = {
+                success: false,
+                error: errorMessage,
+            };
+            telemetry.track(mcp_constants_1.USER_CALLED_MCP_TOOL_EVENT, telemetryPayload);
+            const output = { error: errorMessage };
+            return {
+                content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
+                structuredContent: output,
+                isError: true,
+            };
+        }
+    },
+});
+exports.createArchiveWorkflowTool = createArchiveWorkflowTool;
+//# sourceMappingURL=delete-workflow.tool.js.map

package/dist/modules/mcp/tools/workflow-builder/delete-workflow.tool.js.map

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

package/dist/modules/mcp/tools/workflow-builder/get-suggested-workflow-nodes.tool.d.ts

@@ -0,0 +1,10 @@
+import type { User } from '@n8n/db';
+import z from 'zod';
+import type { ToolDefinition } from '../../mcp.types';
+import type { Telemetry } from '../../../../telemetry';
+import type { WorkflowBuilderToolsService } from './workflow-builder-tools.service';
+declare const inputSchema: {
+    categories: z.ZodArray<z.ZodString, "many">;
+};
+export declare const createGetSuggestedWorkflowNodesTool: (user: User, workflowBuilderToolsService: WorkflowBuilderToolsService, telemetry: Telemetry) => ToolDefinition<typeof inputSchema>;
+export {};

package/dist/modules/mcp/tools/workflow-builder/get-suggested-workflow-nodes.tool.js

@@ -0,0 +1,100 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGetSuggestedWorkflowNodesTool = void 0;
+const zod_1 = __importDefault(require("zod"));
+const mcp_constants_1 = require("../../mcp.constants");
+const constants_1 = require("./constants");
+const inputSchema = {
+    categories: zod_1.default
+        .array(zod_1.default.string())
+        .min(1)
+        .describe('Workflow technique categories. Available: chatbot, notification, scheduling, data_transformation, data_persistence, data_extraction, document_processing, form_input, content_generation, triage, scraping_and_research'),
+};
+const outputSchema = {
+    suggestions: zod_1.default
+        .string()
+        .describe('Curated node recommendations with pattern hints and configuration guidance'),
+};
+const createGetSuggestedWorkflowNodesTool = (user, workflowBuilderToolsService, telemetry) => ({
+    name: constants_1.CODE_BUILDER_GET_SUGGESTED_NODES_TOOL.toolName,
+    config: {
+        description: 'Get curated node recommendations for workflow technique categories. Returns recommended nodes with pattern hints and configuration guidance. Use after analyzing what kind of workflow to build.',
+        inputSchema,
+        outputSchema,
+        annotations: {
+            title: constants_1.CODE_BUILDER_GET_SUGGESTED_NODES_TOOL.displayTitle,
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    handler: async ({ categories }) => {
+        const telemetryPayload = {
+            user_id: user.id,
+            tool_name: constants_1.CODE_BUILDER_GET_SUGGESTED_NODES_TOOL.toolName,
+            parameters: { categories },
+        };
+        try {
+            const { createGetSuggestedNodesTool } = await Promise.resolve().then(() => __importStar(require('@n8n/ai-workflow-builder')));
+            const nodeTypeParser = workflowBuilderToolsService.getNodeTypeParser();
+            const suggestTool = createGetSuggestedNodesTool(nodeTypeParser);
+            const result = await suggestTool.invoke({ categories });
+            telemetryPayload.results = {
+                success: true,
+                data: { categoryCount: categories.length },
+            };
+            telemetry.track(mcp_constants_1.USER_CALLED_MCP_TOOL_EVENT, telemetryPayload);
+            return {
+                content: [{ type: 'text', text: result }],
+                structuredContent: { suggestions: result },
+            };
+        }
+        catch (error) {
+            telemetryPayload.results = {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+            telemetry.track(mcp_constants_1.USER_CALLED_MCP_TOOL_EVENT, telemetryPayload);
+            throw error;
+        }
+    },
+});
+exports.createGetSuggestedWorkflowNodesTool = createGetSuggestedWorkflowNodesTool;
+//# sourceMappingURL=get-suggested-workflow-nodes.tool.js.map

package/dist/modules/mcp/tools/workflow-builder/get-suggested-workflow-nodes.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-suggested-workflow-nodes.tool.js","sourceRoot":"","sources":["../../../../../src/modules/mcp/tools/workflow-builder/get-suggested-workflow-nodes.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,8CAAoB;AAEpB,uDAAiE;AAKjE,2CAAoE;AAGpE,MAAM,WAAW,GAAG;IACnB,UAAU,EAAE,aAAC;SACX,KAAK,CAAC,aAAC,CAAC,MAAM,EAAE,CAAC;SACjB,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACR,yNAAyN,CACzN;CACsB,CAAC;AAE1B,MAAM,YAAY,GAAG;IACpB,WAAW,EAAE,aAAC;SACZ,MAAM,EAAE;SACR,QAAQ,CAAC,4EAA4E,CAAC;CAChE,CAAC;AAKnB,MAAM,mCAAmC,GAAG,CAClD,IAAU,EACV,2BAAwD,EACxD,SAAoB,EACiB,EAAE,CAAC,CAAC;IACzC,IAAI,EAAE,iDAAqC,CAAC,QAAQ;IACpD,MAAM,EAAE;QACP,WAAW,EACV,kMAAkM;QACnM,WAAW;QACX,YAAY;QACZ,WAAW,EAAE;YACZ,KAAK,EAAE,iDAAqC,CAAC,YAAY;YACzD,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACpB;KACD;IACD,OAAO,EAAE,KAAK,EAAE,EAAE,UAAU,EAA4B,EAAE,EAAE;QAC3D,MAAM,gBAAgB,GAAkC;YACvD,OAAO,EAAE,IAAI,CAAC,EAAE;YAChB,SAAS,EAAE,iDAAqC,CAAC,QAAQ;YACzD,UAAU,EAAE,EAAE,UAAU,EAAE;SAC1B,CAAC;QAEF,IAAI,CAAC;YACJ,MAAM,EAAE,2BAA2B,EAAE,GAAG,wDAAa,0BAA0B,GAAC,CAAC;YACjF,MAAM,cAAc,GAAG,2BAA2B,CAAC,iBAAiB,EAAE,CAAC;YACvE,MAAM,WAAW,GAAG,2BAA2B,CAAC,cAAc,CAAC,CAAC;YAChE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;YAExD,gBAAgB,CAAC,OAAO,GAAG;gBAC1B,OAAO,EAAE,IAAI;gBACb,IAAI,EAAE,EAAE,aAAa,EAAE,UAAU,CAAC,MAAM,EAAE;aAC1C,CAAC;YACF,SAAS,CAAC,KAAK,CAAC,0CAA0B,EAAE,gBAAgB,CAAC,CAAC;YAE9D,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBACzC,iBAAiB,EAAE,EAAE,WAAW,EAAE,MAAM,EAAE;aAC1C,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,gBAAgB,CAAC,OAAO,GAAG;gBAC1B,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC7D,CAAC;YACF,SAAS,CAAC,KAAK,CAAC,0CAA0B,EAAE,gBAAgB,CAAC,CAAC;YAC9D,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;CACD,CAAC,CAAC;AAnDU,QAAA,mCAAmC,uCAmD7C"}

package/dist/modules/mcp/tools/workflow-builder/get-workflow-node-types.tool.d.ts

@@ -0,0 +1,28 @@
+import type { User } from '@n8n/db';
+import z from 'zod';
+import type { ToolDefinition } from '../../mcp.types';
+import type { Telemetry } from '../../../../telemetry';
+import type { WorkflowBuilderToolsService } from './workflow-builder-tools.service';
+declare const inputSchema: {
+    nodeIds: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodObject<{
+        nodeId: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        resource: z.ZodOptional<z.ZodString>;
+        operation: z.ZodOptional<z.ZodString>;
+        mode: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        nodeId: string;
+        version?: string | undefined;
+        resource?: string | undefined;
+        operation?: string | undefined;
+        mode?: string | undefined;
+    }, {
+        nodeId: string;
+        version?: string | undefined;
+        resource?: string | undefined;
+        operation?: string | undefined;
+        mode?: string | undefined;
+    }>]>, "many">;
+};
+export declare const createGetWorkflowNodeTypesTool: (user: User, workflowBuilderToolsService: WorkflowBuilderToolsService, telemetry: Telemetry) => ToolDefinition<typeof inputSchema>;
+export {};

package/dist/modules/mcp/tools/workflow-builder/get-workflow-node-types.tool.js

@@ -0,0 +1,102 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGetWorkflowNodeTypesTool = void 0;
+const zod_1 = __importDefault(require("zod"));
+const mcp_constants_1 = require("../../mcp.constants");
+const constants_1 = require("./constants");
+const nodeIdWithDiscriminators = zod_1.default.object({
+    nodeId: zod_1.default.string().describe('The node type ID (e.g. "n8n-nodes-base.gmail")'),
+    version: zod_1.default.string().optional().describe('Specific version (e.g. "2.1")'),
+    resource: zod_1.default.string().optional().describe('Resource discriminator (e.g. "message")'),
+    operation: zod_1.default.string().optional().describe('Operation discriminator (e.g. "send")'),
+    mode: zod_1.default.string().optional().describe('Mode discriminator'),
+});
+const inputSchema = {
+    nodeIds: zod_1.default
+        .array(zod_1.default.union([zod_1.default.string(), nodeIdWithDiscriminators]))
+        .min(1)
+        .describe('Node IDs to get type definitions for. Use plain strings for simple nodes, or objects with discriminators from search results.'),
+};
+const outputSchema = {
+    definitions: zod_1.default.string().describe('TypeScript type definitions for the requested nodes'),
+};
+const createGetWorkflowNodeTypesTool = (user, workflowBuilderToolsService, telemetry) => ({
+    name: constants_1.CODE_BUILDER_GET_NODE_TYPES_TOOL.toolName,
+    config: {
+        description: 'Get TypeScript type definitions for n8n nodes. Returns exact parameter names and structures. MUST be called before writing workflow code — guessing parameter names creates invalid workflows. Include discriminators (resource/operation/mode) from search results.',
+        inputSchema,
+        outputSchema,
+        annotations: {
+            title: constants_1.CODE_BUILDER_GET_NODE_TYPES_TOOL.displayTitle,
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    handler: async ({ nodeIds }) => {
+        const telemetryPayload = {
+            user_id: user.id,
+            tool_name: constants_1.CODE_BUILDER_GET_NODE_TYPES_TOOL.toolName,
+            parameters: { nodeIdCount: nodeIds.length },
+        };
+        try {
+            const { createCodeBuilderGetTool } = await Promise.resolve().then(() => __importStar(require('@n8n/ai-workflow-builder')));
+            const nodeDefinitionDirs = workflowBuilderToolsService.getNodeDefinitionDirs();
+            const getTool = createCodeBuilderGetTool({ nodeDefinitionDirs });
+            const result = await getTool.invoke({ nodeIds });
+            telemetryPayload.results = { success: true, data: { nodeIdCount: nodeIds.length } };
+            telemetry.track(mcp_constants_1.USER_CALLED_MCP_TOOL_EVENT, telemetryPayload);
+            return {
+                content: [{ type: 'text', text: result }],
+                structuredContent: { definitions: result },
+            };
+        }
+        catch (error) {
+            telemetryPayload.results = {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+            telemetry.track(mcp_constants_1.USER_CALLED_MCP_TOOL_EVENT, telemetryPayload);
+            throw error;
+        }
+    },
+});
+exports.createGetWorkflowNodeTypesTool = createGetWorkflowNodeTypesTool;
+//# sourceMappingURL=get-workflow-node-types.tool.js.map

package/dist/modules/mcp/tools/workflow-builder/get-workflow-node-types.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-workflow-node-types.tool.js","sourceRoot":"","sources":["../../../../../src/modules/mcp/tools/workflow-builder/get-workflow-node-types.tool.ts"],"names":[],"mappings":"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"}

package/dist/modules/mcp/tools/workflow-builder/get-workflow-sdk-reference.tool.d.ts

@@ -0,0 +1,9 @@
+import type { User } from '@n8n/db';
+import z from 'zod';
+import type { ToolDefinition } from '../../mcp.types';
+import type { Telemetry } from '../../../../telemetry';
+declare const inputSchema: {
+    section: z.ZodOptional<z.ZodEnum<[string, ...string[]]>>;
+};
+export declare const createGetWorkflowSdkReferenceTool: (user: User, telemetry: Telemetry) => ToolDefinition<typeof inputSchema>;
+export {};

package/dist/modules/mcp/tools/workflow-builder/get-workflow-sdk-reference.tool.js

@@ -0,0 +1,60 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGetWorkflowSdkReferenceTool = void 0;
+const zod_1 = __importDefault(require("zod"));
+const mcp_constants_1 = require("../../mcp.constants");
+const constants_1 = require("./constants");
+const sdk_reference_content_1 = require("./sdk-reference-content");
+const VALID_SECTIONS = [
+    'patterns',
+    'expressions',
+    'functions',
+    'rules',
+    'import',
+    'guidelines',
+    'design',
+    'all',
+];
+const inputSchema = {
+    section: zod_1.default
+        .enum(VALID_SECTIONS)
+        .optional()
+        .describe('Optional section to retrieve: "patterns", "expressions", "functions", "rules", "import", "guidelines", "design", or "all" (default)'),
+};
+const outputSchema = {
+    reference: zod_1.default.string().describe('SDK reference documentation content for the requested section'),
+};
+const createGetWorkflowSdkReferenceTool = (user, telemetry) => ({
+    name: constants_1.MCP_GET_SDK_REFERENCE_TOOL.toolName,
+    config: {
+        description: 'Get the n8n Workflow SDK reference documentation including patterns, expression syntax, and rules. Call this FIRST before building workflows to learn the SDK.',
+        inputSchema,
+        outputSchema,
+        annotations: {
+            title: constants_1.MCP_GET_SDK_REFERENCE_TOOL.displayTitle,
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    handler: async ({ section }) => {
+        const telemetryPayload = {
+            user_id: user.id,
+            tool_name: constants_1.MCP_GET_SDK_REFERENCE_TOOL.toolName,
+            parameters: { section },
+        };
+        const content = (0, sdk_reference_content_1.getSdkReferenceContent)(section);
+        telemetryPayload.results = { success: true };
+        telemetry.track(mcp_constants_1.USER_CALLED_MCP_TOOL_EVENT, telemetryPayload);
+        return {
+            content: [{ type: 'text', text: content }],
+            structuredContent: { reference: content },
+        };
+    },
+});
+exports.createGetWorkflowSdkReferenceTool = createGetWorkflowSdkReferenceTool;
+//# sourceMappingURL=get-workflow-sdk-reference.tool.js.map

package/dist/modules/mcp/tools/workflow-builder/get-workflow-sdk-reference.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-workflow-sdk-reference.tool.js","sourceRoot":"","sources":["../../../../../src/modules/mcp/tools/workflow-builder/get-workflow-sdk-reference.tool.ts"],"names":[],"mappings":";;;;;;AACA,8CAAoB;AAEpB,uDAAiE;AAKjE,2CAAyD;AACzD,mEAA2F;AAE3F,MAAM,cAAc,GAA0B;IAC7C,UAAU;IACV,aAAa;IACb,WAAW;IACX,OAAO;IACP,QAAQ;IACR,YAAY;IACZ,QAAQ;IACR,KAAK;CACL,CAAC;AAEF,MAAM,WAAW,GAAG;IACnB,OAAO,EAAE,aAAC;SACR,IAAI,CAAC,cAAuC,CAAC;SAC7C,QAAQ,EAAE;SACV,QAAQ,CACR,qIAAqI,CACrI;CACsB,CAAC;AAE1B,MAAM,YAAY,GAAG;IACpB,SAAS,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+DAA+D,CAAC;CACvE,CAAC;AAMnB,MAAM,iCAAiC,GAAG,CAChD,IAAU,EACV,SAAoB,EACiB,EAAE,CAAC,CAAC;IACzC,IAAI,EAAE,sCAA0B,CAAC,QAAQ;IACzC,MAAM,EAAE;QACP,WAAW,EACV,gKAAgK;QACjK,WAAW;QACX,YAAY;QACZ,WAAW,EAAE;YACZ,KAAK,EAAE,sCAA0B,CAAC,YAAY;YAC9C,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACpB;KACD;IACD,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAwB,EAAE,EAAE;QACpD,MAAM,gBAAgB,GAAkC;YACvD,OAAO,EAAE,IAAI,CAAC,EAAE;YAChB,SAAS,EAAE,sCAA0B,CAAC,QAAQ;YAC9C,UAAU,EAAE,EAAE,OAAO,EAAE;SACvB,CAAC;QAEF,MAAM,OAAO,GAAG,IAAA,8CAAsB,EAAC,OAA0C,CAAC,CAAC;QAEnF,gBAAgB,CAAC,OAAO,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC7C,SAAS,CAAC,KAAK,CAAC,0CAA0B,EAAE,gBAAgB,CAAC,CAAC;QAE9D,OAAO;YACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YAC1C,iBAAiB,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE;SACzC,CAAC;IACH,CAAC;CACD,CAAC,CAAC;AAnCU,QAAA,iCAAiC,qCAmC3C"}

package/dist/modules/mcp/tools/workflow-builder/mcp-instructions.d.ts

@@ -0,0 +1 @@
+export declare function getMcpInstructions(isBuilderEnabled: boolean): string;

package/dist/modules/mcp/tools/workflow-builder/mcp-instructions.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMcpInstructions = getMcpInstructions;
+const constants_1 = require("./constants");
+function getMcpInstructions(isBuilderEnabled) {
+    const INTRO = 'This is the official MCP server for n8n, a workflow automation platform.';
+    const BUILDER_INSTRUCTIONS = `This MCP server provides tools to build n8n workflows programmatically using the n8n Workflow SDK.
+
+To build n8n workflows, follow these steps in order:
+
+1. Read the SDK reference: Call ${constants_1.MCP_GET_SDK_REFERENCE_TOOL.toolName} (or use the n8n://workflow-sdk/reference resource) to learn the SDK patterns and syntax.
+
+2. Discover nodes: Call ${constants_1.CODE_BUILDER_SEARCH_NODES_TOOL.toolName} with queries for services you need (e.g., ["gmail", "slack", "schedule trigger"]) and utility nodes (e.g., ["set", "if", "merge", "code"]). Note the discriminators (resource/operation/mode) in the results.
+
+3. (Optional) Get suggestions: Call ${constants_1.CODE_BUILDER_GET_SUGGESTED_NODES_TOOL.toolName} with workflow technique categories for curated recommendations.
+
+4. Get type definitions: Call ${constants_1.CODE_BUILDER_GET_NODE_TYPES_TOOL.toolName} with ALL node IDs you plan to use, including discriminators from search results. This returns the exact TypeScript parameter definitions. DO NOT skip this — guessing parameter names creates invalid workflows.
+
+5. Write the workflow code using the SDK patterns from the reference and the exact parameter names from the type definitions. Follow the coding guidelines and design guidance sections of the SDK reference (retrieve them with ${constants_1.MCP_GET_SDK_REFERENCE_TOOL.toolName} using sections "guidelines" and "design").
+
+6. Validate: Call ${constants_1.CODE_BUILDER_VALIDATE_TOOL.toolName} with your full code. Fix any errors and re-validate until valid.
+
+7. Create: Call ${constants_1.MCP_CREATE_WORKFLOW_FROM_CODE_TOOL.toolName} with the validated code to save the workflow to n8n. Include a short \`description\` (1-2 sentences) summarizing what the workflow does — this helps users find and understand their workflows.
+
+8. Update: Call ${constants_1.MCP_UPDATE_WORKFLOW_TOOL.toolName} with the workflow ID and validated code. Follow steps 2-6 to prepare the new code, then call update instead of create.
+
+9. Archive: Call ${constants_1.MCP_ARCHIVE_WORKFLOW_TOOL.toolName} with the workflow ID.`;
+    return isBuilderEnabled ? `${INTRO}\n\n${BUILDER_INSTRUCTIONS}` : INTRO;
+}
+//# sourceMappingURL=mcp-instructions.js.map

package/dist/modules/mcp/tools/workflow-builder/mcp-instructions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-instructions.js","sourceRoot":"","sources":["../../../../../src/modules/mcp/tools/workflow-builder/mcp-instructions.ts"],"names":[],"mappings":";;AAmBA,gDA0BC;AArCD,2CASqB;AAErB,SAAgB,kBAAkB,CAAC,gBAAyB;IAC3D,MAAM,KAAK,GAAG,0EAA0E,CAAC;IAEzF,MAAM,oBAAoB,GAAG;;;;kCAII,sCAA0B,CAAC,QAAQ;;0BAE3C,0CAA8B,CAAC,QAAQ;;sCAE3B,iDAAqC,CAAC,QAAQ;;gCAEpD,4CAAgC,CAAC,QAAQ;;mOAE0J,sCAA0B,CAAC,QAAQ;;oBAElP,sCAA0B,CAAC,QAAQ;;kBAErC,8CAAkC,CAAC,QAAQ;;kBAE3C,oCAAwB,CAAC,QAAQ;;mBAEhC,qCAAyB,CAAC,QAAQ,wBAAwB,CAAC;IAE7E,OAAO,gBAAgB,CAAC,CAAC,CAAC,GAAG,KAAK,OAAO,oBAAoB,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;AACzE,CAAC"}

package/dist/modules/mcp/tools/workflow-builder/sdk-reference-content.d.ts

@@ -0,0 +1,2 @@
+export type SdkReferenceSection = 'patterns' | 'expressions' | 'functions' | 'rules' | 'import' | 'guidelines' | 'design' | 'all';
+export declare function getSdkReferenceContent(section?: SdkReferenceSection): string;

package/dist/modules/mcp/tools/workflow-builder/sdk-reference-content.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSdkReferenceContent = getSdkReferenceContent;
+const ai_workflow_builder_1 = require("@n8n/ai-workflow-builder");
+const CODING_GUIDELINES = `Rules:
+- Use exact parameter names and structures from the type definitions.
+- Use unique variable names — never reuse builder function names (e.g. \`node\`, \`trigger\`) as variable names
+- Use descriptive node names (Good: "Fetch Weather Data", "Check Temperature"; Bad: "HTTP Request", "Set", "If")
+- Credentials: \`credentials: { slackApi: newCredential('Slack Bot') }\` — type must match what the node expects
+- Expressions: use \`expr()\` for any \`{{ }}\` syntax  — always use single or double quotes, NOT backtick template literals
+  - e.g. \`expr('Hello {{ $json.name }}')\` or \`expr("{{ $('Node').item.json.field }}")\`
+  - For multiline expressions, use string concatenation: \`expr('Line 1\\n' + 'Line 2 {{ $json.value }}')\`
+  - WRONG: \`expr('Daily Digest - ' + $now.toFormat('MMMM d') + '\\n' + $json.output)\` — $now and $json are outside {{ }}
+  - CORRECT: \`expr('Daily Digest - {{ $now.toFormat("MMMM d") }}\\n{{ $json.output }}')\` — variables inside {{ }}
+  - WRONG: \`expr('{{ ' + JSON.stringify($('Node').all().map(i => i.json)) + ' }}')\` — $() used as JavaScript
+  - CORRECT: \`expr('{{ $("Node").all().map(i => i.json) }}')\` — $() inside {{ }} evaluated at runtime
+- Placeholders: use \`placeholder('hint')\` directly as the parameter value, not inside \`expr()\`, objects, or arrays, etc.
+- Every node MUST have an \`output\` property with sample data — following nodes depend on it for expressions
+- String quoting: When a string value contains an apostrophe, use double quotes for that string.
+  Example: \`output: [{{ text: "I've arrived" }}]\`
+- Do NOT add or edit comments. Comments are ignored and not shared with user. Use sticky(...) to provide guidance.`;
+const DESIGN_GUIDANCE = `Design guidance:
+- **Trace item counts**: For each connection A → B, if A returns N items, should B run N times or just once? If B doesn't need A's items (e.g., it fetches from an independent source), either set \`executeOnce: true\` on B or use parallel branches + Merge to combine results.
+- **Handling convergence after branches**: When a node receives data from multiple paths (after Switch, IF, Merge): use optional chaining \`expr('{{ $json.data?.approved ?? $json.status }}')\`, reference a node that ALWAYS runs \`expr("{{ $('Webhook').item.json.field }}")\`, or normalize data before convergence with Set nodes.
+- **Prefer dedicated integration nodes** over HTTP Request when search results show one is available.
+- **Pay attention to @builderHint annotations** in the type definitions — they provide critical guidance on how to correctly configure node parameters.`;
+const SDK_IMPORT_SECTION = `## SDK Import Statement\n\n\`\`\`javascript\n${ai_workflow_builder_1.SDK_IMPORT_STATEMENT}\n\`\`\``;
+const CODING_GUIDELINES_SECTION = `## Coding Guidelines\n\n${CODING_GUIDELINES}`;
+const DESIGN_GUIDANCE_SECTION = `## Design Guidance\n\n${DESIGN_GUIDANCE}`;
+const SECTIONS = {
+    import: SDK_IMPORT_SECTION,
+    patterns: ai_workflow_builder_1.WORKFLOW_PATTERNS,
+    expressions: ai_workflow_builder_1.EXPRESSION_REFERENCE,
+    functions: ai_workflow_builder_1.ADDITIONAL_FUNCTIONS,
+    rules: ai_workflow_builder_1.WORKFLOW_RULES,
+    guidelines: CODING_GUIDELINES_SECTION,
+    design: DESIGN_GUIDANCE_SECTION,
+};
+function getSdkReferenceContent(section) {
+    if (section && section !== 'all' && section in SECTIONS) {
+        return SECTIONS[section];
+    }
+    return [
+        '# n8n Workflow SDK Reference',
+        '',
+        SECTIONS.import,
+        '',
+        SECTIONS.patterns,
+        '',
+        SECTIONS.expressions,
+        '',
+        SECTIONS.functions,
+        '',
+        SECTIONS.rules,
+        '',
+        SECTIONS.guidelines,
+        '',
+        SECTIONS.design,
+    ].join('\n');
+}
+//# sourceMappingURL=sdk-reference-content.js.map

package/dist/modules/mcp/tools/workflow-builder/sdk-reference-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk-reference-content.js","sourceRoot":"","sources":["../../../../../src/modules/mcp/tools/workflow-builder/sdk-reference-content.ts"],"names":[],"mappings":";;AA4EA,wDAsBC;AA1FD,kEAMkC;AAMlC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;mHAgByF,CAAC;AAEpH,MAAM,eAAe,GAAG;;;;wJAIgI,CAAC;AAezJ,MAAM,kBAAkB,GAAG,gDAAgD,0CAAoB,UAAU,CAAC;AAE1G,MAAM,yBAAyB,GAAG,2BAA2B,iBAAiB,EAAE,CAAC;AAEjF,MAAM,uBAAuB,GAAG,yBAAyB,eAAe,EAAE,CAAC;AAE3E,MAAM,QAAQ,GAAwD;IACrE,MAAM,EAAE,kBAAkB;IAC1B,QAAQ,EAAE,uCAAiB;IAC3B,WAAW,EAAE,0CAAoB;IACjC,SAAS,EAAE,0CAAoB;IAC/B,KAAK,EAAE,oCAAc;IACrB,UAAU,EAAE,yBAAyB;IACrC,MAAM,EAAE,uBAAuB;CAC/B,CAAC;AAKF,SAAgB,sBAAsB,CAAC,OAA6B;IACnE,IAAI,OAAO,IAAI,OAAO,KAAK,KAAK,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;QACzD,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO;QACN,8BAA8B;QAC9B,EAAE;QACF,QAAQ,CAAC,MAAM;QACf,EAAE;QACF,QAAQ,CAAC,QAAQ;QACjB,EAAE;QACF,QAAQ,CAAC,WAAW;QACpB,EAAE;QACF,QAAQ,CAAC,SAAS;QAClB,EAAE;QACF,QAAQ,CAAC,KAAK;QACd,EAAE;QACF,QAAQ,CAAC,UAAU;QACnB,EAAE;QACF,QAAQ,CAAC,MAAM;KACf,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACd,CAAC"}

package/dist/modules/mcp/tools/workflow-builder/search-workflow-nodes.tool.d.ts

@@ -0,0 +1,10 @@
+import type { User } from '@n8n/db';
+import z from 'zod';
+import type { ToolDefinition } from '../../mcp.types';
+import type { Telemetry } from '../../../../telemetry';
+import type { WorkflowBuilderToolsService } from './workflow-builder-tools.service';
+declare const inputSchema: {
+    queries: z.ZodArray<z.ZodString, "many">;
+};
+export declare const createSearchWorkflowNodesTool: (user: User, workflowBuilderToolsService: WorkflowBuilderToolsService, telemetry: Telemetry) => ToolDefinition<typeof inputSchema>;
+export {};

package/dist/modules/mcp/tools/workflow-builder/search-workflow-nodes.tool.js

@@ -0,0 +1,97 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSearchWorkflowNodesTool = void 0;
+const zod_1 = __importDefault(require("zod"));
+const mcp_constants_1 = require("../../mcp.constants");
+const constants_1 = require("./constants");
+const inputSchema = {
+    queries: zod_1.default
+        .array(zod_1.default.string())
+        .min(1)
+        .describe('Search queries for n8n nodes — service names (e.g. "gmail", "slack"), trigger types (e.g. "schedule trigger", "webhook"), or utility nodes (e.g. "set", "if", "merge", "code")'),
+};
+const outputSchema = {
+    results: zod_1.default
+        .string()
+        .describe('Search results with matching node IDs, discriminators, and related nodes'),
+};
+const createSearchWorkflowNodesTool = (user, workflowBuilderToolsService, telemetry) => ({
+    name: constants_1.CODE_BUILDER_SEARCH_NODES_TOOL.toolName,
+    config: {
+        description: 'Search for n8n nodes by service name, trigger type, or utility function. Returns node IDs, discriminators (resource/operation/mode), and related nodes needed for get_workflow_node_types.',
+        inputSchema,
+        outputSchema,
+        annotations: {
+            title: constants_1.CODE_BUILDER_SEARCH_NODES_TOOL.displayTitle,
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+    },
+    handler: async ({ queries }) => {
+        const telemetryPayload = {
+            user_id: user.id,
+            tool_name: constants_1.CODE_BUILDER_SEARCH_NODES_TOOL.toolName,
+            parameters: { queries },
+        };
+        try {
+            const { createCodeBuilderSearchTool } = await Promise.resolve().then(() => __importStar(require('@n8n/ai-workflow-builder')));
+            const nodeTypeParser = workflowBuilderToolsService.getNodeTypeParser();
+            const searchTool = createCodeBuilderSearchTool(nodeTypeParser);
+            const result = await searchTool.invoke({ queries });
+            telemetryPayload.results = { success: true, data: { queryCount: queries.length } };
+            telemetry.track(mcp_constants_1.USER_CALLED_MCP_TOOL_EVENT, telemetryPayload);
+            return {
+                content: [{ type: 'text', text: result }],
+                structuredContent: { results: result },
+            };
+        }
+        catch (error) {
+            telemetryPayload.results = {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+            telemetry.track(mcp_constants_1.USER_CALLED_MCP_TOOL_EVENT, telemetryPayload);
+            throw error;
+        }
+    },
+});
+exports.createSearchWorkflowNodesTool = createSearchWorkflowNodesTool;
+//# sourceMappingURL=search-workflow-nodes.tool.js.map

package/dist/modules/mcp/tools/workflow-builder/search-workflow-nodes.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-workflow-nodes.tool.js","sourceRoot":"","sources":["../../../../../src/modules/mcp/tools/workflow-builder/search-workflow-nodes.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,8CAAoB;AAEpB,uDAAiE;AAKjE,2CAA6D;AAG7D,MAAM,WAAW,GAAG;IACnB,OAAO,EAAE,aAAC;SACR,KAAK,CAAC,aAAC,CAAC,MAAM,EAAE,CAAC;SACjB,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CACR,gLAAgL,CAChL;CACsB,CAAC;AAE1B,MAAM,YAAY,GAAG;IACpB,OAAO,EAAE,aAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,0EAA0E,CAAC;CAC9D,CAAC;AAMnB,MAAM,6BAA6B,GAAG,CAC5C,IAAU,EACV,2BAAwD,EACxD,SAAoB,EACiB,EAAE,CAAC,CAAC;IACzC,IAAI,EAAE,0CAA8B,CAAC,QAAQ;IAC7C,MAAM,EAAE;QACP,WAAW,EACV,4LAA4L;QAC7L,WAAW;QACX,YAAY;QACZ,WAAW,EAAE;YACZ,KAAK,EAAE,0CAA8B,CAAC,YAAY;YAClD,YAAY,EAAE,IAAI;YAClB,eAAe,EAAE,KAAK;YACtB,cAAc,EAAE,IAAI;YACpB,aAAa,EAAE,KAAK;SACpB;KACD;IACD,OAAO,EAAE,KAAK,EAAE,EAAE,OAAO,EAAyB,EAAE,EAAE;QACrD,MAAM,gBAAgB,GAAkC;YACvD,OAAO,EAAE,IAAI,CAAC,EAAE;YAChB,SAAS,EAAE,0CAA8B,CAAC,QAAQ;YAClD,UAAU,EAAE,EAAE,OAAO,EAAE;SACvB,CAAC;QAEF,IAAI,CAAC;YACJ,MAAM,EAAE,2BAA2B,EAAE,GAAG,wDAAa,0BAA0B,GAAC,CAAC;YACjF,MAAM,cAAc,GAAG,2BAA2B,CAAC,iBAAiB,EAAE,CAAC;YACvE,MAAM,UAAU,GAAG,2BAA2B,CAAC,cAAc,CAAC,CAAC;YAC/D,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;YAEpD,gBAAgB,CAAC,OAAO,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACnF,SAAS,CAAC,KAAK,CAAC,0CAA0B,EAAE,gBAAgB,CAAC,CAAC;YAE9D,OAAO;gBACN,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBACzC,iBAAiB,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE;aACtC,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,gBAAgB,CAAC,OAAO,GAAG;gBAC1B,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC7D,CAAC;YACF,SAAS,CAAC,KAAK,CAAC,0CAA0B,EAAE,gBAAgB,CAAC,CAAC;YAC9D,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;CACD,CAAC,CAAC;AAhDU,QAAA,6BAA6B,iCAgDvC"}