n8n-mcp 2.78.0 → 2.79.0

package/dist/mcp/param-aliases.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveGetNodeAliases = resolveGetNodeAliases;
+exports.suggestExecutionsAction = suggestExecutionsAction;
+exports.withWorkflowIdAlias = withWorkflowIdAlias;
+exports.hasText = hasText;
+const logger_1 = require("../utils/logger");
+const GET_NODE_MODE_ALIASES = {
+    essentials: { mode: 'info', detail: 'standard' },
+    minimal: { mode: 'info', detail: 'minimal' },
+    standard: { mode: 'info', detail: 'standard' },
+    full: { mode: 'info', detail: 'full' },
+    operations: { mode: 'info', detail: 'standard' },
+    properties: { mode: 'search_properties' },
+    search: { mode: 'search_properties' },
+};
+const GET_NODE_DETAIL_ALIASES = {
+    essentials: 'standard',
+    summary: 'minimal',
+    short: 'minimal',
+};
+function resolveGetNodeAliases(mode, detail) {
+    const aliased = [];
+    let resolvedMode = mode;
+    let resolvedDetail = detail;
+    if (typeof resolvedDetail === 'string') {
+        const detailAlias = GET_NODE_DETAIL_ALIASES[resolvedDetail.toLowerCase()];
+        if (detailAlias) {
+            aliased.push(`detail=${resolvedDetail}→${detailAlias}`);
+            resolvedDetail = detailAlias;
+        }
+    }
+    if (typeof resolvedMode === 'string') {
+        const modeAlias = GET_NODE_MODE_ALIASES[resolvedMode.toLowerCase()];
+        if (modeAlias) {
+            const target = modeAlias.detail
+                ? `mode=${modeAlias.mode}, detail=${modeAlias.detail}`
+                : `mode=${modeAlias.mode}`;
+            aliased.push(`mode=${resolvedMode}→${target}`);
+            resolvedMode = modeAlias.mode;
+            if (modeAlias.detail)
+                resolvedDetail = modeAlias.detail;
+        }
+    }
+    if (aliased.length > 0) {
+        logger_1.logger.debug(`get_node: retired parameter vocabulary aliased (${aliased.join('; ')})`);
+    }
+    return { mode: resolvedMode, detail: resolvedDetail };
+}
+const EXECUTIONS_ACTION_HINTS = {
+    get_many: "Did you mean action='list'?",
+    getmany: "Did you mean action='list'?",
+    getall: "Did you mean action='list'?",
+    get_all: "Did you mean action='list'?",
+    list_executions: "Did you mean action='list'?",
+    listexecutions: "Did you mean action='list'?",
+    search: "Did you mean action='list'?",
+    get_execution: "Did you mean action='get'?",
+    getexecution: "Did you mean action='get'?",
+    retry: "Retrying an execution is not supported; re-run the workflow with n8n_test_workflow.",
+    list_runs: 'Evaluation test runs are managed by n8n_evaluations.',
+    get_run: 'Evaluation test runs are managed by n8n_evaluations.',
+    getrows: 'Data table rows are managed by n8n_manage_datatable.',
+    get_rows: 'Data table rows are managed by n8n_manage_datatable.',
+};
+function suggestExecutionsAction(action) {
+    return EXECUTIONS_ACTION_HINTS[action.toLowerCase()];
+}
+function withWorkflowIdAlias(args) {
+    const workflowIdMissing = args.workflowId === undefined || args.workflowId === null
+        || (typeof args.workflowId === 'string' && args.workflowId.trim() === '');
+    if (!workflowIdMissing) {
+        return args;
+    }
+    const id = typeof args.id === 'number' ? String(args.id) : args.id;
+    if (typeof id !== 'string' || id.trim() === '') {
+        return typeof args.workflowId === 'string' ? { ...args, workflowId: undefined } : args;
+    }
+    return { ...args, workflowId: id };
+}
+function hasText(value) {
+    return typeof value === 'string' && value.trim() !== '';
+}
+//# sourceMappingURL=param-aliases.js.map

package/dist/mcp/param-aliases.js.map

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

package/dist/mcp/server.d.ts

