n8n 1.114.4 → 1.115.1

package/dist/modules/mcp/mcp.typeguards.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasHttpHeaderAuthDecryptedData = hasHttpHeaderAuthDecryptedData;
+exports.hasJwtSecretDecryptedData = hasJwtSecretDecryptedData;
+exports.hasJwtPemKeyDecryptedData = hasJwtPemKeyDecryptedData;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function hasHttpHeaderAuthDecryptedData(value) {
+    if (!isRecord(value))
+        return false;
+    const obj = value;
+    const dataCandidate = obj['data'];
+    if (!isRecord(dataCandidate))
+        return false;
+    const data = dataCandidate;
+    return typeof data.name === 'string';
+}
+function hasJwtSecretDecryptedData(value) {
+    if (!isRecord(value))
+        return false;
+    const obj = value;
+    const dataCandidate = obj['data'];
+    if (!isRecord(dataCandidate))
+        return false;
+    const data = dataCandidate;
+    return typeof data.secret === 'string';
+}
+function hasJwtPemKeyDecryptedData(value) {
+    if (!isRecord(value))
+        return false;
+    const obj = value;
+    const dataCandidate = obj['data'];
+    if (!isRecord(dataCandidate))
+        return false;
+    const data = dataCandidate;
+    if (typeof data.keyType === 'string' && data.keyType === 'pemKey')
+        return true;
+    return typeof data.privateKey === 'string' || typeof data.publicKey === 'string';
+}
+//# sourceMappingURL=mcp.typeguards.js.map

package/dist/modules/mcp/mcp.typeguards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.typeguards.js","sourceRoot":"","sources":["../../../src/modules/mcp/mcp.typeguards.ts"],"names":[],"mappings":";;AAqBA,wEASC;AAcD,8DASC;AAED,8DAUC;AA5DD,SAAS,QAAQ,CAAC,KAAc;IAC/B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACpD,CAAC;AAcD,SAAgB,8BAA8B,CAC7C,KAAc;IAEd,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,MAAM,GAAG,GAAG,KAAK,CAAC;IAClB,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,IAAI,GAAG,aAAa,CAAC;IAC3B,OAAO,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC;AACtC,CAAC;AAcD,SAAgB,yBAAyB,CACxC,KAAc;IAEd,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,MAAM,GAAG,GAAG,KAAK,CAAC;IAClB,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,IAAI,GAAG,aAAa,CAAC;IAC3B,OAAO,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC;AACxC,CAAC;AAED,SAAgB,yBAAyB,CACxC,KAAc;IAEd,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,MAAM,GAAG,GAAG,KAAK,CAAC;IAClB,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,IAAI,GAAG,aAAa,CAAC;IAC3B,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ,IAAI,IAAI,CAAC,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC/E,OAAO,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CAAC;AAClF,CAAC"}

package/dist/modules/mcp/mcp.types.d.ts

