n8n-mcp 2.7.14 → 2.7.17

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 (233) hide show
  1. package/.env.example +10 -0
  2. package/README.md +49 -3
  3. package/data/nodes.db +0 -0
  4. package/dist/http-server-single-session.d.ts.map +1 -1
  5. package/dist/http-server-single-session.js +87 -3
  6. package/dist/http-server-single-session.js.map +1 -1
  7. package/dist/http-server.d.ts.map +1 -1
  8. package/dist/http-server.js +85 -2
  9. package/dist/http-server.js.map +1 -1
  10. package/dist/mcp/server.d.ts.map +1 -1
  11. package/dist/mcp/server.js +0 -3
  12. package/dist/mcp/server.js.map +1 -1
  13. package/dist/mcp/tool-docs/configuration/get-node-as-tool-info.d.ts +3 -0
  14. package/dist/mcp/tool-docs/configuration/get-node-as-tool-info.d.ts.map +1 -0
  15. package/dist/mcp/tool-docs/configuration/get-node-as-tool-info.js +73 -0
  16. package/dist/mcp/tool-docs/configuration/get-node-as-tool-info.js.map +1 -0
  17. package/dist/mcp/tool-docs/configuration/get-node-documentation.d.ts +3 -0
  18. package/dist/mcp/tool-docs/configuration/get-node-documentation.d.ts.map +1 -0
  19. package/dist/mcp/tool-docs/configuration/get-node-documentation.js +47 -0
  20. package/dist/mcp/tool-docs/configuration/get-node-documentation.js.map +1 -0
  21. package/dist/mcp/tool-docs/configuration/get-node-essentials.d.ts +3 -0
  22. package/dist/mcp/tool-docs/configuration/get-node-essentials.d.ts.map +1 -0
  23. package/dist/mcp/tool-docs/configuration/get-node-essentials.js +88 -0
  24. package/dist/mcp/tool-docs/configuration/get-node-essentials.js.map +1 -0
  25. package/dist/mcp/tool-docs/configuration/get-node-info.d.ts +3 -0
  26. package/dist/mcp/tool-docs/configuration/get-node-info.d.ts.map +1 -0
  27. package/dist/mcp/tool-docs/configuration/get-node-info.js +100 -0
  28. package/dist/mcp/tool-docs/configuration/get-node-info.js.map +1 -0
  29. package/dist/mcp/tool-docs/configuration/get-property-dependencies.d.ts +3 -0
  30. package/dist/mcp/tool-docs/configuration/get-property-dependencies.d.ts.map +1 -0
  31. package/dist/mcp/tool-docs/configuration/get-property-dependencies.js +81 -0
  32. package/dist/mcp/tool-docs/configuration/get-property-dependencies.js.map +1 -0
  33. package/dist/mcp/tool-docs/configuration/index.d.ts +7 -0
  34. package/dist/mcp/tool-docs/configuration/index.d.ts.map +1 -0
  35. package/dist/mcp/tool-docs/configuration/index.js +16 -0
  36. package/dist/mcp/tool-docs/configuration/index.js.map +1 -0
  37. package/dist/mcp/tool-docs/configuration/search-node-properties.d.ts +3 -0
  38. package/dist/mcp/tool-docs/configuration/search-node-properties.d.ts.map +1 -0
  39. package/dist/mcp/tool-docs/configuration/search-node-properties.js +99 -0
  40. package/dist/mcp/tool-docs/configuration/search-node-properties.js.map +1 -0
  41. package/dist/mcp/tool-docs/discovery/get-database-statistics.d.ts +3 -0
  42. package/dist/mcp/tool-docs/discovery/get-database-statistics.d.ts.map +1 -0
  43. package/dist/mcp/tool-docs/discovery/get-database-statistics.js +69 -0
  44. package/dist/mcp/tool-docs/discovery/get-database-statistics.js.map +1 -0
  45. package/dist/mcp/tool-docs/discovery/index.d.ts +5 -0
  46. package/dist/mcp/tool-docs/discovery/index.d.ts.map +1 -0
  47. package/dist/mcp/tool-docs/discovery/index.js +12 -0
  48. package/dist/mcp/tool-docs/discovery/index.js.map +1 -0
  49. package/dist/mcp/tool-docs/discovery/list-ai-tools.d.ts +3 -0
  50. package/dist/mcp/tool-docs/discovery/list-ai-tools.d.ts.map +1 -0
  51. package/dist/mcp/tool-docs/discovery/list-ai-tools.js +49 -0
  52. package/dist/mcp/tool-docs/discovery/list-ai-tools.js.map +1 -0
  53. package/dist/mcp/tool-docs/discovery/list-nodes.d.ts +3 -0
  54. package/dist/mcp/tool-docs/discovery/list-nodes.d.ts.map +1 -0
  55. package/dist/mcp/tool-docs/discovery/list-nodes.js +54 -0
  56. package/dist/mcp/tool-docs/discovery/list-nodes.js.map +1 -0
  57. package/dist/mcp/tool-docs/discovery/search-nodes.d.ts +3 -0
  58. package/dist/mcp/tool-docs/discovery/search-nodes.d.ts.map +1 -0
  59. package/dist/mcp/tool-docs/discovery/search-nodes.js +56 -0
  60. package/dist/mcp/tool-docs/discovery/search-nodes.js.map +1 -0
  61. package/dist/mcp/tool-docs/index.d.ts +4 -0
  62. package/dist/mcp/tool-docs/index.d.ts.map +1 -0
  63. package/dist/mcp/tool-docs/index.js +51 -0
  64. package/dist/mcp/tool-docs/index.js.map +1 -0
  65. package/dist/mcp/tool-docs/special/code-node-guide.d.ts +3 -0
  66. package/dist/mcp/tool-docs/special/code-node-guide.d.ts.map +1 -0
  67. package/dist/mcp/tool-docs/special/code-node-guide.js +61 -0
  68. package/dist/mcp/tool-docs/special/code-node-guide.js.map +1 -0
  69. package/dist/mcp/tool-docs/special/index.d.ts +2 -0
  70. package/dist/mcp/tool-docs/special/index.d.ts.map +1 -0
  71. package/dist/mcp/tool-docs/special/index.js +6 -0
  72. package/dist/mcp/tool-docs/special/index.js.map +1 -0
  73. package/dist/mcp/tool-docs/system/index.d.ts +5 -0
  74. package/dist/mcp/tool-docs/system/index.d.ts.map +1 -0
  75. package/dist/mcp/tool-docs/system/index.js +12 -0
  76. package/dist/mcp/tool-docs/system/index.js.map +1 -0
  77. package/dist/mcp/tool-docs/system/n8n-diagnostic.d.ts +3 -0
  78. package/dist/mcp/tool-docs/system/n8n-diagnostic.d.ts.map +1 -0
  79. package/dist/mcp/tool-docs/system/n8n-diagnostic.js +81 -0
  80. package/dist/mcp/tool-docs/system/n8n-diagnostic.js.map +1 -0
  81. package/dist/mcp/tool-docs/system/n8n-health-check.d.ts +3 -0
  82. package/dist/mcp/tool-docs/system/n8n-health-check.d.ts.map +1 -0
  83. package/dist/mcp/tool-docs/system/n8n-health-check.js +77 -0
  84. package/dist/mcp/tool-docs/system/n8n-health-check.js.map +1 -0
  85. package/dist/mcp/tool-docs/system/n8n-list-available-tools.d.ts +3 -0
  86. package/dist/mcp/tool-docs/system/n8n-list-available-tools.d.ts.map +1 -0
  87. package/dist/mcp/tool-docs/system/n8n-list-available-tools.js +75 -0
  88. package/dist/mcp/tool-docs/system/n8n-list-available-tools.js.map +1 -0
  89. package/dist/mcp/tool-docs/system/tools-documentation.d.ts +3 -0
  90. package/dist/mcp/tool-docs/system/tools-documentation.d.ts.map +1 -0
  91. package/dist/mcp/tool-docs/system/tools-documentation.js +65 -0
  92. package/dist/mcp/tool-docs/system/tools-documentation.js.map +1 -0
  93. package/dist/mcp/tool-docs/templates/get-node-for-task.d.ts +3 -0
  94. package/dist/mcp/tool-docs/templates/get-node-for-task.d.ts.map +1 -0
  95. package/dist/mcp/tool-docs/templates/get-node-for-task.js +50 -0
  96. package/dist/mcp/tool-docs/templates/get-node-for-task.js.map +1 -0
  97. package/dist/mcp/tool-docs/templates/get-template.d.ts +3 -0
  98. package/dist/mcp/tool-docs/templates/get-template.d.ts.map +1 -0
  99. package/dist/mcp/tool-docs/templates/get-template.js +76 -0
  100. package/dist/mcp/tool-docs/templates/get-template.js.map +1 -0
  101. package/dist/mcp/tool-docs/templates/get-templates-for-task.d.ts +3 -0
  102. package/dist/mcp/tool-docs/templates/get-templates-for-task.d.ts.map +1 -0
  103. package/dist/mcp/tool-docs/templates/get-templates-for-task.js +76 -0
  104. package/dist/mcp/tool-docs/templates/get-templates-for-task.js.map +1 -0
  105. package/dist/mcp/tool-docs/templates/index.d.ts +7 -0
  106. package/dist/mcp/tool-docs/templates/index.d.ts.map +1 -0
  107. package/dist/mcp/tool-docs/templates/index.js +16 -0
  108. package/dist/mcp/tool-docs/templates/index.js.map +1 -0
  109. package/dist/mcp/tool-docs/templates/list-node-templates.d.ts +3 -0
  110. package/dist/mcp/tool-docs/templates/list-node-templates.d.ts.map +1 -0
  111. package/dist/mcp/tool-docs/templates/list-node-templates.js +80 -0
  112. package/dist/mcp/tool-docs/templates/list-node-templates.js.map +1 -0
  113. package/dist/mcp/tool-docs/templates/list-tasks.d.ts +3 -0
  114. package/dist/mcp/tool-docs/templates/list-tasks.d.ts.map +1 -0
  115. package/dist/mcp/tool-docs/templates/list-tasks.js +48 -0
  116. package/dist/mcp/tool-docs/templates/list-tasks.js.map +1 -0
  117. package/dist/mcp/tool-docs/templates/search-templates.d.ts +3 -0
  118. package/dist/mcp/tool-docs/templates/search-templates.d.ts.map +1 -0
  119. package/dist/mcp/tool-docs/templates/search-templates.js +83 -0
  120. package/dist/mcp/tool-docs/templates/search-templates.js.map +1 -0
  121. package/dist/mcp/tool-docs/types.d.ts +30 -0
  122. package/dist/mcp/tool-docs/types.d.ts.map +1 -0
  123. package/dist/mcp/tool-docs/types.js +3 -0
  124. package/dist/mcp/tool-docs/types.js.map +1 -0
  125. package/dist/mcp/tool-docs/validation/index.d.ts +6 -0
  126. package/dist/mcp/tool-docs/validation/index.d.ts.map +1 -0
  127. package/dist/mcp/tool-docs/validation/index.js +14 -0
  128. package/dist/mcp/tool-docs/validation/index.js.map +1 -0
  129. package/dist/mcp/tool-docs/validation/validate-node-minimal.d.ts +3 -0
  130. package/dist/mcp/tool-docs/validation/validate-node-minimal.d.ts.map +1 -0
  131. package/dist/mcp/tool-docs/validation/validate-node-minimal.js +49 -0
  132. package/dist/mcp/tool-docs/validation/validate-node-minimal.js.map +1 -0
  133. package/dist/mcp/tool-docs/validation/validate-node-operation.d.ts +3 -0
  134. package/dist/mcp/tool-docs/validation/validate-node-operation.d.ts.map +1 -0
  135. package/dist/mcp/tool-docs/validation/validate-node-operation.js +94 -0
  136. package/dist/mcp/tool-docs/validation/validate-node-operation.js.map +1 -0
  137. package/dist/mcp/tool-docs/validation/validate-workflow-connections.d.ts +3 -0
  138. package/dist/mcp/tool-docs/validation/validate-workflow-connections.d.ts.map +1 -0
  139. package/dist/mcp/tool-docs/validation/validate-workflow-connections.js +58 -0
  140. package/dist/mcp/tool-docs/validation/validate-workflow-connections.js.map +1 -0
  141. package/dist/mcp/tool-docs/validation/validate-workflow-expressions.d.ts +3 -0
  142. package/dist/mcp/tool-docs/validation/validate-workflow-expressions.d.ts.map +1 -0
  143. package/dist/mcp/tool-docs/validation/validate-workflow-expressions.js +58 -0
  144. package/dist/mcp/tool-docs/validation/validate-workflow-expressions.js.map +1 -0
  145. package/dist/mcp/tool-docs/validation/validate-workflow.d.ts +3 -0
  146. package/dist/mcp/tool-docs/validation/validate-workflow.d.ts.map +1 -0
  147. package/dist/mcp/tool-docs/validation/validate-workflow.js +83 -0
  148. package/dist/mcp/tool-docs/validation/validate-workflow.js.map +1 -0
  149. package/dist/mcp/tool-docs/workflow_management/index.d.ts +15 -0
  150. package/dist/mcp/tool-docs/workflow_management/index.d.ts.map +1 -0
  151. package/dist/mcp/tool-docs/workflow_management/index.js +32 -0
  152. package/dist/mcp/tool-docs/workflow_management/index.js.map +1 -0
  153. package/dist/mcp/tool-docs/workflow_management/n8n-create-workflow.d.ts +3 -0
  154. package/dist/mcp/tool-docs/workflow_management/n8n-create-workflow.d.ts.map +1 -0
  155. package/dist/mcp/tool-docs/workflow_management/n8n-create-workflow.js +99 -0
  156. package/dist/mcp/tool-docs/workflow_management/n8n-create-workflow.js.map +1 -0
  157. package/dist/mcp/tool-docs/workflow_management/n8n-delete-execution.d.ts +3 -0
  158. package/dist/mcp/tool-docs/workflow_management/n8n-delete-execution.d.ts.map +1 -0
  159. package/dist/mcp/tool-docs/workflow_management/n8n-delete-execution.js +59 -0
  160. package/dist/mcp/tool-docs/workflow_management/n8n-delete-execution.js.map +1 -0
  161. package/dist/mcp/tool-docs/workflow_management/n8n-delete-workflow.d.ts +3 -0
  162. package/dist/mcp/tool-docs/workflow_management/n8n-delete-workflow.d.ts.map +1 -0
  163. package/dist/mcp/tool-docs/workflow_management/n8n-delete-workflow.js +52 -0
  164. package/dist/mcp/tool-docs/workflow_management/n8n-delete-workflow.js.map +1 -0
  165. package/dist/mcp/tool-docs/workflow_management/n8n-get-execution.d.ts +3 -0
  166. package/dist/mcp/tool-docs/workflow_management/n8n-get-execution.d.ts.map +1 -0
  167. package/dist/mcp/tool-docs/workflow_management/n8n-get-execution.js +64 -0
  168. package/dist/mcp/tool-docs/workflow_management/n8n-get-execution.js.map +1 -0
  169. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-details.d.ts +3 -0
  170. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-details.d.ts.map +1 -0
  171. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-details.js +51 -0
  172. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-details.js.map +1 -0
  173. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-minimal.d.ts +3 -0
  174. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-minimal.d.ts.map +1 -0
  175. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-minimal.js +51 -0
  176. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-minimal.js.map +1 -0
  177. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-structure.d.ts +3 -0
  178. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-structure.d.ts.map +1 -0
  179. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-structure.js +51 -0
  180. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-structure.js.map +1 -0
  181. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow.d.ts +3 -0
  182. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow.d.ts.map +1 -0
  183. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow.js +51 -0
  184. package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow.js.map +1 -0
  185. package/dist/mcp/tool-docs/workflow_management/n8n-list-executions.d.ts +3 -0
  186. package/dist/mcp/tool-docs/workflow_management/n8n-list-executions.d.ts.map +1 -0
  187. package/dist/mcp/tool-docs/workflow_management/n8n-list-executions.js +86 -0
  188. package/dist/mcp/tool-docs/workflow_management/n8n-list-executions.js.map +1 -0
  189. package/dist/mcp/tool-docs/workflow_management/n8n-list-workflows.d.ts +3 -0
  190. package/dist/mcp/tool-docs/workflow_management/n8n-list-workflows.d.ts.map +1 -0
  191. package/dist/mcp/tool-docs/workflow_management/n8n-list-workflows.js +57 -0
  192. package/dist/mcp/tool-docs/workflow_management/n8n-list-workflows.js.map +1 -0
  193. package/dist/mcp/tool-docs/workflow_management/n8n-trigger-webhook-workflow.d.ts +3 -0
  194. package/dist/mcp/tool-docs/workflow_management/n8n-trigger-webhook-workflow.d.ts.map +1 -0
  195. package/dist/mcp/tool-docs/workflow_management/n8n-trigger-webhook-workflow.js +80 -0
  196. package/dist/mcp/tool-docs/workflow_management/n8n-trigger-webhook-workflow.js.map +1 -0
  197. package/dist/mcp/tool-docs/workflow_management/n8n-update-full-workflow.d.ts +3 -0
  198. package/dist/mcp/tool-docs/workflow_management/n8n-update-full-workflow.d.ts.map +1 -0
  199. package/dist/mcp/tool-docs/workflow_management/n8n-update-full-workflow.js +57 -0
  200. package/dist/mcp/tool-docs/workflow_management/n8n-update-full-workflow.js.map +1 -0
  201. package/dist/mcp/tool-docs/workflow_management/n8n-update-partial-workflow.d.ts +3 -0
  202. package/dist/mcp/tool-docs/workflow_management/n8n-update-partial-workflow.d.ts.map +1 -0
  203. package/dist/mcp/tool-docs/workflow_management/n8n-update-partial-workflow.js +82 -0
  204. package/dist/mcp/tool-docs/workflow_management/n8n-update-partial-workflow.js.map +1 -0
  205. package/dist/mcp/tool-docs/workflow_management/n8n-validate-workflow.d.ts +3 -0
  206. package/dist/mcp/tool-docs/workflow_management/n8n-validate-workflow.d.ts.map +1 -0
  207. package/dist/mcp/tool-docs/workflow_management/n8n-validate-workflow.js +73 -0
  208. package/dist/mcp/tool-docs/workflow_management/n8n-validate-workflow.js.map +1 -0
  209. package/dist/mcp/tools-documentation-new.d.ts +6 -0
  210. package/dist/mcp/tools-documentation-new.d.ts.map +1 -0
  211. package/dist/mcp/tools-documentation-new.js +163 -0
  212. package/dist/mcp/tools-documentation-new.js.map +1 -0
  213. package/dist/mcp/tools-documentation.d.ts +1 -29
  214. package/dist/mcp/tools-documentation.d.ts.map +1 -1
  215. package/dist/mcp/tools-documentation.js +506 -1235
  216. package/dist/mcp/tools-documentation.js.map +1 -1
  217. package/dist/scripts/rebuild.js +2 -1
  218. package/dist/scripts/rebuild.js.map +1 -1
  219. package/dist/scripts/test-tools-documentation.d.ts +2 -0
  220. package/dist/scripts/test-tools-documentation.d.ts.map +1 -0
  221. package/dist/scripts/test-tools-documentation.js +41 -0
  222. package/dist/scripts/test-tools-documentation.js.map +1 -0
  223. package/dist/services/enhanced-config-validator.d.ts +0 -1
  224. package/dist/services/enhanced-config-validator.d.ts.map +1 -1
  225. package/dist/services/enhanced-config-validator.js +2 -91
  226. package/dist/services/enhanced-config-validator.js.map +1 -1
  227. package/dist/services/n8n-validation.d.ts.map +1 -1
  228. package/dist/services/n8n-validation.js.map +1 -1
  229. package/dist/utils/url-detector.d.ts +9 -0
  230. package/dist/utils/url-detector.d.ts.map +1 -0
  231. package/dist/utils/url-detector.js +79 -0
  232. package/dist/utils/url-detector.js.map +1 -0
  233. package/package.json +1 -1