@@ -44,6 +44,7 @@ export declare class N8NDocumentationMCPServer {
     private validateToolParamsBasic;
     private validateExtractedArgs;
     private coerceStringifiedJsonParams;
+    private listExecutionsInsteadOfGet;
     private listNodes;
     private getNodeInfo;
     private searchNodes;

package/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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"}

package/dist/mcp/server.js

@@ -50,6 +50,7 @@ const tool_policy_1 = require("./tool-policy");
 const tools_n8n_friendly_1 = require("./tools-n8n-friendly");
 const workflow_examples_1 = require("./workflow-examples");
 const logger_1 = require("../utils/logger");
+const param_aliases_1 = require("./param-aliases");
 const stdio_guard_1 = require("../utils/stdio-guard");
 const redaction_1 = require("../utils/redaction");
 const node_repository_1 = require("../database/node-repository");
@@ -402,8 +403,13 @@ class N8NDocumentationMCPServer {
             const cloned = JSON.parse(JSON.stringify(original));
             const remaining = [...(0, tool_policy_1.getValidOperations)(toolName)].filter(v => !ops.has(v));
             const param = cloned.inputSchema?.properties?.[paramName];
+            let defaultRemoved = false;
             if (param?.enum) {
                 param.enum = param.enum.filter(v => !ops.has(v.toLowerCase()));
+                if (typeof param.default === 'string' && ops.has(param.default.toLowerCase())) {
+                    delete param.default;
+                    defaultRemoved = true;
+                }
                 if (param.enum.length === 0) {
                     logger_1.logger.warn(`DISABLED_TOOL_OPERATIONS: all operations for '${toolName}' are disabled ` +
                         `but the tool still appears in ListTools. ` +
@@ -411,11 +417,13 @@ class N8NDocumentationMCPServer {
                 }
                 if (param.description) {
                     const disabledList = [...ops].join(', ');
-                    param.description = `${param.description} (disabled by server policy: ${disabledList})`;
+                    param.description = `${param.description} (disabled by server policy: ${disabledList}`
+                        + `${defaultRemoved ? '; no default, pass a value' : ''})`;
                 }
             }
             const disabledList = [...ops].join(', ');
-            cloned.description = `${cloned.description}\n\n> Operations disabled by server policy: ${disabledList}`;
+            cloned.description = `${cloned.description}\n\n> Operations disabled by server policy: ${disabledList}`
+                + (defaultRemoved ? `. The default for ${paramName} was one of them, so ${paramName} must be passed explicitly.` : '');
             const destructive = tools_n8n_manager_1.DESTRUCTIVE_TOOL_OPERATIONS[toolName];
             if (destructive && cloned.annotations) {
                 const stillDestructive = remaining.some(v => destructive.has(String(v).toLowerCase()));
@@ -860,9 +868,18 @@ class N8NDocumentationMCPServer {
                     validationResult = validation_schemas_1.ToolValidation.validateWorkflowId(args);
                     break;
                 case 'n8n_executions':
-                    validationResult = args.action
+                    validationResult = { valid: true, errors: [] };
+                    break;
+                case 'n8n_test_workflow':
+                    validationResult = (0, param_aliases_1.hasText)(args.workflowId)
                         ? { valid: true, errors: [] }
-                        : { valid: false, errors: [{ field: 'action', message: 'action is required' }] };
+                        : {
+                            valid: false,
+                            errors: [{
+                                    field: 'workflowId',
+                                    message: 'workflowId is required: the ID of the workflow to run ("id" is accepted as an alias)'
+                                }]
+                        };
                     break;
                 case 'n8n_evaluations': {
                     const evalErrors = [];
@@ -1086,6 +1103,19 @@ class N8NDocumentationMCPServer {
         }
         return coerced;
     }
+    async listExecutionsInsteadOfGet(args) {
+        if ((0, tool_policy_1.isOperationDisabled)('n8n_executions', 'list')) {
+            throw new Error('id is required for action=get');
+        }
+        const result = await n8nHandlers.handleListExecutions(args, this.instanceContext);
+        if (!result.success)
+            return result;
+        const scope = (0, param_aliases_1.hasText)(args.workflowId) ? `executions of workflow ${args.workflowId}` : 'recent executions';
+        return {
+            ...result,
+            message: `action=get was called without an execution id, so ${scope} were listed instead. Pass id to get one execution.`
+        };
+    }
     async executeTool(name, args) {
         args = args || {};
         const disabledTools = this.getDisabledTools();
@@ -1123,19 +1153,21 @@ class N8NDocumentationMCPServer {
                     includeOperations: args.includeOperations,
                     source: args.source
                 });
-            case 'get_node':
+            case 'get_node': {
                 this.validateToolParams(name, args, ['nodeType']);
-                if (args.mode === 'docs') {
+                const { mode: nodeMode, detail: nodeDetail } = (0, param_aliases_1.resolveGetNodeAliases)(args.mode, args.detail);
+                if (nodeMode === 'docs') {
                     return this.getNodeDocumentation(args.nodeType);
                 }
-                if (args.mode === 'search_properties') {
+                if (nodeMode === 'search_properties') {
                     if (!args.propertyQuery) {
                         throw new Error('propertyQuery is required for mode=search_properties');
                     }
                     const maxResults = args.maxPropertyResults !== undefined ? Number(args.maxPropertyResults) || 20 : 20;
                     return this.searchNodeProperties(args.nodeType, args.propertyQuery, maxResults);
                 }
-                return this.getNode(args.nodeType, args.detail, args.mode, args.includeTypeInfo, args.includeExamples, args.fromVersion, args.toVersion);
+                return this.getNode(args.nodeType, nodeDetail, nodeMode, args.includeTypeInfo, args.includeExamples, args.fromVersion, args.toVersion);
+            }
             case 'validate_node':
                 this.validateToolParams(name, args, ['nodeType', 'config']);
                 if (typeof args.config !== 'object' || args.config === null) {
@@ -1271,27 +1303,32 @@ class N8NDocumentationMCPServer {
                 if (!this.repository)
                     throw new Error('Repository not initialized');
                 return n8nHandlers.handleAutofixWorkflow(args, this.repository, this.instanceContext);
-            case 'n8n_test_workflow':
-                this.validateToolParams(name, args, ['workflowId']);
-                return n8nHandlers.handleTestWorkflow(args, this.instanceContext);
+            case 'n8n_test_workflow': {
+                const testArgs = (0, param_aliases_1.withWorkflowIdAlias)(args);
+                this.validateToolParams(name, testArgs);
+                return n8nHandlers.handleTestWorkflow(testArgs, this.instanceContext);
+            }
             case 'n8n_executions': {
-                this.validateToolParams(name, args, ['action']);
-                const execAction = args.action;
+                this.validateToolParams(name, args);
+                const execAction = String((0, tool_policy_1.resolveRequestedOperation)(name, args));
                 switch (execAction) {
                     case 'get':
-                        if (!args.id) {
-                            throw new Error('id is required for action=get');
+                        if (!(0, param_aliases_1.hasText)(args.id)) {
+                            return this.listExecutionsInsteadOfGet(args);
                         }
                         return n8nHandlers.handleGetExecution(args, this.instanceContext);
                     case 'list':
                         return n8nHandlers.handleListExecutions(args, this.instanceContext);
                     case 'delete':
-                        if (!args.id) {
+                        if (!(0, param_aliases_1.hasText)(args.id)) {
                             throw new Error('id is required for action=delete');
                         }
                         return n8nHandlers.handleDeleteExecution(args, this.instanceContext);
-                    default:
-                        throw new Error(`Unknown action: ${execAction}. Valid actions: get, list, delete`);
+                    default: {
+                        const message = `Unknown action: ${execAction}. Valid actions: get, list, delete.`;
+                        const hint = (0, param_aliases_1.suggestExecutionsAction)(execAction);
+                        throw new Error(hint ? `${message} ${hint}` : message);
+                    }
                 }
             }
             case 'n8n_evaluations': {
@@ -1327,8 +1364,7 @@ class N8NDocumentationMCPServer {
                 }
                 return n8nHandlers.handleHealthCheck(this.instanceContext);
             case 'n8n_workflow_versions':
-                this.validateToolParams(name, args, ['mode']);
-                return n8nHandlers.handleWorkflowVersions(args, this.repository, this.instanceContext);
+                return n8nHandlers.handleWorkflowVersions((0, param_aliases_1.withWorkflowIdAlias)(args), this.repository, this.instanceContext);
             case 'n8n_deploy_template':
                 this.validateToolParams(name, args, ['templateId']);
                 await this.ensureInitialized();
@@ -2413,7 +2449,7 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
             throw new Error(`get_node: Invalid detail level "${detail}". Valid options: ${validDetailLevels.join(', ')}`);
         }
         if (!validModes.includes(mode)) {
-            throw new Error(`get_node: Invalid mode "${mode}". Valid options: ${validModes.join(', ')}`);
+            throw new Error(`get_node: Invalid mode "${mode}". Valid options: info, docs, search_properties, ${validModes.slice(1).join(', ')}`);
         }
         const normalizedType = node_type_normalizer_1.NodeTypeNormalizer.normalizeToFullForm(nodeType);
         if (mode !== 'info') {