n8n-mcp 2.27.2 → 2.28.0

package/dist/triggers/types.d.ts

@@ -0,0 +1,76 @@
+import { WorkflowNode } from '../types/n8n-api';
+export type TriggerType = 'webhook' | 'form' | 'chat';
+export interface BaseTriggerInput {
+    workflowId: string;
+    triggerType?: TriggerType;
+    data?: Record<string, unknown>;
+    headers?: Record<string, string>;
+    timeout?: number;
+    waitForResponse?: boolean;
+}
+export interface WebhookTriggerInput extends BaseTriggerInput {
+    triggerType: 'webhook';
+    httpMethod?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    webhookPath?: string;
+}
+export interface FormTriggerInput extends BaseTriggerInput {
+    triggerType: 'form';
+    formData?: Record<string, unknown>;
+}
+export interface ChatTriggerInput extends BaseTriggerInput {
+    triggerType: 'chat';
+    message: string;
+    sessionId?: string;
+}
+export type TriggerInput = WebhookTriggerInput | FormTriggerInput | ChatTriggerInput;
+export interface TriggerResponse {
+    success: boolean;
+    triggerType: TriggerType;
+    workflowId: string;
+    executionId?: string;
+    status?: number;
+    statusText?: string;
+    data?: unknown;
+    error?: string;
+    code?: string;
+    details?: Record<string, unknown>;
+    metadata: {
+        duration: number;
+        webhookPath?: string;
+        sessionId?: string;
+        httpMethod?: string;
+    };
+}
+export interface TriggerHandlerCapabilities {
+    requiresActiveWorkflow: boolean;
+    supportedMethods?: string[];
+    canPassInputData: boolean;
+}
+export interface DetectedTrigger {
+    type: TriggerType;
+    node: WorkflowNode;
+    webhookPath?: string;
+    httpMethod?: string;
+    formFields?: string[];
+    chatConfig?: {
+        responseMode?: string;
+    };
+}
+export interface TriggerDetectionResult {
+    detected: boolean;
+    trigger?: DetectedTrigger;
+    reason?: string;
+}
+export interface TestWorkflowInput {
+    workflowId: string;
+    triggerType?: TriggerType;
+    httpMethod?: 'GET' | 'POST' | 'PUT' | 'DELETE';
+    webhookPath?: string;
+    message?: string;
+    sessionId?: string;
+    data?: Record<string, unknown>;
+    headers?: Record<string, string>;
+    timeout?: number;
+    waitForResponse?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/triggers/types.d.ts.map

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

package/dist/triggers/types.js

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

package/dist/triggers/types.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-mcp",
-  "version": "2.27.2",
+  "version": "2.28.0",
   "description": "Integration between n8n workflow automation and Model Context Protocol (MCP)",
   "dependencies": {
     "@modelcontextprotocol/sdk": "1.20.1",

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

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

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

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

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

@@ -1,120 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.n8nTriggerWebhookWorkflowDoc = void 0;
-exports.n8nTriggerWebhookWorkflowDoc = {
-    name: 'n8n_trigger_webhook_workflow',
-    category: 'workflow_management',
-    essentials: {
-        description: 'Trigger workflow via webhook. Must be ACTIVE with Webhook node. Method must match config.',
-        keyParameters: ['webhookUrl', 'httpMethod', 'data'],
-        example: 'n8n_trigger_webhook_workflow({webhookUrl: "https://n8n.example.com/webhook/abc-def-ghi"})',
-        performance: 'Immediate trigger, response time depends on workflow complexity',
-        tips: [
-            'Workflow MUST be active and contain a Webhook node for triggering',
-            'HTTP method must match webhook node configuration (often GET)',
-            'Use waitForResponse:false for async execution without waiting'
-        ]
-    },
-    full: {
-        description: `Triggers a workflow execution via its webhook URL. This is the primary method for external systems to start n8n workflows. The target workflow must be active and contain a properly configured Webhook node as the trigger. The HTTP method used must match the webhook configuration.`,
-        parameters: {
-            webhookUrl: {
-                type: 'string',
-                required: true,
-                description: 'Full webhook URL from n8n workflow (e.g., https://n8n.example.com/webhook/abc-def-ghi)'
-            },
-            httpMethod: {
-                type: 'string',
-                required: false,
-                enum: ['GET', 'POST', 'PUT', 'DELETE'],
-                description: 'HTTP method (must match webhook configuration, often GET). Defaults to GET if not specified'
-            },
-            data: {
-                type: 'object',
-                required: false,
-                description: 'Data to send with the webhook request. For GET requests, becomes query parameters'
-            },
-            headers: {
-                type: 'object',
-                required: false,
-                description: 'Additional HTTP headers to include in the request'
-            },
-            waitForResponse: {
-                type: 'boolean',
-                required: false,
-                description: 'Wait for workflow completion and return results (default: true). Set to false for fire-and-forget'
-            }
-        },
-        returns: `Webhook response data if waitForResponse is true, or immediate acknowledgment if false. Response format depends on webhook node configuration.`,
-        examples: [
-            'n8n_trigger_webhook_workflow({webhookUrl: "https://n8n.example.com/webhook/order-process"}) - Trigger with GET',
-            'n8n_trigger_webhook_workflow({webhookUrl: "https://n8n.example.com/webhook/data-import", httpMethod: "POST", data: {name: "John", email: "john@example.com"}}) - POST with data',
-            'n8n_trigger_webhook_workflow({webhookUrl: "https://n8n.example.com/webhook/async-job", waitForResponse: false}) - Fire and forget',
-            'n8n_trigger_webhook_workflow({webhookUrl: "https://n8n.example.com/webhook/api", headers: {"API-Key": "secret"}}) - With auth headers'
-        ],
-        useCases: [
-            'Trigger data processing workflows from external applications',
-            'Start scheduled jobs manually via webhook',
-            'Integrate n8n workflows with third-party services',
-            'Create REST API endpoints using n8n workflows',
-            'Implement event-driven architectures with n8n'
-        ],
-        performance: `Performance varies based on workflow complexity and waitForResponse setting. Synchronous calls (waitForResponse: true) block until workflow completes. For long-running workflows, use async mode (waitForResponse: false) and monitor execution separately.`,
-        errorHandling: `**Enhanced Error Messages with Execution Guidance**
-
-When a webhook trigger fails, the error response now includes specific guidance to help debug the issue:
-
-**Error with Execution ID** (workflow started but failed):
-- Format: "Workflow {workflowId} execution {executionId} failed. Use n8n_executions({action: 'get', id: '{executionId}', mode: 'preview'}) to investigate the error."
-- Response includes: executionId and workflowId fields for direct access
-- Recommended action: Use n8n_executions with action='get' and mode='preview' for fast, efficient error inspection
-
-**Error without Execution ID** (workflow didn't start):
-- Format: "Workflow failed to execute. Use n8n_executions({action: 'list'}) to find recent executions, then n8n_executions({action: 'get', mode: 'preview'}) to investigate."
-- Recommended action: Check recent executions with n8n_executions({action: 'list'})
-
-**Why mode='preview'?**
-- Fast: <50ms response time
-- Efficient: ~500 tokens (vs 50K+ for full mode)
-- Safe: No timeout or token limit risks
-- Informative: Shows structure, counts, and error details
-- Provides recommendations for fetching more data if needed
-
-**Example Error Responses**:
-\`\`\`json
-{
-  "success": false,
-  "error": "Workflow wf_123 execution exec_456 failed. Use n8n_get_execution({id: 'exec_456', mode: 'preview'}) to investigate the error.",
-  "executionId": "exec_456",
-  "workflowId": "wf_123",
-  "code": "SERVER_ERROR"
-}
-\`\`\`
-
-**Investigation Workflow**:
-1. Trigger returns error with execution ID
-2. Call n8n_executions({action: 'get', id: executionId, mode: 'preview'}) to see structure and error
-3. Based on preview recommendation, fetch more data if needed
-4. Fix issues in workflow and retry`,
-        bestPractices: [
-            'Always verify workflow is active before attempting webhook triggers',
-            'Match HTTP method exactly with webhook node configuration',
-            'Use async mode (waitForResponse: false) for long-running workflows',
-            'Include authentication headers when webhook requires them',
-            'Test webhook URL manually first to ensure it works',
-            'When errors occur, use n8n_executions with action="get" and mode="preview" first for efficient debugging',
-            'Store execution IDs from error responses for later investigation'
-        ],
-        pitfalls: [
-            'Workflow must be ACTIVE - inactive workflows cannot be triggered',
-            'HTTP method mismatch returns 404 even if URL is correct',
-            'Webhook node must be the trigger node in the workflow',
-            'Timeout errors occur with long workflows in sync mode',
-            'Data format must match webhook node expectations',
-            'Error messages always include n8n_executions guidance - follow the suggested steps for efficient debugging',
-            'Execution IDs in error responses are crucial for debugging - always check for and use them'
-        ],
-        relatedTools: ['n8n_executions', 'n8n_get_workflow', 'n8n_create_workflow']
-    }
-};
-//# sourceMappingURL=n8n-trigger-webhook-workflow.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"n8n-trigger-webhook-workflow.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-trigger-webhook-workflow.ts"],"names":[],"mappings":";;;AAEa,QAAA,4BAA4B,GAAsB;IAC7D,IAAI,EAAE,8BAA8B;IACpC,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,2FAA2F;QACxG,aAAa,EAAE,CAAC,YAAY,EAAE,YAAY,EAAE,MAAM,CAAC;QACnD,OAAO,EAAE,2FAA2F;QACpG,WAAW,EAAE,iEAAiE;QAC9E,IAAI,EAAE;YACJ,mEAAmE;YACnE,+DAA+D;YAC/D,+DAA+D;SAChE;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,yRAAyR;QACtS,UAAU,EAAE;YACV,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,wFAAwF;aACtG;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC;gBACtC,WAAW,EAAE,6FAA6F;aAC3G;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,mFAAmF;aACjG;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,mDAAmD;aACjE;YACD,eAAe,EAAE;gBACf,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,mGAAmG;aACjH;SACF;QACD,OAAO,EAAE,gJAAgJ;QACzJ,QAAQ,EAAE;YACR,gHAAgH;YAChH,iLAAiL;YACjL,mIAAmI;YACnI,uIAAuI;SACxI;QACD,QAAQ,EAAE;YACR,8DAA8D;YAC9D,2CAA2C;YAC3C,mDAAmD;YACnD,+CAA+C;YAC/C,+CAA+C;SAChD;QACD,WAAW,EAAE,8PAA8P;QAC3Q,aAAa,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oCAmCiB;QAChC,aAAa,EAAE;YACb,qEAAqE;YACrE,2DAA2D;YAC3D,oEAAoE;YACpE,2DAA2D;YAC3D,oDAAoD;YACpD,0GAA0G;YAC1G,kEAAkE;SACnE;QACD,QAAQ,EAAE;YACR,kEAAkE;YAClE,yDAAyD;YACzD,uDAAuD;YACvD,uDAAuD;YACvD,kDAAkD;YAClD,4GAA4G;YAC5G,4FAA4F;SAC7F;QACD,YAAY,EAAE,CAAC,gBAAgB,EAAE,kBAAkB,EAAE,qBAAqB,CAAC;KAC5E;CACF,CAAC"}