@@ -0,0 +1,94 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.validateNodeOperationDoc = void 0;
4
+ exports.validateNodeOperationDoc = {
5
+ name: 'validate_node_operation',
6
+ category: 'validation',
7
+ essentials: {
8
+ description: 'Validates node configuration with operation awareness. Checks required fields, data types, and operation-specific rules. Returns specific errors with automated fix suggestions. Different profiles for different validation needs.',
9
+ keyParameters: ['nodeType', 'config', 'profile'],
10
+ example: 'validate_node_operation({nodeType: "nodes-base.slack", config: {resource: "message", operation: "post", text: "Hi"}})',
11
+ performance: '<100ms',
12
+ tips: [
13
+ 'Profile choices: minimal (editing), runtime (execution), ai-friendly (balanced), strict (deployment)',
14
+ 'Returns fixes you can apply directly',
15
+ 'Operation-aware - knows Slack post needs text'
16
+ ]
17
+ },
18
+ full: {
19
+ description: 'Comprehensive node configuration validation that understands operation context. For example, it knows Slack message posting requires text field, while channel listing doesn\'t. Provides different validation profiles for different stages of workflow development.',
20
+ parameters: {
21
+ nodeType: { type: 'string', required: true, description: 'Full node type with prefix: "nodes-base.slack", "nodes-base.httpRequest"' },
22
+ config: { type: 'object', required: true, description: 'Node configuration. Must include operation fields (resource/operation/action) if the node has multiple operations' },
23
+ profile: { type: 'string', required: false, description: 'Validation profile - controls what\'s checked. Default: "ai-friendly"' }
24
+ },
25
+ returns: `Object containing:
26
+ {
27
+ "isValid": false,
28
+ "errors": [
29
+ {
30
+ "field": "channel",
31
+ "message": "Required field 'channel' is missing",
32
+ "severity": "error",
33
+ "fix": "#general"
34
+ }
35
+ ],
36
+ "warnings": [
37
+ {
38
+ "field": "retryOnFail",
39
+ "message": "Consider enabling retry for reliability",
40
+ "severity": "warning",
41
+ "fix": true
42
+ }
43
+ ],
44
+ "suggestions": [
45
+ {
46
+ "field": "timeout",
47
+ "message": "Set timeout to prevent hanging",
48
+ "fix": 30000
49
+ }
50
+ ],
51
+ "fixes": {
52
+ "channel": "#general",
53
+ "retryOnFail": true,
54
+ "timeout": 30000
55
+ }
56
+ }`,
57
+ examples: [
58
+ '// Missing required field',
59
+ 'validate_node_operation({nodeType: "nodes-base.slack", config: {resource: "message", operation: "post"}})',
60
+ '// Returns: {isValid: false, errors: [{field: "text", message: "Required field missing"}], fixes: {text: "Message text"}}',
61
+ '',
62
+ '// Validate with strict profile for production',
63
+ 'validate_node_operation({nodeType: "nodes-base.httpRequest", config: {method: "POST", url: "https://api.example.com"}, profile: "strict"})',
64
+ '',
65
+ '// Apply fixes automatically',
66
+ 'const result = validate_node_operation({nodeType: "nodes-base.slack", config: myConfig});',
67
+ 'if (!result.isValid) {',
68
+ ' myConfig = {...myConfig, ...result.fixes};',
69
+ '}'
70
+ ],
71
+ useCases: [
72
+ 'Validate configuration before workflow execution',
73
+ 'Debug why a node isn\'t working as expected',
74
+ 'Generate configuration fixes automatically',
75
+ 'Different validation for editing vs production'
76
+ ],
77
+ performance: '<100ms for most nodes, <200ms for complex nodes with many conditions',
78
+ bestPractices: [
79
+ 'Use "minimal" profile during user editing for fast feedback',
80
+ 'Use "runtime" profile (default) before execution',
81
+ 'Use "ai-friendly" when AI configures nodes',
82
+ 'Use "strict" profile before production deployment',
83
+ 'Always include operation fields (resource/operation) in config',
84
+ 'Apply suggested fixes to resolve issues quickly'
85
+ ],
86
+ pitfalls: [
87
+ 'Must include operation fields for multi-operation nodes',
88
+ 'Fixes are suggestions - review before applying',
89
+ 'Profile affects what\'s validated - minimal skips many checks'
90
+ ],
91
+ relatedTools: ['validate_node_minimal for quick checks', 'get_node_essentials for valid examples', 'validate_workflow for complete workflow validation']
92
+ }
93
+ };
94
+ //# sourceMappingURL=validate-node-operation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validate-node-operation.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/validation/validate-node-operation.ts"],"names":[],"mappings":";;;AAEa,QAAA,wBAAwB,GAAsB;IACzD,IAAI,EAAE,yBAAyB;IAC/B,QAAQ,EAAE,YAAY;IACtB,UAAU,EAAE;QACV,WAAW,EAAE,qOAAqO;QAClP,aAAa,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC;QAChD,OAAO,EAAE,uHAAuH;QAChI,WAAW,EAAE,QAAQ;QACrB,IAAI,EAAE;YACJ,sGAAsG;YACtG,sCAAsC;YACtC,+CAA+C;SAChD;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,uQAAuQ;QACpR,UAAU,EAAE;YACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,0EAA0E,EAAE;YACrI,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,mHAAmH,EAAE;YAC5K,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,uEAAuE,EAAE;SACnI;QACD,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+BX;QACE,QAAQ,EAAE;YACR,2BAA2B;YAC3B,2GAA2G;YAC3G,2HAA2H;YAC3H,EAAE;YACF,gDAAgD;YAChD,4IAA4I;YAC5I,EAAE;YACF,8BAA8B;YAC9B,2FAA2F;YAC3F,wBAAwB;YACxB,8CAA8C;YAC9C,GAAG;SACJ;QACD,QAAQ,EAAE;YACR,kDAAkD;YAClD,6CAA6C;YAC7C,4CAA4C;YAC5C,gDAAgD;SACjD;QACD,WAAW,EAAE,sEAAsE;QACnF,aAAa,EAAE;YACb,6DAA6D;YAC7D,kDAAkD;YAClD,4CAA4C;YAC5C,mDAAmD;YACnD,gEAAgE;YAChE,iDAAiD;SAClD;QACD,QAAQ,EAAE;YACR,yDAAyD;YACzD,gDAAgD;YAChD,+DAA+D;SAChE;QACD,YAAY,EAAE,CAAC,wCAAwC,EAAE,wCAAwC,EAAE,oDAAoD,CAAC;KACzJ;CACF,CAAC"}
@@ -0,0 +1,3 @@
1
+ import { ToolDocumentation } from '../types';
2
+ export declare const validateWorkflowConnectionsDoc: ToolDocumentation;
3
+ //# sourceMappingURL=validate-workflow-connections.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validate-workflow-connections.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/validation/validate-workflow-connections.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,8BAA8B,EAAE,iBAqD5C,CAAC"}
@@ -0,0 +1,58 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.validateWorkflowConnectionsDoc = void 0;
4
+ exports.validateWorkflowConnectionsDoc = {
5
+ name: 'validate_workflow_connections',
6
+ category: 'validation',
7
+ essentials: {
8
+ description: 'Check workflow connections only: valid nodes, no cycles, proper triggers, AI tool links. Fast structure validation.',
9
+ keyParameters: ['workflow'],
10
+ example: 'validate_workflow_connections({workflow: {nodes: [...], connections: {...}}})',
11
+ performance: 'Fast (<100ms)',
12
+ tips: [
13
+ 'Use for quick structure checks when editing connections',
14
+ 'Detects orphaned nodes and circular dependencies',
15
+ 'Validates AI Agent tool connections to ensure proper node references'
16
+ ]
17
+ },
18
+ full: {
19
+ description: 'Validates only the connection structure of a workflow without checking node configurations or expressions. This focused validation checks that all referenced nodes exist, detects circular dependencies, ensures proper trigger node placement, validates AI tool connections, and identifies orphaned or unreachable nodes.',
20
+ parameters: {
21
+ workflow: {
22
+ type: 'object',
23
+ required: true,
24
+ description: 'The workflow JSON with nodes array and connections object.'
25
+ }
26
+ },
27
+ returns: 'Object with valid (boolean), errors (array), warnings (array), and statistics about connections',
28
+ examples: [
29
+ 'validate_workflow_connections({workflow: myWorkflow}) - Check all connections',
30
+ 'validate_workflow_connections({workflow: {nodes: [...], connections: {...}}}) - Validate structure only'
31
+ ],
32
+ useCases: [
33
+ 'Quick validation when modifying workflow connections',
34
+ 'Ensure all node references in connections are valid',
35
+ 'Detect circular dependencies that would cause infinite loops',
36
+ 'Validate AI Agent nodes have proper tool connections',
37
+ 'Check workflow has at least one trigger node',
38
+ 'Find orphaned nodes not connected to any flow'
39
+ ],
40
+ performance: 'Fast (<100ms). Only validates structure, not node content. Scales linearly with connection count.',
41
+ bestPractices: [
42
+ 'Run after adding or removing connections',
43
+ 'Use before validate_workflow for quick structural checks',
44
+ 'Check for warnings about orphaned nodes',
45
+ 'Ensure trigger nodes are properly positioned',
46
+ 'Validate after using n8n_update_partial_workflow with connection operations'
47
+ ],
48
+ pitfalls: [
49
+ 'Does not validate node configurations - use validate_workflow for full validation',
50
+ 'Cannot detect logical errors in connection flow',
51
+ 'Some valid workflows may have intentionally disconnected nodes',
52
+ 'Circular dependency detection only catches direct loops',
53
+ 'Does not validate connection types match node capabilities'
54
+ ],
55
+ relatedTools: ['validate_workflow', 'validate_workflow_expressions', 'n8n_update_partial_workflow']
56
+ }
57
+ };
58
+ //# sourceMappingURL=validate-workflow-connections.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validate-workflow-connections.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/validation/validate-workflow-connections.ts"],"names":[],"mappings":";;;AAEa,QAAA,8BAA8B,GAAsB;IAC/D,IAAI,EAAE,+BAA+B;IACrC,QAAQ,EAAE,YAAY;IACtB,UAAU,EAAE;QACV,WAAW,EAAE,qHAAqH;QAClI,aAAa,EAAE,CAAC,UAAU,CAAC;QAC3B,OAAO,EAAE,+EAA+E;QACxF,WAAW,EAAE,eAAe;QAC5B,IAAI,EAAE;YACJ,yDAAyD;YACzD,kDAAkD;YAClD,sEAAsE;SACvE;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,+TAA+T;QAC5U,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,4DAA4D;aAC1E;SACF;QACD,OAAO,EAAE,iGAAiG;QAC1G,QAAQ,EAAE;YACR,+EAA+E;YAC/E,yGAAyG;SAC1G;QACD,QAAQ,EAAE;YACR,sDAAsD;YACtD,qDAAqD;YACrD,8DAA8D;YAC9D,sDAAsD;YACtD,8CAA8C;YAC9C,+CAA+C;SAChD;QACD,WAAW,EAAE,mGAAmG;QAChH,aAAa,EAAE;YACb,0CAA0C;YAC1C,0DAA0D;YAC1D,yCAAyC;YACzC,8CAA8C;YAC9C,6EAA6E;SAC9E;QACD,QAAQ,EAAE;YACR,mFAAmF;YACnF,iDAAiD;YACjD,gEAAgE;YAChE,yDAAyD;YACzD,4DAA4D;SAC7D;QACD,YAAY,EAAE,CAAC,mBAAmB,EAAE,+BAA+B,EAAE,6BAA6B,CAAC;KACpG;CACF,CAAC"}
@@ -0,0 +1,3 @@
1
+ import { ToolDocumentation } from '../types';
2
+ export declare const validateWorkflowExpressionsDoc: ToolDocumentation;
3
+ //# sourceMappingURL=validate-workflow-expressions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validate-workflow-expressions.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/validation/validate-workflow-expressions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,8BAA8B,EAAE,iBAqD5C,CAAC"}
@@ -0,0 +1,58 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.validateWorkflowExpressionsDoc = void 0;
4
+ exports.validateWorkflowExpressionsDoc = {
5
+ name: 'validate_workflow_expressions',
6
+ category: 'validation',
7
+ essentials: {
8
+ description: 'Validate n8n expressions: syntax {{}}, variables ($json/$node), references. Returns errors with locations.',
9
+ keyParameters: ['workflow'],
10
+ example: 'validate_workflow_expressions({workflow: {nodes: [...], connections: {...}}})',
11
+ performance: 'Fast (<100ms)',
12
+ tips: [
13
+ 'Catches syntax errors in {{}} expressions before runtime',
14
+ 'Validates $json, $node, and other n8n variables',
15
+ 'Shows exact location of expression errors in node parameters'
16
+ ]
17
+ },
18
+ full: {
19
+ description: 'Validates all n8n expressions within a workflow for syntax correctness and reference validity. This tool scans all node parameters for n8n expressions (enclosed in {{}}), checks expression syntax, validates variable references like $json and $node("NodeName"), ensures referenced nodes exist in the workflow, and provides detailed error locations for debugging.',
20
+ parameters: {
21
+ workflow: {
22
+ type: 'object',
23
+ required: true,
24
+ description: 'The workflow JSON to check for expression errors.'
25
+ }
26
+ },
27
+ returns: 'Object with valid (boolean), errors (array with node ID, parameter path, and error details), and expression count',
28
+ examples: [
29
+ 'validate_workflow_expressions({workflow: myWorkflow}) - Check all expressions',
30
+ 'validate_workflow_expressions({workflow: {nodes: [...], connections: {...}}}) - Validate expression syntax'
31
+ ],
32
+ useCases: [
33
+ 'Catch expression syntax errors before workflow execution',
34
+ 'Validate node references in $node() expressions exist',
35
+ 'Find typos in variable names like $json or $input',
36
+ 'Ensure complex expressions are properly formatted',
37
+ 'Debug expression errors with exact parameter locations',
38
+ 'Validate expressions after workflow modifications'
39
+ ],
40
+ performance: 'Fast (<100ms). Scans all string parameters in all nodes. Performance scales with workflow size and expression count.',
41
+ bestPractices: [
42
+ 'Run after modifying any expressions in node parameters',
43
+ 'Check all $node() references when renaming nodes',
44
+ 'Validate expressions before workflow deployment',
45
+ 'Pay attention to nested object paths in expressions',
46
+ 'Use with validate_workflow for comprehensive validation'
47
+ ],
48
+ pitfalls: [
49
+ 'Cannot validate expression logic, only syntax',
50
+ 'Runtime data availability not checked (e.g., if $json.field exists)',
51
+ 'Complex JavaScript in expressions may need runtime testing',
52
+ 'Does not validate expression return types',
53
+ 'Some valid expressions may use advanced features not fully parsed'
54
+ ],
55
+ relatedTools: ['validate_workflow', 'validate_workflow_connections', 'validate_node_operation']
56
+ }
57
+ };
58
+ //# sourceMappingURL=validate-workflow-expressions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validate-workflow-expressions.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/validation/validate-workflow-expressions.ts"],"names":[],"mappings":";;;AAEa,QAAA,8BAA8B,GAAsB;IAC/D,IAAI,EAAE,+BAA+B;IACrC,QAAQ,EAAE,YAAY;IACtB,UAAU,EAAE;QACV,WAAW,EAAE,4GAA4G;QACzH,aAAa,EAAE,CAAC,UAAU,CAAC;QAC3B,OAAO,EAAE,+EAA+E;QACxF,WAAW,EAAE,eAAe;QAC5B,IAAI,EAAE;YACJ,0DAA0D;YAC1D,iDAAiD;YACjD,8DAA8D;SAC/D;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,2WAA2W;QACxX,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,mDAAmD;aACjE;SACF;QACD,OAAO,EAAE,mHAAmH;QAC5H,QAAQ,EAAE;YACR,+EAA+E;YAC/E,4GAA4G;SAC7G;QACD,QAAQ,EAAE;YACR,0DAA0D;YAC1D,uDAAuD;YACvD,mDAAmD;YACnD,mDAAmD;YACnD,wDAAwD;YACxD,mDAAmD;SACpD;QACD,WAAW,EAAE,sHAAsH;QACnI,aAAa,EAAE;YACb,wDAAwD;YACxD,kDAAkD;YAClD,iDAAiD;YACjD,qDAAqD;YACrD,yDAAyD;SAC1D;QACD,QAAQ,EAAE;YACR,+CAA+C;YAC/C,qEAAqE;YACrE,4DAA4D;YAC5D,2CAA2C;YAC3C,mEAAmE;SACpE;QACD,YAAY,EAAE,CAAC,mBAAmB,EAAE,+BAA+B,EAAE,yBAAyB,CAAC;KAChG;CACF,CAAC"}
@@ -0,0 +1,3 @@
1
+ import { ToolDocumentation } from '../types';
2
+ export declare const validateWorkflowDoc: ToolDocumentation;
3
+ //# sourceMappingURL=validate-workflow.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validate-workflow.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/validation/validate-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,mBAAmB,EAAE,iBA8EjC,CAAC"}
@@ -0,0 +1,83 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.validateWorkflowDoc = void 0;
4
+ exports.validateWorkflowDoc = {
5
+ name: 'validate_workflow',
6
+ category: 'validation',
7
+ essentials: {
8
+ description: 'Full workflow validation: structure, connections, expressions, AI tools. Returns errors/warnings/fixes. Essential before deploy.',
9
+ keyParameters: ['workflow', 'options'],
10
+ example: 'validate_workflow({workflow: {nodes: [...], connections: {...}}})',
11
+ performance: 'Moderate (100-500ms)',
12
+ tips: [
13
+ 'Always validate before n8n_create_workflow to catch errors early',
14
+ 'Use options.profile="minimal" for quick checks during development',
15
+ 'AI tool connections are automatically validated for proper node references'
16
+ ]
17
+ },
18
+ full: {
19
+ description: 'Performs comprehensive validation of n8n workflows including structure, node configurations, connections, and expressions. This is a three-layer validation system that catches errors before deployment, validates complex multi-node workflows, checks all n8n expressions for syntax errors, and ensures proper node connections and data flow.',
20
+ parameters: {
21
+ workflow: {
22
+ type: 'object',
23
+ required: true,
24
+ description: 'The complete workflow JSON to validate. Must include nodes array and connections object.'
25
+ },
26
+ options: {
27
+ type: 'object',
28
+ required: false,
29
+ description: 'Validation options object'
30
+ },
31
+ 'options.validateNodes': {
32
+ type: 'boolean',
33
+ required: false,
34
+ description: 'Validate individual node configurations. Default: true'
35
+ },
36
+ 'options.validateConnections': {
37
+ type: 'boolean',
38
+ required: false,
39
+ description: 'Validate node connections and flow. Default: true'
40
+ },
41
+ 'options.validateExpressions': {
42
+ type: 'boolean',
43
+ required: false,
44
+ description: 'Validate n8n expressions syntax and references. Default: true'
45
+ },
46
+ 'options.profile': {
47
+ type: 'string',
48
+ required: false,
49
+ description: 'Validation profile for node validation: minimal, runtime (default), ai-friendly, strict'
50
+ }
51
+ },
52
+ returns: 'Object with valid (boolean), errors (array), warnings (array), statistics (object), and suggestions (array)',
53
+ examples: [
54
+ 'validate_workflow({workflow: myWorkflow}) - Full validation with default settings',
55
+ 'validate_workflow({workflow: myWorkflow, options: {profile: "minimal"}}) - Quick validation for editing',
56
+ 'validate_workflow({workflow: myWorkflow, options: {validateExpressions: false}}) - Skip expression validation'
57
+ ],
58
+ useCases: [
59
+ 'Pre-deployment validation to catch all workflow issues',
60
+ 'Quick validation during workflow development',
61
+ 'Validate workflows with AI Agent nodes and tool connections',
62
+ 'Check expression syntax before workflow execution',
63
+ 'Ensure workflow structure integrity after modifications'
64
+ ],
65
+ performance: 'Moderate (100-500ms). Depends on workflow size and validation options. Expression validation adds ~50-100ms.',
66
+ bestPractices: [
67
+ 'Always validate workflows before creating or updating in n8n',
68
+ 'Use minimal profile during development, strict profile before production',
69
+ 'Pay attention to warnings - they often indicate potential runtime issues',
70
+ 'Validate after any workflow modifications, especially connection changes',
71
+ 'Check statistics to understand workflow complexity'
72
+ ],
73
+ pitfalls: [
74
+ 'Large workflows (100+ nodes) may take longer to validate',
75
+ 'Expression validation requires proper node references to exist',
76
+ 'Some warnings may be acceptable depending on use case',
77
+ 'Validation cannot catch all runtime errors (e.g., API failures)',
78
+ 'Profile setting only affects node validation, not connection/expression checks'
79
+ ],
80
+ relatedTools: ['validate_workflow_connections', 'validate_workflow_expressions', 'validate_node_operation', 'n8n_create_workflow', 'n8n_update_partial_workflow']
81
+ }
82
+ };
83
+ //# sourceMappingURL=validate-workflow.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validate-workflow.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/validation/validate-workflow.ts"],"names":[],"mappings":";;;AAEa,QAAA,mBAAmB,GAAsB;IACpD,IAAI,EAAE,mBAAmB;IACzB,QAAQ,EAAE,YAAY;IACtB,UAAU,EAAE;QACV,WAAW,EAAE,kIAAkI;QAC/I,aAAa,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;QACtC,OAAO,EAAE,mEAAmE;QAC5E,WAAW,EAAE,sBAAsB;QACnC,IAAI,EAAE;YACJ,kEAAkE;YAClE,mEAAmE;YACnE,4EAA4E;SAC7E;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,oVAAoV;QACjW,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,0FAA0F;aACxG;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,2BAA2B;aACzC;YACD,uBAAuB,EAAE;gBACvB,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,wDAAwD;aACtE;YACD,6BAA6B,EAAE;gBAC7B,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,mDAAmD;aACjE;YACD,6BAA6B,EAAE;gBAC7B,IAAI,EAAE,SAAS;gBACf,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,+DAA+D;aAC7E;YACD,iBAAiB,EAAE;gBACjB,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,KAAK;gBACf,WAAW,EAAE,yFAAyF;aACvG;SACF;QACD,OAAO,EAAE,6GAA6G;QACtH,QAAQ,EAAE;YACR,mFAAmF;YACnF,yGAAyG;YACzG,+GAA+G;SAChH;QACD,QAAQ,EAAE;YACR,wDAAwD;YACxD,8CAA8C;YAC9C,6DAA6D;YAC7D,mDAAmD;YACnD,yDAAyD;SAC1D;QACD,WAAW,EAAE,8GAA8G;QAC3H,aAAa,EAAE;YACb,8DAA8D;YAC9D,0EAA0E;YAC1E,0EAA0E;YAC1E,0EAA0E;YAC1E,oDAAoD;SACrD;QACD,QAAQ,EAAE;YACR,0DAA0D;YAC1D,gEAAgE;YAChE,uDAAuD;YACvD,iEAAiE;YACjE,gFAAgF;SACjF;QACD,YAAY,EAAE,CAAC,+BAA+B,EAAE,+BAA+B,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,6BAA6B,CAAC;KAClK;CACF,CAAC"}
@@ -0,0 +1,15 @@
1
+ export { n8nCreateWorkflowDoc } from './n8n-create-workflow';
2
+ export { n8nGetWorkflowDoc } from './n8n-get-workflow';
3
+ export { n8nGetWorkflowDetailsDoc } from './n8n-get-workflow-details';
4
+ export { n8nGetWorkflowStructureDoc } from './n8n-get-workflow-structure';
5
+ export { n8nGetWorkflowMinimalDoc } from './n8n-get-workflow-minimal';
6
+ export { n8nUpdateFullWorkflowDoc } from './n8n-update-full-workflow';
7
+ export { n8nUpdatePartialWorkflowDoc } from './n8n-update-partial-workflow';
8
+ export { n8nDeleteWorkflowDoc } from './n8n-delete-workflow';
9
+ export { n8nListWorkflowsDoc } from './n8n-list-workflows';
10
+ export { n8nValidateWorkflowDoc } from './n8n-validate-workflow';
11
+ export { n8nTriggerWebhookWorkflowDoc } from './n8n-trigger-webhook-workflow';
12
+ export { n8nGetExecutionDoc } from './n8n-get-execution';
13
+ export { n8nListExecutionsDoc } from './n8n-list-executions';
14
+ export { n8nDeleteExecutionDoc } from './n8n-delete-execution';
15
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAC1E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC"}
@@ -0,0 +1,32 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.n8nDeleteExecutionDoc = exports.n8nListExecutionsDoc = exports.n8nGetExecutionDoc = exports.n8nTriggerWebhookWorkflowDoc = exports.n8nValidateWorkflowDoc = exports.n8nListWorkflowsDoc = exports.n8nDeleteWorkflowDoc = exports.n8nUpdatePartialWorkflowDoc = exports.n8nUpdateFullWorkflowDoc = exports.n8nGetWorkflowMinimalDoc = exports.n8nGetWorkflowStructureDoc = exports.n8nGetWorkflowDetailsDoc = exports.n8nGetWorkflowDoc = exports.n8nCreateWorkflowDoc = void 0;
4
+ var n8n_create_workflow_1 = require("./n8n-create-workflow");
5
+ Object.defineProperty(exports, "n8nCreateWorkflowDoc", { enumerable: true, get: function () { return n8n_create_workflow_1.n8nCreateWorkflowDoc; } });
6
+ var n8n_get_workflow_1 = require("./n8n-get-workflow");
7
+ Object.defineProperty(exports, "n8nGetWorkflowDoc", { enumerable: true, get: function () { return n8n_get_workflow_1.n8nGetWorkflowDoc; } });
8
+ var n8n_get_workflow_details_1 = require("./n8n-get-workflow-details");
9
+ Object.defineProperty(exports, "n8nGetWorkflowDetailsDoc", { enumerable: true, get: function () { return n8n_get_workflow_details_1.n8nGetWorkflowDetailsDoc; } });
10
+ var n8n_get_workflow_structure_1 = require("./n8n-get-workflow-structure");
11
+ Object.defineProperty(exports, "n8nGetWorkflowStructureDoc", { enumerable: true, get: function () { return n8n_get_workflow_structure_1.n8nGetWorkflowStructureDoc; } });
12
+ var n8n_get_workflow_minimal_1 = require("./n8n-get-workflow-minimal");
13
+ Object.defineProperty(exports, "n8nGetWorkflowMinimalDoc", { enumerable: true, get: function () { return n8n_get_workflow_minimal_1.n8nGetWorkflowMinimalDoc; } });
14
+ var n8n_update_full_workflow_1 = require("./n8n-update-full-workflow");
15
+ Object.defineProperty(exports, "n8nUpdateFullWorkflowDoc", { enumerable: true, get: function () { return n8n_update_full_workflow_1.n8nUpdateFullWorkflowDoc; } });
16
+ var n8n_update_partial_workflow_1 = require("./n8n-update-partial-workflow");
17
+ Object.defineProperty(exports, "n8nUpdatePartialWorkflowDoc", { enumerable: true, get: function () { return n8n_update_partial_workflow_1.n8nUpdatePartialWorkflowDoc; } });
18
+ var n8n_delete_workflow_1 = require("./n8n-delete-workflow");
19
+ Object.defineProperty(exports, "n8nDeleteWorkflowDoc", { enumerable: true, get: function () { return n8n_delete_workflow_1.n8nDeleteWorkflowDoc; } });
20
+ var n8n_list_workflows_1 = require("./n8n-list-workflows");
21
+ Object.defineProperty(exports, "n8nListWorkflowsDoc", { enumerable: true, get: function () { return n8n_list_workflows_1.n8nListWorkflowsDoc; } });
22
+ var n8n_validate_workflow_1 = require("./n8n-validate-workflow");
23
+ Object.defineProperty(exports, "n8nValidateWorkflowDoc", { enumerable: true, get: function () { return n8n_validate_workflow_1.n8nValidateWorkflowDoc; } });
24
+ var n8n_trigger_webhook_workflow_1 = require("./n8n-trigger-webhook-workflow");
25
+ Object.defineProperty(exports, "n8nTriggerWebhookWorkflowDoc", { enumerable: true, get: function () { return n8n_trigger_webhook_workflow_1.n8nTriggerWebhookWorkflowDoc; } });
26
+ var n8n_get_execution_1 = require("./n8n-get-execution");
27
+ Object.defineProperty(exports, "n8nGetExecutionDoc", { enumerable: true, get: function () { return n8n_get_execution_1.n8nGetExecutionDoc; } });
28
+ var n8n_list_executions_1 = require("./n8n-list-executions");
29
+ Object.defineProperty(exports, "n8nListExecutionsDoc", { enumerable: true, get: function () { return n8n_list_executions_1.n8nListExecutionsDoc; } });
30
+ var n8n_delete_execution_1 = require("./n8n-delete-execution");
31
+ Object.defineProperty(exports, "n8nDeleteExecutionDoc", { enumerable: true, get: function () { return n8n_delete_execution_1.n8nDeleteExecutionDoc; } });
32
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/index.ts"],"names":[],"mappings":";;;AAAA,6DAA6D;AAApD,2HAAA,oBAAoB,OAAA;AAC7B,uDAAuD;AAA9C,qHAAA,iBAAiB,OAAA;AAC1B,uEAAsE;AAA7D,oIAAA,wBAAwB,OAAA;AACjC,2EAA0E;AAAjE,wIAAA,0BAA0B,OAAA;AACnC,uEAAsE;AAA7D,oIAAA,wBAAwB,OAAA;AACjC,uEAAsE;AAA7D,oIAAA,wBAAwB,OAAA;AACjC,6EAA4E;AAAnE,0IAAA,2BAA2B,OAAA;AACpC,6DAA6D;AAApD,2HAAA,oBAAoB,OAAA;AAC7B,2DAA2D;AAAlD,yHAAA,mBAAmB,OAAA;AAC5B,iEAAiE;AAAxD,+HAAA,sBAAsB,OAAA;AAC/B,+EAA8E;AAArE,4IAAA,4BAA4B,OAAA;AACrC,yDAAyD;AAAhD,uHAAA,kBAAkB,OAAA;AAC3B,6DAA6D;AAApD,2HAAA,oBAAoB,OAAA;AAC7B,+DAA+D;AAAtD,6HAAA,qBAAqB,OAAA"}
@@ -0,0 +1,3 @@
1
+ import { ToolDocumentation } from '../types';
2
+ export declare const n8nCreateWorkflowDoc: ToolDocumentation;
3
+ //# sourceMappingURL=n8n-create-workflow.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"n8n-create-workflow.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-create-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,oBAAoB,EAAE,iBA8FlC,CAAC"}
@@ -0,0 +1,99 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.n8nCreateWorkflowDoc = void 0;
4
+ exports.n8nCreateWorkflowDoc = {
5
+ name: 'n8n_create_workflow',
6
+ category: 'workflow_management',
7
+ essentials: {
8
+ description: 'Create workflow. Requires: name, nodes[], connections{}. Created inactive. Returns workflow with ID.',
9
+ keyParameters: ['name', 'nodes', 'connections'],
10
+ example: 'n8n_create_workflow({name: "My Flow", nodes: [...], connections: {...}})',
11
+ performance: 'Network-dependent',
12
+ tips: [
13
+ 'Workflow created inactive',
14
+ 'Returns ID for future updates',
15
+ 'Validate first with validate_workflow'
16
+ ]
17
+ },
18
+ full: {
19
+ description: 'Creates a new workflow in n8n with specified nodes and connections. Workflow is created in inactive state. Each node requires: id, name, type, typeVersion, position, and parameters.',
20
+ parameters: {
21
+ name: { type: 'string', required: true, description: 'Workflow name' },
22
+ nodes: { type: 'array', required: true, description: 'Array of nodes with id, name, type, typeVersion, position, parameters' },
23
+ connections: { type: 'object', required: true, description: 'Node connections. Keys are source node IDs' },
24
+ settings: { type: 'object', description: 'Optional workflow settings (timezone, error handling, etc.)' }
25
+ },
26
+ returns: 'Created workflow object with id, name, nodes, connections, active status',
27
+ examples: [
28
+ `// Basic webhook to Slack workflow
29
+ n8n_create_workflow({
30
+ name: "Webhook to Slack",
31
+ nodes: [
32
+ {
33
+ id: "webhook_1",
34
+ name: "Webhook",
35
+ type: "n8n-nodes-base.webhook",
36
+ typeVersion: 1,
37
+ position: [250, 300],
38
+ parameters: {
39
+ httpMethod: "POST",
40
+ path: "slack-notify"
41
+ }
42
+ },
43
+ {
44
+ id: "slack_1",
45
+ name: "Slack",
46
+ type: "n8n-nodes-base.slack",
47
+ typeVersion: 1,
48
+ position: [450, 300],
49
+ parameters: {
50
+ resource: "message",
51
+ operation: "post",
52
+ channel: "#general",
53
+ text: "={{$json.message}}"
54
+ }
55
+ }
56
+ ],
57
+ connections: {
58
+ "webhook_1": {
59
+ "main": [[{node: "slack_1", type: "main", index: 0}]]
60
+ }
61
+ }
62
+ })`,
63
+ `// Workflow with settings and error handling
64
+ n8n_create_workflow({
65
+ name: "Data Processing",
66
+ nodes: [...],
67
+ connections: {...},
68
+ settings: {
69
+ timezone: "America/New_York",
70
+ errorWorkflow: "error_handler_workflow_id",
71
+ saveDataSuccessExecution: "all",
72
+ saveDataErrorExecution: "all"
73
+ }
74
+ })`
75
+ ],
76
+ useCases: [
77
+ 'Deploy validated workflows',
78
+ 'Automate workflow creation',
79
+ 'Clone workflow structures',
80
+ 'Template deployment'
81
+ ],
82
+ performance: 'Network-dependent - Typically 100-500ms depending on workflow size',
83
+ bestPractices: [
84
+ 'Validate with validate_workflow first',
85
+ 'Use unique node IDs',
86
+ 'Position nodes for readability',
87
+ 'Test with n8n_trigger_webhook_workflow'
88
+ ],
89
+ pitfalls: [
90
+ '**REQUIRES N8N_API_URL and N8N_API_KEY environment variables** - tool unavailable without n8n API access',
91
+ 'Workflows created in INACTIVE state - must activate separately',
92
+ 'Node IDs must be unique within workflow',
93
+ 'Credentials must be configured separately in n8n',
94
+ 'Node type names must include package prefix (e.g., "n8n-nodes-base.slack")'
95
+ ],
96
+ relatedTools: ['validate_workflow', 'n8n_update_partial_workflow', 'n8n_trigger_webhook_workflow']
97
+ }
98
+ };
99
+ //# sourceMappingURL=n8n-create-workflow.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"n8n-create-workflow.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-create-workflow.ts"],"names":[],"mappings":";;;AAEa,QAAA,oBAAoB,GAAsB;IACrD,IAAI,EAAE,qBAAqB;IAC3B,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE;QACV,WAAW,EAAE,sGAAsG;QACnH,aAAa,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC;QAC/C,OAAO,EAAE,0EAA0E;QACnF,WAAW,EAAE,mBAAmB;QAChC,IAAI,EAAE;YACJ,2BAA2B;YAC3B,+BAA+B;YAC/B,uCAAuC;SACxC;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,uLAAuL;QACpM,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE;YACtE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uEAAuE,EAAE;YAC9H,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,4CAA4C,EAAE;YAC1G,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,6DAA6D,EAAE;SACzG;QACD,OAAO,EAAE,0EAA0E;QACnF,QAAQ,EAAE;YACR;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCH;YACG;;;;;;;;;;;GAWH;SACE;QACD,QAAQ,EAAE;YACR,4BAA4B;YAC5B,4BAA4B;YAC5B,2BAA2B;YAC3B,qBAAqB;SACtB;QACD,WAAW,EAAE,oEAAoE;QACjF,aAAa,EAAE;YACb,uCAAuC;YACvC,qBAAqB;YACrB,gCAAgC;YAChC,wCAAwC;SACzC;QACD,QAAQ,EAAE;YACR,0GAA0G;YAC1G,gEAAgE;YAChE,yCAAyC;YACzC,kDAAkD;YAClD,4EAA4E;SAC7E;QACD,YAAY,EAAE,CAAC,mBAAmB,EAAE,6BAA6B,EAAE,8BAA8B,CAAC;KACnG;CACF,CAAC"}
@@ -0,0 +1,3 @@
1
+ import { ToolDocumentation } from '../types';
2
+ export declare const n8nDeleteExecutionDoc: ToolDocumentation;
3
+ //# sourceMappingURL=n8n-delete-execution.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"n8n-delete-execution.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-delete-execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,qBAAqB,EAAE,iBAsDnC,CAAC"}
@@ -0,0 +1,59 @@
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
@@ -0,0 +1 @@
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"}
@@ -0,0 +1,3 @@
1
+ import { ToolDocumentation } from '../types';
2
+ export declare const n8nDeleteWorkflowDoc: ToolDocumentation;
3
+ //# sourceMappingURL=n8n-delete-workflow.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"n8n-delete-workflow.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/workflow_management/n8n-delete-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,oBAAoB,EAAE,iBA+ClC,CAAC"}