n8n-mcp 2.26.1 → 2.26.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (160) hide show
  1. package/dist/mcp/tool-docs/configuration/get-node.d.ts +3 -0
  2. package/dist/mcp/tool-docs/configuration/get-node.d.ts.map +1 -0
  3. package/dist/mcp/tool-docs/configuration/get-node.js +92 -0
  4. package/dist/mcp/tool-docs/configuration/get-node.js.map +1 -0
  5. package/dist/mcp/tool-docs/configuration/index.d.ts +1 -6
  6. package/dist/mcp/tool-docs/configuration/index.d.ts.map +1 -1
  7. package/dist/mcp/tool-docs/configuration/index.js +3 -13
  8. package/dist/mcp/tool-docs/configuration/index.js.map +1 -1
  9. package/dist/mcp/tool-docs/discovery/index.d.ts +0 -3
  10. package/dist/mcp/tool-docs/discovery/index.d.ts.map +1 -1
  11. package/dist/mcp/tool-docs/discovery/index.js +1 -7
  12. package/dist/mcp/tool-docs/discovery/index.js.map +1 -1
  13. package/dist/mcp/tool-docs/discovery/search-nodes.js +1 -1
  14. package/dist/mcp/tool-docs/discovery/search-nodes.js.map +1 -1
  15. package/dist/mcp/tool-docs/guides/ai-agents-guide.d.ts.map +1 -1
  16. package/dist/mcp/tool-docs/guides/ai-agents-guide.js +2 -3
  17. package/dist/mcp/tool-docs/guides/ai-agents-guide.js.map +1 -1
  18. package/dist/mcp/tool-docs/index.d.ts.map +1 -1
  19. package/dist/mcp/tool-docs/index.js +3 -23
  20. package/dist/mcp/tool-docs/index.js.map +1 -1
  21. package/dist/mcp/tool-docs/system/tools-documentation.js +1 -1
  22. package/dist/mcp/tool-docs/system/tools-documentation.js.map +1 -1
  23. package/dist/mcp/tool-docs/templates/get-template.js +4 -4
  24. package/dist/mcp/tool-docs/templates/get-template.js.map +1 -1
  25. package/dist/mcp/tool-docs/templates/index.d.ts +0 -4
  26. package/dist/mcp/tool-docs/templates/index.d.ts.map +1 -1
  27. package/dist/mcp/tool-docs/templates/index.js +1 -9
  28. package/dist/mcp/tool-docs/templates/index.js.map +1 -1
  29. package/dist/mcp/tool-docs/templates/search-templates.d.ts.map +1 -1
  30. package/dist/mcp/tool-docs/templates/search-templates.js +102 -48
  31. package/dist/mcp/tool-docs/templates/search-templates.js.map +1 -1
  32. package/dist/mcp/tool-docs/validation/index.d.ts +1 -4
  33. package/dist/mcp/tool-docs/validation/index.d.ts.map +1 -1
  34. package/dist/mcp/tool-docs/validation/index.js +3 -9
  35. package/dist/mcp/tool-docs/validation/index.js.map +1 -1
  36. package/dist/mcp/tool-docs/validation/validate-node.d.ts +3 -0
  37. package/dist/mcp/tool-docs/validation/validate-node.d.ts.map +1 -0
  38. package/dist/mcp/tool-docs/validation/validate-node.js +84 -0
  39. package/dist/mcp/tool-docs/validation/validate-node.js.map +1 -0
  40. package/dist/mcp/tool-docs/validation/validate-workflow.js +1 -1
  41. package/dist/mcp/tool-docs/validation/validate-workflow.js.map +1 -1
  42. package/dist/mcp/tool-docs/workflow_management/index.d.ts +1 -6
  43. package/dist/mcp/tool-docs/workflow_management/index.d.ts.map +1 -1
  44. package/dist/mcp/tool-docs/workflow_management/index.js +3 -13
  45. package/dist/mcp/tool-docs/workflow_management/index.js.map +1 -1
  46. package/dist/mcp/tool-docs/workflow_management/n8n-autofix-workflow.d.ts.map +1 -1
  47. package/dist/mcp/tool-docs/workflow_management/n8n-autofix-workflow.js +2 -3
  48. package/dist/mcp/tool-docs/workflow_management/n8n-autofix-workflow.js.map +1 -1
  49. package/dist/mcp/tool-docs/workflow_management/n8n-delete-workflow.js +1 -1
  50. package/dist/mcp/tool-docs/workflow_management/n8n-delete-workflow.js.map +1 -1
  51. package/dist/mcp/tool-docs/workflow_management/n8n-executions.d.ts +3 -0
  52. package/dist/mcp/tool-docs/workflow_management/n8n-executions.d.ts.map +1 -0
  53. package/dist/mcp/tool-docs/workflow_management/n8n-executions.js +86 -0
  54. package/dist/mcp/tool-docs/workflow_management/n8n-executions.js.map +1 -0
  55. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow.d.ts.map +1 -1
  56. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow.js +44 -25
  57. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow.js.map +1 -1
  58. package/dist/mcp/tool-docs/workflow_management/n8n-list-workflows.js +1 -1
  59. package/dist/mcp/tool-docs/workflow_management/n8n-list-workflows.js.map +1 -1
  60. package/dist/mcp/tool-docs/workflow_management/n8n-trigger-webhook-workflow.js +8 -8
  61. package/dist/mcp/tool-docs/workflow_management/n8n-trigger-webhook-workflow.js.map +1 -1
  62. package/dist/mcp/tools-documentation.d.ts.map +1 -1
  63. package/dist/mcp/tools-documentation.js +39 -34
  64. package/dist/mcp/tools-documentation.js.map +1 -1
  65. package/dist/mcp/tools-n8n-friendly.d.ts.map +1 -1
  66. package/dist/mcp/tools-n8n-friendly.js +20 -62
  67. package/dist/mcp/tools-n8n-friendly.js.map +1 -1
  68. package/package.json +1 -1
  69. package/dist/mcp/tool-docs/configuration/get-node-as-tool-info.d.ts +0 -3
  70. package/dist/mcp/tool-docs/configuration/get-node-as-tool-info.d.ts.map +0 -1
  71. package/dist/mcp/tool-docs/configuration/get-node-as-tool-info.js +0 -73
  72. package/dist/mcp/tool-docs/configuration/get-node-as-tool-info.js.map +0 -1
  73. package/dist/mcp/tool-docs/configuration/get-node-documentation.d.ts +0 -3
  74. package/dist/mcp/tool-docs/configuration/get-node-documentation.d.ts.map +0 -1
  75. package/dist/mcp/tool-docs/configuration/get-node-documentation.js +0 -47
  76. package/dist/mcp/tool-docs/configuration/get-node-documentation.js.map +0 -1
  77. package/dist/mcp/tool-docs/configuration/get-node-essentials.d.ts +0 -3
  78. package/dist/mcp/tool-docs/configuration/get-node-essentials.d.ts.map +0 -1
  79. package/dist/mcp/tool-docs/configuration/get-node-essentials.js +0 -88
  80. package/dist/mcp/tool-docs/configuration/get-node-essentials.js.map +0 -1
  81. package/dist/mcp/tool-docs/configuration/get-node-info.d.ts +0 -3
  82. package/dist/mcp/tool-docs/configuration/get-node-info.d.ts.map +0 -1
  83. package/dist/mcp/tool-docs/configuration/get-node-info.js +0 -100
  84. package/dist/mcp/tool-docs/configuration/get-node-info.js.map +0 -1
  85. package/dist/mcp/tool-docs/configuration/get-property-dependencies.d.ts +0 -3
  86. package/dist/mcp/tool-docs/configuration/get-property-dependencies.d.ts.map +0 -1
  87. package/dist/mcp/tool-docs/configuration/get-property-dependencies.js +0 -81
  88. package/dist/mcp/tool-docs/configuration/get-property-dependencies.js.map +0 -1
  89. package/dist/mcp/tool-docs/configuration/search-node-properties.d.ts +0 -3
  90. package/dist/mcp/tool-docs/configuration/search-node-properties.d.ts.map +0 -1
  91. package/dist/mcp/tool-docs/configuration/search-node-properties.js +0 -99
  92. package/dist/mcp/tool-docs/configuration/search-node-properties.js.map +0 -1
  93. package/dist/mcp/tool-docs/discovery/get-database-statistics.d.ts +0 -3
  94. package/dist/mcp/tool-docs/discovery/get-database-statistics.d.ts.map +0 -1
  95. package/dist/mcp/tool-docs/discovery/get-database-statistics.js +0 -69
  96. package/dist/mcp/tool-docs/discovery/get-database-statistics.js.map +0 -1
  97. package/dist/mcp/tool-docs/discovery/list-ai-tools.d.ts +0 -3
  98. package/dist/mcp/tool-docs/discovery/list-ai-tools.d.ts.map +0 -1
  99. package/dist/mcp/tool-docs/discovery/list-ai-tools.js +0 -53
  100. package/dist/mcp/tool-docs/discovery/list-ai-tools.js.map +0 -1
  101. package/dist/mcp/tool-docs/discovery/list-nodes.d.ts +0 -3
  102. package/dist/mcp/tool-docs/discovery/list-nodes.d.ts.map +0 -1
  103. package/dist/mcp/tool-docs/discovery/list-nodes.js +0 -54
  104. package/dist/mcp/tool-docs/discovery/list-nodes.js.map +0 -1
  105. package/dist/mcp/tool-docs/templates/get-templates-for-task.d.ts +0 -3
  106. package/dist/mcp/tool-docs/templates/get-templates-for-task.d.ts.map +0 -1
  107. package/dist/mcp/tool-docs/templates/get-templates-for-task.js +0 -76
  108. package/dist/mcp/tool-docs/templates/get-templates-for-task.js.map +0 -1
  109. package/dist/mcp/tool-docs/templates/list-node-templates.d.ts +0 -3
  110. package/dist/mcp/tool-docs/templates/list-node-templates.d.ts.map +0 -1
  111. package/dist/mcp/tool-docs/templates/list-node-templates.js +0 -80
  112. package/dist/mcp/tool-docs/templates/list-node-templates.js.map +0 -1
  113. package/dist/mcp/tool-docs/templates/list-tasks.d.ts +0 -3
  114. package/dist/mcp/tool-docs/templates/list-tasks.d.ts.map +0 -1
  115. package/dist/mcp/tool-docs/templates/list-tasks.js +0 -48
  116. package/dist/mcp/tool-docs/templates/list-tasks.js.map +0 -1
  117. package/dist/mcp/tool-docs/templates/search-templates-by-metadata.d.ts +0 -3
  118. package/dist/mcp/tool-docs/templates/search-templates-by-metadata.d.ts.map +0 -1
  119. package/dist/mcp/tool-docs/templates/search-templates-by-metadata.js +0 -120
  120. package/dist/mcp/tool-docs/templates/search-templates-by-metadata.js.map +0 -1
  121. package/dist/mcp/tool-docs/validation/validate-node-minimal.d.ts +0 -3
  122. package/dist/mcp/tool-docs/validation/validate-node-minimal.d.ts.map +0 -1
  123. package/dist/mcp/tool-docs/validation/validate-node-minimal.js +0 -49
  124. package/dist/mcp/tool-docs/validation/validate-node-minimal.js.map +0 -1
  125. package/dist/mcp/tool-docs/validation/validate-node-operation.d.ts +0 -3
  126. package/dist/mcp/tool-docs/validation/validate-node-operation.d.ts.map +0 -1
  127. package/dist/mcp/tool-docs/validation/validate-node-operation.js +0 -100
  128. package/dist/mcp/tool-docs/validation/validate-node-operation.js.map +0 -1
  129. package/dist/mcp/tool-docs/validation/validate-workflow-connections.d.ts +0 -3
  130. package/dist/mcp/tool-docs/validation/validate-workflow-connections.d.ts.map +0 -1
  131. package/dist/mcp/tool-docs/validation/validate-workflow-connections.js +0 -58
  132. package/dist/mcp/tool-docs/validation/validate-workflow-connections.js.map +0 -1
  133. package/dist/mcp/tool-docs/validation/validate-workflow-expressions.d.ts +0 -3
  134. package/dist/mcp/tool-docs/validation/validate-workflow-expressions.d.ts.map +0 -1
  135. package/dist/mcp/tool-docs/validation/validate-workflow-expressions.js +0 -58
  136. package/dist/mcp/tool-docs/validation/validate-workflow-expressions.js.map +0 -1
  137. package/dist/mcp/tool-docs/workflow_management/n8n-delete-execution.d.ts +0 -3
  138. package/dist/mcp/tool-docs/workflow_management/n8n-delete-execution.d.ts.map +0 -1
  139. package/dist/mcp/tool-docs/workflow_management/n8n-delete-execution.js +0 -59
  140. package/dist/mcp/tool-docs/workflow_management/n8n-delete-execution.js.map +0 -1
  141. package/dist/mcp/tool-docs/workflow_management/n8n-get-execution.d.ts +0 -3
  142. package/dist/mcp/tool-docs/workflow_management/n8n-get-execution.d.ts.map +0 -1
  143. package/dist/mcp/tool-docs/workflow_management/n8n-get-execution.js +0 -270
  144. package/dist/mcp/tool-docs/workflow_management/n8n-get-execution.js.map +0 -1
  145. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-details.d.ts +0 -3
  146. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-details.d.ts.map +0 -1
  147. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-details.js +0 -51
  148. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-details.js.map +0 -1
  149. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-minimal.d.ts +0 -3
  150. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-minimal.d.ts.map +0 -1
  151. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-minimal.js +0 -51
  152. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-minimal.js.map +0 -1
  153. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-structure.d.ts +0 -3
  154. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-structure.d.ts.map +0 -1
  155. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-structure.js +0 -51
  156. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-structure.js.map +0 -1
  157. package/dist/mcp/tool-docs/workflow_management/n8n-list-executions.d.ts +0 -3
  158. package/dist/mcp/tool-docs/workflow_management/n8n-list-executions.d.ts.map +0 -1
  159. package/dist/mcp/tool-docs/workflow_management/n8n-list-executions.js +0 -86
  160. package/dist/mcp/tool-docs/workflow_management/n8n-list-executions.js.map +0 -1