@@ -0,0 +1,37 @@
+import { type ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type z from 'zod';
+import type { WorkflowDetailsOutputSchema } from './tools/get-workflow-details.tool';
+export type ToolDefinition<InputArgs extends z.ZodRawShape = z.ZodRawShape> = {
+    name: string;
+    config: {
+        description?: string;
+        inputSchema?: InputArgs;
+        outputSchema?: z.ZodRawShape;
+    };
+    handler: ToolCallback<InputArgs>;
+};
+export type SearchWorkflowsParams = {
+    limit?: number;
+    active?: boolean;
+    name?: string;
+    projectId?: string;
+};
+export type SearchWorkflowsItem = {
+    id: string;
+    name: string | null;
+    active: boolean | null;
+    createdAt: string | null;
+    updatedAt: string | null;
+    triggerCount: number | null;
+    nodes: Array<{
+        name: string;
+        type: string;
+    }>;
+};
+export type SearchWorkflowsResult = {
+    data: SearchWorkflowsItem[];
+    count: number;
+};
+export type WorkflowDetailsResult = z.infer<WorkflowDetailsOutputSchema>;
+export type WorkflowDetailsWorkflow = WorkflowDetailsResult['workflow'];
+export type WorkflowDetailsNode = WorkflowDetailsWorkflow['nodes'][number];

package/dist/modules/mcp/mcp.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=mcp.types.js.map

package/dist/modules/mcp/mcp.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.types.js","sourceRoot":"","sources":["../../../src/modules/mcp/mcp.types.ts"],"names":[],"mappings":""}

package/dist/modules/mcp/tools/get-workflow-details.tool.d.ts

@@ -0,0 +1,16 @@
+import type { User } from '@n8n/db';
+import z from 'zod';
+import type { ToolDefinition, WorkflowDetailsResult } from '../mcp.types';
+import { workflowDetailsOutputSchema } from './schemas';
+import { type WebhookEndpoints } from './webhook-utils';
+import type { CredentialsService } from '../../../credentials/credentials.service';
+import type { WorkflowFinderService } from '../../../workflows/workflow-finder.service';
+declare const inputSchema: {
+    workflowId: z.ZodString;
+};
+export type WorkflowDetailsOutputSchema = typeof workflowDetailsOutputSchema;
+export declare const createWorkflowDetailsTool: (user: User, baseWebhookUrl: string, workflowFinderService: WorkflowFinderService, credentialsService: CredentialsService, endpoints: WebhookEndpoints) => ToolDefinition<typeof inputSchema>;
+export declare function getWorkflowDetails(user: User, baseWebhookUrl: string, workflowFinderService: WorkflowFinderService, credentialsService: CredentialsService, endpoints: WebhookEndpoints, { workflowId }: {
+    workflowId: string;
+}): Promise<WorkflowDetailsResult>;
+export {};

package/dist/modules/mcp/tools/get-workflow-details.tool.js

@@ -0,0 +1,64 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWorkflowDetailsTool = void 0;
+exports.getWorkflowDetails = getWorkflowDetails;
+const n8n_workflow_1 = require("n8n-workflow");
+const zod_1 = __importDefault(require("zod"));
+const schemas_1 = require("./schemas");
+const webhook_utils_1 = require("./webhook-utils");
+const inputSchema = {
+    workflowId: zod_1.default.string().describe('The ID of the workflow to retrieve'),
+};
+const outputSchema = schemas_1.workflowDetailsOutputSchema.shape;
+const createWorkflowDetailsTool = (user, baseWebhookUrl, workflowFinderService, credentialsService, endpoints) => {
+    return {
+        name: 'get_workflow_details',
+        config: {
+            description: 'Get detailed information about a specific workflow including trigger details',
+            inputSchema,
+            outputSchema,
+        },
+        handler: async ({ workflowId }) => {
+            const payload = await getWorkflowDetails(user, baseWebhookUrl, workflowFinderService, credentialsService, endpoints, { workflowId });
+            return {
+                content: [{ type: 'text', text: JSON.stringify(payload) }],
+                structuredContent: payload,
+            };
+        },
+    };
+};
+exports.createWorkflowDetailsTool = createWorkflowDetailsTool;
+async function getWorkflowDetails(user, baseWebhookUrl, workflowFinderService, credentialsService, endpoints, { workflowId }) {
+    const workflow = await workflowFinderService.findWorkflowForUser(workflowId, user, [
+        'workflow:read',
+    ]);
+    if (!workflow || workflow.isArchived || !workflow.settings?.availableInMCP) {
+        throw new n8n_workflow_1.UserError('Workflow not found');
+    }
+    const webhooks = workflow.nodes.filter((node) => node.type === 'n8n-nodes-base.webhook' && node.disabled !== true);
+    let triggerNotice = await (0, webhook_utils_1.getWebhookDetails)(user, webhooks, baseWebhookUrl, credentialsService, endpoints);
+    triggerNotice += `${workflow.active
+        ? '\n- Workflow is active and accessible. Use the production path for live traffic; the test path remains available when listening for test events in the editor. n8n Webhooks nodes do not have information about required request payloads, so ask the user if that cannot be inferred from the workflow.'
+        : '\n- Workflow is not active. Click "Listen for test event" in the editor and use the test path; activate the workflow to make the production path available.'}`;
+    const sanitizedWorkflow = {
+        id: workflow.id,
+        name: workflow.name,
+        active: workflow.active,
+        isArchived: workflow.isArchived,
+        versionId: workflow.versionId,
+        triggerCount: workflow.triggerCount,
+        createdAt: workflow.createdAt.toISOString(),
+        updatedAt: workflow.updatedAt.toISOString(),
+        settings: workflow.settings ?? null,
+        connections: workflow.connections,
+        nodes: workflow.nodes.map(({ credentials: _credentials, ...node }) => node),
+        tags: (workflow.tags ?? []).map((tag) => ({ id: tag.id, name: tag.name })),
+        meta: workflow.meta ?? null,
+        parentFolderId: workflow.parentFolder?.id ?? null,
+    };
+    return { workflow: sanitizedWorkflow, triggerInfo: triggerNotice };
+}
+//# sourceMappingURL=get-workflow-details.tool.js.map

package/dist/modules/mcp/tools/get-workflow-details.tool.js.map

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

package/dist/modules/mcp/tools/schemas.d.ts

@@ -0,0 +1,179 @@
+import type { IWorkflowSettings, WorkflowFEMeta } from 'n8n-workflow';
+import z from 'zod';
+export declare const nodeSchema: z.ZodObject<{
+    name: z.ZodString;
+    type: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    name: z.ZodString;
+    type: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    name: z.ZodString;
+    type: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>;
+export declare const tagSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    id: z.ZodString;
+    name: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    id: z.ZodString;
+    name: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>;
+export declare const workflowSettingsSchema: z.ZodNullable<z.ZodType<IWorkflowSettings, z.ZodTypeDef, IWorkflowSettings>>;
+export declare const workflowMetaSchema: z.ZodNullable<z.ZodType<WorkflowFEMeta, z.ZodTypeDef, WorkflowFEMeta>>;
+export declare const workflowDetailsOutputSchema: z.ZodObject<{
+    workflow: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        active: z.ZodBoolean;
+        isArchived: z.ZodBoolean;
+        versionId: z.ZodString;
+        triggerCount: z.ZodNumber;
+        createdAt: z.ZodNullable<z.ZodString>;
+        updatedAt: z.ZodNullable<z.ZodString>;
+        settings: z.ZodNullable<z.ZodType<IWorkflowSettings, z.ZodTypeDef, IWorkflowSettings>>;
+        connections: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        nodes: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            name: z.ZodString;
+            type: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            name: z.ZodString;
+            type: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+        tags: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+        meta: z.ZodNullable<z.ZodType<WorkflowFEMeta, z.ZodTypeDef, WorkflowFEMeta>>;
+        parentFolderId: z.ZodNullable<z.ZodString>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        id: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        active: z.ZodBoolean;
+        isArchived: z.ZodBoolean;
+        versionId: z.ZodString;
+        triggerCount: z.ZodNumber;
+        createdAt: z.ZodNullable<z.ZodString>;
+        updatedAt: z.ZodNullable<z.ZodString>;
+        settings: z.ZodNullable<z.ZodType<IWorkflowSettings, z.ZodTypeDef, IWorkflowSettings>>;
+        connections: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        nodes: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            name: z.ZodString;
+            type: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            name: z.ZodString;
+            type: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+        tags: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+        meta: z.ZodNullable<z.ZodType<WorkflowFEMeta, z.ZodTypeDef, WorkflowFEMeta>>;
+        parentFolderId: z.ZodNullable<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        id: z.ZodString;
+        name: z.ZodNullable<z.ZodString>;
+        active: z.ZodBoolean;
+        isArchived: z.ZodBoolean;
+        versionId: z.ZodString;
+        triggerCount: z.ZodNumber;
+        createdAt: z.ZodNullable<z.ZodString>;
+        updatedAt: z.ZodNullable<z.ZodString>;
+        settings: z.ZodNullable<z.ZodType<IWorkflowSettings, z.ZodTypeDef, IWorkflowSettings>>;
+        connections: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        nodes: z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            type: z.ZodString;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            name: z.ZodString;
+            type: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            name: z.ZodString;
+            type: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+        tags: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+        meta: z.ZodNullable<z.ZodType<WorkflowFEMeta, z.ZodTypeDef, WorkflowFEMeta>>;
+        parentFolderId: z.ZodNullable<z.ZodString>;
+    }, z.ZodTypeAny, "passthrough">>;
+    triggerInfo: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    workflow: {
+        tags: z.objectOutputType<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">[];
+        id: string;
+        name: string | null;
+        active: boolean;
+        versionId: string;
+        createdAt: string | null;
+        updatedAt: string | null;
+        nodes: z.objectOutputType<{
+            name: z.ZodString;
+            type: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">[];
+        connections: Record<string, unknown>;
+        isArchived: boolean;
+        parentFolderId: string | null;
+        settings: IWorkflowSettings | null;
+        meta: WorkflowFEMeta | null;
+        triggerCount: number;
+    } & {
+        [k: string]: unknown;
+    };
+    triggerInfo: string;
+}, {
+    workflow: {
+        tags: z.objectInputType<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">[];
+        id: string;
+        name: string | null;
+        active: boolean;
+        versionId: string;
+        createdAt: string | null;
+        updatedAt: string | null;
+        nodes: z.objectInputType<{
+            name: z.ZodString;
+            type: z.ZodString;
+        }, z.ZodTypeAny, "passthrough">[];
+        connections: Record<string, unknown>;
+        isArchived: boolean;
+        parentFolderId: string | null;
+        settings: IWorkflowSettings | null;
+        meta: WorkflowFEMeta | null;
+        triggerCount: number;
+    } & {
+        [k: string]: unknown;
+    };
+    triggerInfo: string;
+}>;

package/dist/modules/mcp/tools/schemas.js

@@ -0,0 +1,45 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.workflowDetailsOutputSchema = exports.workflowMetaSchema = exports.workflowSettingsSchema = exports.tagSchema = exports.nodeSchema = void 0;
+const zod_1 = __importDefault(require("zod"));
+exports.nodeSchema = zod_1.default
+    .object({
+    name: zod_1.default.string(),
+    type: zod_1.default.string(),
+})
+    .passthrough();
+exports.tagSchema = zod_1.default.object({ id: zod_1.default.string(), name: zod_1.default.string() }).passthrough();
+exports.workflowSettingsSchema = zod_1.default
+    .custom((_value) => true)
+    .nullable();
+exports.workflowMetaSchema = zod_1.default
+    .custom((_value) => true)
+    .nullable();
+exports.workflowDetailsOutputSchema = zod_1.default.object({
+    workflow: zod_1.default
+        .object({
+        id: zod_1.default.string(),
+        name: zod_1.default.string().nullable(),
+        active: zod_1.default.boolean(),
+        isArchived: zod_1.default.boolean(),
+        versionId: zod_1.default.string(),
+        triggerCount: zod_1.default.number(),
+        createdAt: zod_1.default.string().nullable(),
+        updatedAt: zod_1.default.string().nullable(),
+        settings: exports.workflowSettingsSchema,
+        connections: zod_1.default.record(zod_1.default.unknown()),
+        nodes: zod_1.default.array(exports.nodeSchema),
+        tags: zod_1.default.array(exports.tagSchema),
+        meta: exports.workflowMetaSchema,
+        parentFolderId: zod_1.default.string().nullable(),
+    })
+        .passthrough()
+        .describe('Sanitized workflow data safe for MCP consumption'),
+    triggerInfo: zod_1.default
+        .string()
+        .describe('Human-readable instructions describing how to trigger the workflow'),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/modules/mcp/tools/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../../src/modules/mcp/tools/schemas.ts"],"names":[],"mappings":";;;;;;AACA,8CAAoB;AAEP,QAAA,UAAU,GAAG,aAAC;KACzB,MAAM,CAAC;IACP,IAAI,EAAE,aAAC,CAAC,MAAM,EAAE;IAChB,IAAI,EAAE,aAAC,CAAC,MAAM,EAAE;CAChB,CAAC;KACD,WAAW,EAAE,CAAC;AAEH,QAAA,SAAS,GAAG,aAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,aAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,aAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAEzE,QAAA,sBAAsB,GAAG,aAAC;KACrC,MAAM,CAAoB,CAAC,MAAM,EAA+B,EAAE,CAAC,IAAI,CAAC;KACxE,QAAQ,EAAE,CAAC;AAEA,QAAA,kBAAkB,GAAG,aAAC;KACjC,MAAM,CAAiB,CAAC,MAAM,EAA4B,EAAE,CAAC,IAAI,CAAC;KAClE,QAAQ,EAAE,CAAC;AAEA,QAAA,2BAA2B,GAAG,aAAC,CAAC,MAAM,CAAC;IACnD,QAAQ,EAAE,aAAC;SACT,MAAM,CAAC;QACP,EAAE,EAAE,aAAC,CAAC,MAAM,EAAE;QACd,IAAI,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,MAAM,EAAE,aAAC,CAAC,OAAO,EAAE;QACnB,UAAU,EAAE,aAAC,CAAC,OAAO,EAAE;QACvB,SAAS,EAAE,aAAC,CAAC,MAAM,EAAE;QACrB,YAAY,EAAE,aAAC,CAAC,MAAM,EAAE;QACxB,SAAS,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,SAAS,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,QAAQ,EAAE,8BAAsB;QAChC,WAAW,EAAE,aAAC,CAAC,MAAM,CAAC,aAAC,CAAC,OAAO,EAAE,CAAC;QAClC,KAAK,EAAE,aAAC,CAAC,KAAK,CAAC,kBAAU,CAAC;QAC1B,IAAI,EAAE,aAAC,CAAC,KAAK,CAAC,iBAAS,CAAC;QACxB,IAAI,EAAE,0BAAkB;QACxB,cAAc,EAAE,aAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACrC,CAAC;SACD,WAAW,EAAE;SACb,QAAQ,CAAC,kDAAkD,CAAC;IAC9D,WAAW,EAAE,aAAC;SACZ,MAAM,EAAE;SACR,QAAQ,CAAC,oEAAoE,CAAC;CAChF,CAAC,CAAC"}

package/dist/modules/mcp/tools/search-workflows.tool.d.ts

@@ -0,0 +1,13 @@
+import { type User } from '@n8n/db';
+import z from 'zod';
+import type { ToolDefinition, SearchWorkflowsParams, SearchWorkflowsResult } from '../mcp.types';
+import type { WorkflowService } from '../../../workflows/workflow.service';
+declare const inputSchema: {
+    limit: z.ZodOptional<z.ZodNumber>;
+    active: z.ZodOptional<z.ZodBoolean>;
+    name: z.ZodOptional<z.ZodString>;
+    projectId: z.ZodOptional<z.ZodString>;
+};
+export declare const createSearchWorkflowsTool: (user: User, workflowService: WorkflowService) => ToolDefinition<typeof inputSchema>;
+export declare function searchWorkflows(user: User, workflowService: WorkflowService, { limit, active, name, projectId }: SearchWorkflowsParams): Promise<SearchWorkflowsResult>;
+export {};

package/dist/modules/mcp/tools/search-workflows.tool.js

@@ -0,0 +1,98 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSearchWorkflowsTool = void 0;
+exports.searchWorkflows = searchWorkflows;
+const zod_1 = __importDefault(require("zod"));
+const schemas_1 = require("./schemas");
+const MAX_RESULTS = 200;
+const inputSchema = {
+    limit: zod_1.default
+        .number()
+        .int()
+        .positive()
+        .max(MAX_RESULTS)
+        .optional()
+        .describe(`Limit the number of results (max ${MAX_RESULTS})`),
+    active: zod_1.default.boolean().optional().describe('Filter by active status'),
+    name: zod_1.default.string().optional().describe('Filter by name'),
+    projectId: zod_1.default.string().optional(),
+};
+const outputSchema = {
+    data: zod_1.default
+        .array(zod_1.default.object({
+        id: zod_1.default.string(),
+        name: zod_1.default.string().nullable(),
+        active: zod_1.default.boolean().nullable(),
+        createdAt: zod_1.default.string().nullable(),
+        updatedAt: zod_1.default.string().nullable(),
+        triggerCount: zod_1.default.number().nullable(),
+        nodes: zod_1.default.array(schemas_1.nodeSchema),
+    }))
+        .describe('List of workflows matching the query'),
+    count: zod_1.default.number().int().min(0).describe('Total number of workflows that match the filters'),
+};
+const createSearchWorkflowsTool = (user, workflowService) => {
+    return {
+        name: 'search_workflows',
+        config: {
+            description: 'Search for workflows with optional filters. Returns a preview of each workflow.',
+            inputSchema,
+            outputSchema,
+        },
+        handler: async ({ limit = MAX_RESULTS, active, name, projectId }) => {
+            const payload = await searchWorkflows(user, workflowService, {
+                limit,
+                active,
+                name,
+                projectId,
+            });
+            return {
+                structuredContent: payload,
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(payload),
+                    },
+                ],
+            };
+        },
+    };
+};
+exports.createSearchWorkflowsTool = createSearchWorkflowsTool;
+async function searchWorkflows(user, workflowService, { limit = MAX_RESULTS, active, name, projectId }) {
+    const safeLimit = Math.min(Math.max(1, limit), MAX_RESULTS);
+    const options = {
+        take: safeLimit,
+        filter: {
+            isArchived: false,
+            availableInMCP: true,
+            ...(active !== undefined ? { active } : {}),
+            ...(name ? { name } : {}),
+            ...(projectId ? { projectId } : {}),
+        },
+        select: {
+            id: true,
+            name: true,
+            active: true,
+            createdAt: true,
+            updatedAt: true,
+            triggerCount: true,
+            nodes: true,
+        },
+    };
+    const { workflows, count } = await workflowService.getMany(user, options, false, false, false);
+    const formattedWorkflows = workflows.map(({ id, name, active, createdAt, updatedAt, triggerCount, nodes }) => ({
+        id,
+        name,
+        active,
+        createdAt: createdAt.toISOString(),
+        updatedAt: updatedAt.toISOString(),
+        triggerCount,
+        nodes: (nodes ?? []).map((node) => ({ name: node.name, type: node.type })),
+    }));
+    return { data: formattedWorkflows, count };
+}
+//# sourceMappingURL=search-workflows.tool.js.map

package/dist/modules/mcp/tools/search-workflows.tool.js.map

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

package/dist/modules/mcp/tools/webhook-utils.d.ts

@@ -0,0 +1,9 @@
+import type { User } from '@n8n/db';
+import type { INode } from 'n8n-workflow';
+import type { CredentialsService } from '../../../credentials/credentials.service';
+export type WebhookEndpoints = {
+    webhook: string;
+    webhookTest: string;
+};
+export declare const buildWebhookPath: (segment: string, pathParam: string) => string;
+export declare const getWebhookDetails: (user: User, webhookNodes: INode[], baseUrl: string, credentialsService: CredentialsService, endpoints: WebhookEndpoints) => Promise<string>;