@@ -1,59 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.n8nDeleteExecutionDoc = void 0;
4
- exports.n8nDeleteExecutionDoc = {
5
- name: 'n8n_delete_execution',
6
- category: 'workflow_management',
7
- essentials: {
8
- description: 'Delete an execution record. This only removes the execution history, not any data processed.',
9
- keyParameters: ['id'],
10
- example: 'n8n_delete_execution({id: "12345"})',
11
- performance: 'Immediate deletion, no undo available',
12
- tips: [
13
- 'Deletion is permanent - execution cannot be recovered',
14
- 'Only removes execution history, not external data changes',
15
- 'Use for cleanup of test executions or sensitive data'
16
- ]
17
- },
18
- full: {
19
- description: `Permanently deletes a workflow execution record from n8n's history. This removes the execution metadata, logs, and any stored input/output data. However, it does NOT undo any actions the workflow performed (API calls, database changes, file operations, etc.). Use this for cleaning up test executions, removing sensitive data, or managing storage.`,
20
- parameters: {
21
- id: {
22
- type: 'string',
23
- required: true,
24
- description: 'The execution ID to delete. This action cannot be undone'
25
- }
26
- },
27
- returns: `Confirmation of deletion or error if execution not found. No data is returned about the deleted execution.`,
28
- examples: [
29
- 'n8n_delete_execution({id: "12345"}) - Delete a specific execution',
30
- 'n8n_delete_execution({id: "test-run-567"}) - Clean up test execution',
31
- 'n8n_delete_execution({id: "sensitive-data-890"}) - Remove execution with sensitive data',
32
- 'n8n_delete_execution({id: "failed-execution-123"}) - Delete failed execution after debugging'
33
- ],
34
- useCases: [
35
- 'Clean up test or development execution history',
36
- 'Remove executions containing sensitive or personal data',
37
- 'Manage storage by deleting old execution records',
38
- 'Clean up after debugging failed workflows',
39
- 'Comply with data retention policies'
40
- ],
41
- performance: `Deletion is immediate and permanent. The operation is fast (< 100ms) as it only removes database records. No external systems or data are affected.`,
42
- bestPractices: [
43
- 'Verify execution ID before deletion - action cannot be undone',
44
- 'Consider exporting execution data before deletion if needed',
45
- 'Use list_executions to find executions to delete',
46
- 'Document why executions were deleted for audit trails',
47
- 'Remember deletion only affects n8n records, not external changes'
48
- ],
49
- pitfalls: [
50
- 'Deletion is PERMANENT - no undo or recovery possible',
51
- 'Does NOT reverse workflow actions (API calls, DB changes, etc.)',
52
- 'Deleting executions breaks audit trails and debugging history',
53
- 'Cannot delete currently running executions (waiting status)',
54
- 'Bulk deletion not supported - must delete one at a time'
55
- ],
56
- relatedTools: ['n8n_list_executions', 'n8n_get_execution', 'n8n_trigger_webhook_workflow']
57
- }
58
- };
59
- //# sourceMappingURL=n8n-delete-execution.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"n8n-delete-execution.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-delete-execution.ts"],"names":[],"mappings":";;;AAEa,QAAA,qBAAqB,GAAsB;IACtD,IAAI,EAAE,sBAAsB;IAC5B,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,8FAA8F;QAC3G,aAAa,EAAE,CAAC,IAAI,CAAC;QACrB,OAAO,EAAE,qCAAqC;QAC9C,WAAW,EAAE,uCAAuC;QACpD,IAAI,EAAE;YACJ,uDAAuD;YACvD,2DAA2D;YAC3D,sDAAsD;SACvD;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,6VAA6V;QAC1W,UAAU,EAAE;YACV,EAAE,EAAE;gBACF,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,0DAA0D;aACxE;SACF;QACD,OAAO,EAAE,4GAA4G;QACrH,QAAQ,EAAE;YACR,mEAAmE;YACnE,sEAAsE;YACtE,yFAAyF;YACzF,8FAA8F;SAC/F;QACD,QAAQ,EAAE;YACR,gDAAgD;YAChD,yDAAyD;YACzD,kDAAkD;YAClD,2CAA2C;YAC3C,qCAAqC;SACtC;QACD,WAAW,EAAE,qJAAqJ;QAClK,aAAa,EAAE;YACb,+DAA+D;YAC/D,6DAA6D;YAC7D,kDAAkD;YAClD,uDAAuD;YACvD,kEAAkE;SACnE;QACD,QAAQ,EAAE;YACR,sDAAsD;YACtD,iEAAiE;YACjE,+DAA+D;YAC/D,6DAA6D;YAC7D,yDAAyD;SAC1D;QACD,YAAY,EAAE,CAAC,qBAAqB,EAAE,mBAAmB,EAAE,8BAA8B,CAAC;KAC3F;CACF,CAAC"}
@@ -1,3 +0,0 @@
1
- import { ToolDocumentation } from '../types';
2
- export declare const n8nGetExecutionDoc: ToolDocumentation;
3
- //# sourceMappingURL=n8n-get-execution.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"n8n-get-execution.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-get-execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,kBAAkB,EAAE,iBAwRhC,CAAC"}
@@ -1,270 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.n8nGetExecutionDoc = void 0;
4
- exports.n8nGetExecutionDoc = {
5
- name: 'n8n_get_execution',
6
- category: 'workflow_management',
7
- essentials: {
8
- description: 'Get execution details with smart filtering to avoid token limits. Use preview mode first to assess data size, then fetch appropriately.',
9
- keyParameters: ['id', 'mode', 'itemsLimit', 'nodeNames'],
10
- example: `
11
- // RECOMMENDED WORKFLOW:
12
- // 1. Preview first
13
- n8n_get_execution({id: "12345", mode: "preview"})
14
- // Returns: structure, counts, size estimate, recommendation
15
-
16
- // 2. Based on recommendation, fetch data:
17
- n8n_get_execution({id: "12345", mode: "summary"}) // 2 items per node
18
- n8n_get_execution({id: "12345", mode: "filtered", itemsLimit: 5}) // 5 items
19
- n8n_get_execution({id: "12345", nodeNames: ["HTTP Request"]}) // Specific node
20
- `,
21
- performance: 'Preview: <50ms, Summary: <200ms, Full: depends on data size',
22
- tips: [
23
- 'ALWAYS use preview mode first for large datasets',
24
- 'Preview shows structure + counts without consuming tokens for data',
25
- 'Summary mode (2 items per node) is safe default',
26
- 'Use nodeNames to focus on specific nodes only',
27
- 'itemsLimit: 0 = structure only, -1 = unlimited',
28
- 'Check recommendation.suggestedMode from preview'
29
- ]
30
- },
31
- full: {
32
- description: `Retrieves and intelligently filters execution data to enable inspection without exceeding token limits. This tool provides multiple modes for different use cases, from quick previews to complete data retrieval.
33
-
34
- **The Problem**: Workflows processing large datasets (50+ database records) generate execution data that exceeds token/response limits, making traditional full-data fetching impossible.
35
-
36
- **The Solution**: Four retrieval modes with smart filtering:
37
- 1. **Preview**: Structure + counts only (no actual data)
38
- 2. **Summary**: 2 sample items per node (safe default)
39
- 3. **Filtered**: Custom limits and node selection
40
- 4. **Full**: Complete data (use with caution)
41
-
42
- **Recommended Workflow**:
43
- 1. Start with preview mode to assess size
44
- 2. Use recommendation to choose appropriate mode
45
- 3. Fetch filtered data as needed`,
46
- parameters: {
47
- id: {
48
- type: 'string',
49
- required: true,
50
- description: 'The execution ID to retrieve. Obtained from list_executions or webhook trigger responses'
51
- },
52
- mode: {
53
- type: 'string',
54
- required: false,
55
- description: `Retrieval mode (default: auto-detect from other params):
56
- - 'preview': Structure, counts, size estimates - NO actual data (fastest)
57
- - 'summary': Metadata + 2 sample items per node (safe default)
58
- - 'filtered': Custom filtering with itemsLimit/nodeNames
59
- - 'full': Complete execution data (use with caution)`
60
- },
61
- nodeNames: {
62
- type: 'array',
63
- required: false,
64
- description: 'Filter to specific nodes by name. Example: ["HTTP Request", "Filter"]. Useful when you only need to inspect specific nodes.'
65
- },
66
- itemsLimit: {
67
- type: 'number',
68
- required: false,
69
- description: `Items to return per node (default: 2):
70
- - 0: Structure only (see data shape without values)
71
- - 1-N: Return N items per node
72
- - -1: Unlimited (return all items)
73
-
74
- Note: Structure-only mode (0) shows JSON schema without actual values.`
75
- },
76
- includeInputData: {
77
- type: 'boolean',
78
- required: false,
79
- description: 'Include input data in addition to output data (default: false). Useful for debugging data transformations.'
80
- },
81
- includeData: {
82
- type: 'boolean',
83
- required: false,
84
- description: 'DEPRECATED: Legacy parameter. Use mode instead. If true, maps to mode="summary" for backward compatibility.'
85
- }
86
- },
87
- returns: `**Preview Mode Response**:
88
- {
89
- mode: 'preview',
90
- preview: {
91
- totalNodes: number,
92
- executedNodes: number,
93
- estimatedSizeKB: number,
94
- nodes: {
95
- [nodeName]: {
96
- status: 'success' | 'error',
97
- itemCounts: { input: number, output: number },
98
- dataStructure: {...}, // JSON schema
99
- estimatedSizeKB: number
100
- }
101
- }
102
- },
103
- recommendation: {
104
- canFetchFull: boolean,
105
- suggestedMode: 'preview'|'summary'|'filtered'|'full',
106
- suggestedItemsLimit?: number,
107
- reason: string
108
- }
109
- }
110
-
111
- **Summary/Filtered/Full Mode Response**:
112
- {
113
- mode: 'summary' | 'filtered' | 'full',
114
- summary: {
115
- totalNodes: number,
116
- executedNodes: number,
117
- totalItems: number,
118
- hasMoreData: boolean // true if truncated
119
- },
120
- nodes: {
121
- [nodeName]: {
122
- executionTime: number,
123
- itemsInput: number,
124
- itemsOutput: number,
125
- status: 'success' | 'error',
126
- error?: string,
127
- data: {
128
- output: [...], // Actual data items
129
- metadata: {
130
- totalItems: number,
131
- itemsShown: number,
132
- truncated: boolean
133
- }
134
- }
135
- }
136
- }
137
- }`,
138
- examples: [
139
- `// Example 1: Preview workflow (RECOMMENDED FIRST STEP)
140
- n8n_get_execution({id: "exec_123", mode: "preview"})
141
- // Returns structure, counts, size, recommendation
142
- // Use this to decide how to fetch data`,
143
- `// Example 2: Follow recommendation
144
- const preview = n8n_get_execution({id: "exec_123", mode: "preview"});
145
- if (preview.recommendation.canFetchFull) {
146
- n8n_get_execution({id: "exec_123", mode: "full"});
147
- } else {
148
- n8n_get_execution({
149
- id: "exec_123",
150
- mode: "filtered",
151
- itemsLimit: preview.recommendation.suggestedItemsLimit
152
- });
153
- }`,
154
- `// Example 3: Summary mode (safe default for unknown datasets)
155
- n8n_get_execution({id: "exec_123", mode: "summary"})
156
- // Gets 2 items per node - safe for most cases`,
157
- `// Example 4: Filter to specific node
158
- n8n_get_execution({
159
- id: "exec_123",
160
- mode: "filtered",
161
- nodeNames: ["HTTP Request"],
162
- itemsLimit: 5
163
- })
164
- // Gets only HTTP Request node, 5 items`,
165
- `// Example 5: Structure only (see data shape)
166
- n8n_get_execution({
167
- id: "exec_123",
168
- mode: "filtered",
169
- itemsLimit: 0
170
- })
171
- // Returns JSON schema without actual values`,
172
- `// Example 6: Debug with input data
173
- n8n_get_execution({
174
- id: "exec_123",
175
- mode: "filtered",
176
- nodeNames: ["Transform"],
177
- itemsLimit: 2,
178
- includeInputData: true
179
- })
180
- // See both input and output for debugging`,
181
- `// Example 7: Backward compatibility (legacy)
182
- n8n_get_execution({id: "exec_123"}) // Minimal data
183
- n8n_get_execution({id: "exec_123", includeData: true}) // Maps to summary mode`
184
- ],
185
- useCases: [
186
- 'Monitor status of triggered workflows',
187
- 'Debug failed workflows by examining error messages and partial data',
188
- 'Inspect large datasets without exceeding token limits',
189
- 'Validate data transformations between nodes',
190
- 'Understand execution flow and timing',
191
- 'Track workflow performance metrics',
192
- 'Verify successful completion before proceeding',
193
- 'Extract specific data from execution results'
194
- ],
195
- performance: `**Response Times** (approximate):
196
- - Preview mode: <50ms (no data, just structure)
197
- - Summary mode: <200ms (2 items per node)
198
- - Filtered mode: 50-500ms (depends on filters)
199
- - Full mode: 200ms-5s (depends on data size)
200
-
201
- **Token Consumption**:
202
- - Preview: ~500 tokens (no data values)
203
- - Summary (2 items): ~2-5K tokens
204
- - Filtered (5 items): ~5-15K tokens
205
- - Full (50+ items): 50K+ tokens (may exceed limits)
206
-
207
- **Optimization Tips**:
208
- - Use preview for all large datasets
209
- - Use nodeNames to focus on relevant nodes only
210
- - Start with small itemsLimit and increase if needed
211
- - Use itemsLimit: 0 to see structure without data`,
212
- bestPractices: [
213
- 'ALWAYS use preview mode first for unknown datasets',
214
- 'Trust the recommendation.suggestedMode from preview',
215
- 'Use nodeNames to filter to relevant nodes only',
216
- 'Start with summary mode if preview indicates moderate size',
217
- 'Use itemsLimit: 0 to understand data structure',
218
- 'Check hasMoreData to know if results are truncated',
219
- 'Store execution IDs from triggers for later inspection',
220
- 'Use mode="filtered" with custom limits for large datasets',
221
- 'Include input data only when debugging transformations',
222
- 'Monitor summary.totalItems to understand dataset size'
223
- ],
224
- pitfalls: [
225
- 'DON\'T fetch full mode without previewing first - may timeout',
226
- 'DON\'T assume all data fits - always check hasMoreData',
227
- 'DON\'T ignore the recommendation from preview mode',
228
- 'Execution data is retained based on n8n settings - old executions may be purged',
229
- 'Binary data (files, images) is not fully included - only metadata',
230
- 'Status "waiting" indicates execution is still running',
231
- 'Error executions may have partial data from successful nodes',
232
- 'Very large individual items (>1MB) may be truncated',
233
- 'Preview mode estimates may be off by 10-20% for complex structures',
234
- 'Node names are case-sensitive in nodeNames filter'
235
- ],
236
- modeComparison: `**When to use each mode**:
237
-
238
- **Preview**:
239
- - ALWAYS use first for unknown datasets
240
- - When you need to know if data is safe to fetch
241
- - To see data structure without consuming tokens
242
- - To get size estimates and recommendations
243
-
244
- **Summary** (default):
245
- - Safe default for most cases
246
- - When you need representative samples
247
- - When preview recommends it
248
- - For quick data inspection
249
-
250
- **Filtered**:
251
- - When you need specific nodes only
252
- - When you need more than 2 items but not all
253
- - When preview recommends it with itemsLimit
254
- - For targeted data extraction
255
-
256
- **Full**:
257
- - ONLY when preview says canFetchFull: true
258
- - For small executions (< 20 items total)
259
- - When you genuinely need all data
260
- - When you're certain data fits in token limit`,
261
- relatedTools: [
262
- 'n8n_list_executions - Find execution IDs',
263
- 'n8n_trigger_webhook_workflow - Trigger and get execution ID',
264
- 'n8n_delete_execution - Clean up old executions',
265
- 'n8n_get_workflow - Get workflow structure',
266
- 'validate_workflow - Validate before executing'
267
- ]
268
- }
269
- };
270
- //# sourceMappingURL=n8n-get-execution.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"n8n-get-execution.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-get-execution.ts"],"names":[],"mappings":";;;AAEa,QAAA,kBAAkB,GAAsB;IACnD,IAAI,EAAE,mBAAmB;IACzB,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,yIAAyI;QACtJ,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,CAAC;QACxD,OAAO,EAAE;;;;;;;;;;CAUZ;QACG,WAAW,EAAE,6DAA6D;QAC1E,IAAI,EAAE;YACJ,kDAAkD;YAClD,oEAAoE;YACpE,iDAAiD;YACjD,+CAA+C;YAC/C,gDAAgD;YAChD,iDAAiD;SAClD;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE;;;;;;;;;;;;;iCAagB;QAE7B,UAAU,EAAE;YACV,EAAE,EAAE;gBACF,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,0FAA0F;aACxG;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE;;;;qDAIgC;aAC9C;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,OAAO;gBACb,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,6HAA6H;aAC3I;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE;;;;;uEAKkD;aAChE;YACD,gBAAgB,EAAE;gBAChB,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,4GAA4G;aAC1H;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,6GAA6G;aAC3H;SACF;QAED,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkDX;QAEE,QAAQ,EAAE;YACR;;;wCAGkC;YAElC;;;;;;;;;;EAUJ;YAEI;;+CAEyC;YAEzC;;;;;;;wCAOkC;YAElC;;;;;;6CAMuC;YAEvC;;;;;;;;2CAQqC;YAErC;;+EAEyE;SAC1E;QAED,QAAQ,EAAE;YACR,uCAAuC;YACvC,qEAAqE;YACrE,uDAAuD;YACvD,6CAA6C;YAC7C,sCAAsC;YACtC,oCAAoC;YACpC,gDAAgD;YAChD,8CAA8C;SAC/C;QAED,WAAW,EAAE;;;;;;;;;;;;;;;;kDAgBiC;QAE9C,aAAa,EAAE;YACb,oDAAoD;YACpD,qDAAqD;YACrD,gDAAgD;YAChD,4DAA4D;YAC5D,gDAAgD;YAChD,oDAAoD;YACpD,wDAAwD;YACxD,2DAA2D;YAC3D,wDAAwD;YACxD,uDAAuD;SACxD;QAED,QAAQ,EAAE;YACR,+DAA+D;YAC/D,wDAAwD;YACxD,oDAAoD;YACpD,iFAAiF;YACjF,mEAAmE;YACnE,uDAAuD;YACvD,8DAA8D;YAC9D,qDAAqD;YACrD,oEAAoE;YACpE,mDAAmD;SACpD;QAED,cAAc,EAAE;;;;;;;;;;;;;;;;;;;;;;;;+CAwB2B;QAE3C,YAAY,EAAE;YACZ,0CAA0C;YAC1C,6DAA6D;YAC7D,gDAAgD;YAChD,2CAA2C;YAC3C,+CAA+C;SAChD;KACF;CACF,CAAC"}
@@ -1,3 +0,0 @@
1
- import { ToolDocumentation } from '../types';
2
- export declare const n8nGetWorkflowDetailsDoc: ToolDocumentation;
3
- //# sourceMappingURL=n8n-get-workflow-details.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"n8n-get-workflow-details.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-get-workflow-details.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,wBAAwB,EAAE,iBA8CtC,CAAC"}
@@ -1,51 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.n8nGetWorkflowDetailsDoc = void 0;
4
- exports.n8nGetWorkflowDetailsDoc = {
5
- name: 'n8n_get_workflow_details',
6
- category: 'workflow_management',
7
- essentials: {
8
- description: 'Get workflow details with metadata, version, execution stats. More info than get_workflow.',
9
- keyParameters: ['id'],
10
- example: 'n8n_get_workflow_details({id: "workflow_123"})',
11
- performance: 'Fast (100-300ms)',
12
- tips: [
13
- 'Includes execution statistics',
14
- 'Shows version history info',
15
- 'Contains metadata like tags'
16
- ]
17
- },
18
- full: {
19
- description: 'Retrieves comprehensive workflow details including metadata, execution statistics, version information, and usage analytics. Provides more information than get_workflow, including data not typically needed for editing but useful for monitoring and analysis.',
20
- parameters: {
21
- id: { type: 'string', required: true, description: 'Workflow ID to retrieve details for' }
22
- },
23
- returns: 'Extended workflow object with: id, name, nodes, connections, settings, plus metadata (tags, owner, shared users), execution stats (success/error counts, average runtime), version info, created/updated timestamps',
24
- examples: [
25
- 'n8n_get_workflow_details({id: "abc123"}) - Get workflow with stats',
26
- 'const details = n8n_get_workflow_details({id: "xyz789"}); // Analyze performance'
27
- ],
28
- useCases: [
29
- 'Monitor workflow performance',
30
- 'Analyze execution patterns',
31
- 'View workflow metadata',
32
- 'Check version information',
33
- 'Audit workflow usage'
34
- ],
35
- performance: 'Slightly slower than get_workflow due to additional metadata - typically 100-300ms. Stats may be cached.',
36
- bestPractices: [
37
- 'Use for monitoring and analysis',
38
- 'Check execution stats before optimization',
39
- 'Review error counts for debugging',
40
- 'Monitor average execution times'
41
- ],
42
- pitfalls: [
43
- 'Requires N8N_API_URL and N8N_API_KEY configured',
44
- 'More data than needed for simple edits',
45
- 'Stats may have slight delay',
46
- 'Not all n8n versions support all fields'
47
- ],
48
- relatedTools: ['n8n_get_workflow', 'n8n_list_executions', 'n8n_get_execution', 'n8n_list_workflows']
49
- }
50
- };
51
- //# sourceMappingURL=n8n-get-workflow-details.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"n8n-get-workflow-details.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-get-workflow-details.ts"],"names":[],"mappings":";;;AAEa,QAAA,wBAAwB,GAAsB;IACzD,IAAI,EAAE,0BAA0B;IAChC,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,4FAA4F;QACzG,aAAa,EAAE,CAAC,IAAI,CAAC;QACrB,OAAO,EAAE,gDAAgD;QACzD,WAAW,EAAE,kBAAkB;QAC/B,IAAI,EAAE;YACJ,+BAA+B;YAC/B,4BAA4B;YAC5B,6BAA6B;SAC9B;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,mQAAmQ;QAChR,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,qCAAqC,EAAE;SAC3F;QACD,OAAO,EAAE,qNAAqN;QAC9N,QAAQ,EAAE;YACR,oEAAoE;YACpE,kFAAkF;SACnF;QACD,QAAQ,EAAE;YACR,8BAA8B;YAC9B,4BAA4B;YAC5B,wBAAwB;YACxB,2BAA2B;YAC3B,sBAAsB;SACvB;QACD,WAAW,EAAE,0GAA0G;QACvH,aAAa,EAAE;YACb,iCAAiC;YACjC,2CAA2C;YAC3C,mCAAmC;YACnC,iCAAiC;SAClC;QACD,QAAQ,EAAE;YACR,iDAAiD;YACjD,wCAAwC;YACxC,6BAA6B;YAC7B,yCAAyC;SAC1C;QACD,YAAY,EAAE,CAAC,kBAAkB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,oBAAoB,CAAC;KACrG;CACF,CAAC"}
@@ -1,3 +0,0 @@
1
- import { ToolDocumentation } from '../types';
2
- export declare const n8nGetWorkflowMinimalDoc: ToolDocumentation;
3
- //# sourceMappingURL=n8n-get-workflow-minimal.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"n8n-get-workflow-minimal.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-get-workflow-minimal.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,wBAAwB,EAAE,iBA8CtC,CAAC"}
@@ -1,51 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.n8nGetWorkflowMinimalDoc = void 0;
4
- exports.n8nGetWorkflowMinimalDoc = {
5
- name: 'n8n_get_workflow_minimal',
6
- category: 'workflow_management',
7
- essentials: {
8
- description: 'Get minimal info: ID, name, active status, tags. Fast for listings.',
9
- keyParameters: ['id'],
10
- example: 'n8n_get_workflow_minimal({id: "workflow_123"})',
11
- performance: 'Very fast (<50ms)',
12
- tips: [
13
- 'Fastest way to check workflow exists',
14
- 'Perfect for status checks',
15
- 'Use in list displays'
16
- ]
17
- },
18
- full: {
19
- description: 'Retrieves only essential workflow information without nodes or connections. Returns minimal data needed for listings, status checks, and quick lookups. Optimized for performance when full workflow data is not needed.',
20
- parameters: {
21
- id: { type: 'string', required: true, description: 'Workflow ID to retrieve minimal info for' }
22
- },
23
- returns: 'Minimal workflow object with: id, name, active status, tags array, createdAt, updatedAt. No nodes, connections, or settings included.',
24
- examples: [
25
- 'n8n_get_workflow_minimal({id: "abc123"}) - Quick existence check',
26
- 'const info = n8n_get_workflow_minimal({id: "xyz789"}); // Check if active'
27
- ],
28
- useCases: [
29
- 'Quick workflow existence checks',
30
- 'Display workflow lists',
31
- 'Check active/inactive status',
32
- 'Get workflow tags',
33
- 'Performance-critical operations'
34
- ],
35
- performance: 'Extremely fast - typically under 50ms. Returns only database metadata without loading workflow definition.',
36
- bestPractices: [
37
- 'Use for list displays and dashboards',
38
- 'Ideal for existence checks before operations',
39
- 'Cache results for UI responsiveness',
40
- 'Combine with list_workflows for bulk checks'
41
- ],
42
- pitfalls: [
43
- 'Requires N8N_API_URL and N8N_API_KEY configured',
44
- 'No workflow content - cannot edit or validate',
45
- 'Tags may be empty array',
46
- 'Must use get_workflow for actual workflow data'
47
- ],
48
- relatedTools: ['n8n_list_workflows', 'n8n_get_workflow', 'n8n_get_workflow_structure', 'n8n_update_partial_workflow']
49
- }
50
- };
51
- //# sourceMappingURL=n8n-get-workflow-minimal.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"n8n-get-workflow-minimal.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-get-workflow-minimal.ts"],"names":[],"mappings":";;;AAEa,QAAA,wBAAwB,GAAsB;IACzD,IAAI,EAAE,0BAA0B;IAChC,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,qEAAqE;QAClF,aAAa,EAAE,CAAC,IAAI,CAAC;QACrB,OAAO,EAAE,gDAAgD;QACzD,WAAW,EAAE,mBAAmB;QAChC,IAAI,EAAE;YACJ,sCAAsC;YACtC,2BAA2B;YAC3B,sBAAsB;SACvB;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,0NAA0N;QACvO,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,0CAA0C,EAAE;SAChG;QACD,OAAO,EAAE,uIAAuI;QAChJ,QAAQ,EAAE;YACR,kEAAkE;YAClE,2EAA2E;SAC5E;QACD,QAAQ,EAAE;YACR,iCAAiC;YACjC,wBAAwB;YACxB,8BAA8B;YAC9B,mBAAmB;YACnB,iCAAiC;SAClC;QACD,WAAW,EAAE,4GAA4G;QACzH,aAAa,EAAE;YACb,sCAAsC;YACtC,8CAA8C;YAC9C,qCAAqC;YACrC,6CAA6C;SAC9C;QACD,QAAQ,EAAE;YACR,iDAAiD;YACjD,+CAA+C;YAC/C,yBAAyB;YACzB,gDAAgD;SACjD;QACD,YAAY,EAAE,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,6BAA6B,CAAC;KACtH;CACF,CAAC"}
@@ -1,3 +0,0 @@
1
- import { ToolDocumentation } from '../types';
2
- export declare const n8nGetWorkflowStructureDoc: ToolDocumentation;
3
- //# sourceMappingURL=n8n-get-workflow-structure.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"n8n-get-workflow-structure.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-get-workflow-structure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,0BAA0B,EAAE,iBA8CxC,CAAC"}
@@ -1,51 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.n8nGetWorkflowStructureDoc = void 0;
4
- exports.n8nGetWorkflowStructureDoc = {
5
- name: 'n8n_get_workflow_structure',
6
- category: 'workflow_management',
7
- essentials: {
8
- description: 'Get workflow structure: nodes and connections only. No parameter details.',
9
- keyParameters: ['id'],
10
- example: 'n8n_get_workflow_structure({id: "workflow_123"})',
11
- performance: 'Fast (75-150ms)',
12
- tips: [
13
- 'Shows workflow topology',
14
- 'Node types without parameters',
15
- 'Perfect for visualization'
16
- ]
17
- },
18
- full: {
19
- description: 'Retrieves workflow structural information including node types, positions, and connections, but without detailed node parameters. Ideal for understanding workflow topology, creating visualizations, or analyzing workflow complexity without the overhead of full parameter data.',
20
- parameters: {
21
- id: { type: 'string', required: true, description: 'Workflow ID to retrieve structure for' }
22
- },
23
- returns: 'Workflow structure with: id, name, nodes array (id, name, type, position only), connections object. No node parameters, credentials, or settings included.',
24
- examples: [
25
- 'n8n_get_workflow_structure({id: "abc123"}) - Visualize workflow',
26
- 'const structure = n8n_get_workflow_structure({id: "xyz789"}); // Analyze complexity'
27
- ],
28
- useCases: [
29
- 'Generate workflow visualizations',
30
- 'Analyze workflow complexity',
31
- 'Understand node relationships',
32
- 'Create workflow diagrams',
33
- 'Quick topology validation'
34
- ],
35
- performance: 'Fast retrieval - typically 75-150ms. Faster than get_workflow as parameters are stripped.',
36
- bestPractices: [
37
- 'Use for visualization tools',
38
- 'Ideal for workflow analysis',
39
- 'Good for connection validation',
40
- 'Cache for UI diagram rendering'
41
- ],
42
- pitfalls: [
43
- 'Requires N8N_API_URL and N8N_API_KEY configured',
44
- 'No parameter data for configuration',
45
- 'Cannot validate node settings',
46
- 'Must use get_workflow for editing'
47
- ],
48
- relatedTools: ['n8n_get_workflow', 'n8n_validate_workflow_connections', 'n8n_get_workflow_minimal', 'validate_workflow_connections']
49
- }
50
- };
51
- //# sourceMappingURL=n8n-get-workflow-structure.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"n8n-get-workflow-structure.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-get-workflow-structure.ts"],"names":[],"mappings":";;;AAEa,QAAA,0BAA0B,GAAsB;IAC3D,IAAI,EAAE,4BAA4B;IAClC,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,2EAA2E;QACxF,aAAa,EAAE,CAAC,IAAI,CAAC;QACrB,OAAO,EAAE,kDAAkD;QAC3D,WAAW,EAAE,iBAAiB;QAC9B,IAAI,EAAE;YACJ,yBAAyB;YACzB,+BAA+B;YAC/B,2BAA2B;SAC5B;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,qRAAqR;QAClS,UAAU,EAAE;YACV,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uCAAuC,EAAE;SAC7F;QACD,OAAO,EAAE,4JAA4J;QACrK,QAAQ,EAAE;YACR,iEAAiE;YACjE,qFAAqF;SACtF;QACD,QAAQ,EAAE;YACR,kCAAkC;YAClC,6BAA6B;YAC7B,+BAA+B;YAC/B,0BAA0B;YAC1B,2BAA2B;SAC5B;QACD,WAAW,EAAE,2FAA2F;QACxG,aAAa,EAAE;YACb,6BAA6B;YAC7B,6BAA6B;YAC7B,gCAAgC;YAChC,gCAAgC;SACjC;QACD,QAAQ,EAAE;YACR,iDAAiD;YACjD,qCAAqC;YACrC,+BAA+B;YAC/B,mCAAmC;SACpC;QACD,YAAY,EAAE,CAAC,kBAAkB,EAAE,mCAAmC,EAAE,0BAA0B,EAAE,+BAA+B,CAAC;KACrI;CACF,CAAC"}
@@ -1,3 +0,0 @@
1
- import { ToolDocumentation } from '../types';
2
- export declare const n8nListExecutionsDoc: ToolDocumentation;
3
- //# sourceMappingURL=n8n-list-executions.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"n8n-list-executions.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-list-executions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,oBAAoB,EAAE,iBAiFlC,CAAC"}
@@ -1,86 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.n8nListExecutionsDoc = void 0;
4
- exports.n8nListExecutionsDoc = {
5
- name: 'n8n_list_executions',
6
- category: 'workflow_management',
7
- essentials: {
8
- description: 'List workflow executions with optional filters. Supports pagination for large result sets.',
9
- keyParameters: ['workflowId', 'status', 'limit'],
10
- example: 'n8n_list_executions({workflowId: "abc123", status: "error"})',
11
- performance: 'Fast metadata retrieval, use pagination for large datasets',
12
- tips: [
13
- 'Filter by status (success/error/waiting) to find specific execution types',
14
- 'Use workflowId to see all executions for a specific workflow',
15
- 'Pagination via cursor allows retrieving large execution histories'
16
- ]
17
- },
18
- full: {
19
- description: `Lists workflow executions with powerful filtering options. This tool is essential for monitoring workflow performance, finding failed executions, and tracking workflow activity. Supports pagination for retrieving large execution histories and filtering by workflow, status, and project.`,
20
- parameters: {
21
- limit: {
22
- type: 'number',
23
- required: false,
24
- description: 'Number of executions to return (1-100, default: 100). Use with cursor for pagination'
25
- },
26
- cursor: {
27
- type: 'string',
28
- required: false,
29
- description: 'Pagination cursor from previous response. Used to retrieve next page of results'
30
- },
31
- workflowId: {
32
- type: 'string',
33
- required: false,
34
- description: 'Filter executions by specific workflow ID. Shows all executions for that workflow'
35
- },
36
- projectId: {
37
- type: 'string',
38
- required: false,
39
- description: 'Filter by project ID (enterprise feature). Groups executions by project'
40
- },
41
- status: {
42
- type: 'string',
43
- required: false,
44
- enum: ['success', 'error', 'waiting'],
45
- description: 'Filter by execution status. Success = completed, Error = failed, Waiting = running'
46
- },
47
- includeData: {
48
- type: 'boolean',
49
- required: false,
50
- description: 'Include execution data in results (default: false). Significantly increases response size'
51
- }
52
- },
53
- returns: `Array of execution objects with metadata, pagination cursor for next page, and optionally execution data. Each execution includes ID, status, start/end times, and workflow reference.`,
54
- examples: [
55
- 'n8n_list_executions({limit: 10}) - Get 10 most recent executions',
56
- 'n8n_list_executions({workflowId: "abc123"}) - All executions for specific workflow',
57
- 'n8n_list_executions({status: "error", limit: 50}) - Find failed executions',
58
- 'n8n_list_executions({status: "waiting"}) - Monitor currently running workflows',
59
- 'n8n_list_executions({cursor: "next-page-token"}) - Get next page of results'
60
- ],
61
- useCases: [
62
- 'Monitor workflow execution history and patterns',
63
- 'Find and debug failed workflow executions',
64
- 'Track currently running workflows (waiting status)',
65
- 'Analyze workflow performance and execution frequency',
66
- 'Generate execution reports for specific workflows'
67
- ],
68
- performance: `Listing executions is fast for metadata only. Including data (includeData: true) significantly impacts performance. Use pagination (limit + cursor) for large result sets. Default limit of 100 balances performance with usability.`,
69
- bestPractices: [
70
- 'Use status filters to focus on specific execution types',
71
- 'Implement pagination for large execution histories',
72
- 'Avoid includeData unless you need execution details',
73
- 'Filter by workflowId when monitoring specific workflows',
74
- 'Check for cursor in response to detect more pages'
75
- ],
76
- pitfalls: [
77
- 'Large limits with includeData can cause timeouts',
78
- 'Execution retention depends on n8n configuration',
79
- 'Cursor tokens expire - use them promptly',
80
- 'Status "waiting" includes both running and queued executions',
81
- 'Deleted workflows still show in execution history'
82
- ],
83
- relatedTools: ['n8n_get_execution', 'n8n_trigger_webhook_workflow', 'n8n_delete_execution', 'n8n_list_workflows']
84
- }
85
- };
86
- //# sourceMappingURL=n8n-list-executions.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"n8n-list-executions.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-list-executions.ts"],"names":[],"mappings":";;;AAEa,QAAA,oBAAoB,GAAsB;IACrD,IAAI,EAAE,qBAAqB;IAC3B,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,4FAA4F;QACzG,aAAa,EAAE,CAAC,YAAY,EAAE,QAAQ,EAAE,OAAO,CAAC;QAChD,OAAO,EAAE,8DAA8D;QACvE,WAAW,EAAE,4DAA4D;QACzE,IAAI,EAAE;YACJ,2EAA2E;YAC3E,8DAA8D;YAC9D,mEAAmE;SACpE;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,gSAAgS;QAC7S,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,sFAAsF;aACpG;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,iFAAiF;aAC/F;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,mFAAmF;aACjG;YACD,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,yEAAyE;aACvF;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,IAAI,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC;gBACrC,WAAW,EAAE,oFAAoF;aAClG;YACD,WAAW,EAAE;gBACX,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,2FAA2F;aACzG;SACF;QACD,OAAO,EAAE,wLAAwL;QACjM,QAAQ,EAAE;YACR,kEAAkE;YAClE,oFAAoF;YACpF,4EAA4E;YAC5E,gFAAgF;YAChF,6EAA6E;SAC9E;QACD,QAAQ,EAAE;YACR,iDAAiD;YACjD,2CAA2C;YAC3C,oDAAoD;YACpD,sDAAsD;YACtD,mDAAmD;SACpD;QACD,WAAW,EAAE,sOAAsO;QACnP,aAAa,EAAE;YACb,yDAAyD;YACzD,oDAAoD;YACpD,qDAAqD;YACrD,yDAAyD;YACzD,mDAAmD;SACpD;QACD,QAAQ,EAAE;YACR,kDAAkD;YAClD,kDAAkD;YAClD,0CAA0C;YAC1C,8DAA8D;YAC9D,mDAAmD;SACpD;QACD,YAAY,EAAE,CAAC,mBAAmB,EAAE,8BAA8B,EAAE,sBAAsB,EAAE,oBAAoB,CAAC;KAClH;CACF,CAAC"}