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
@@ -88,52 +88,57 @@ When working with Code nodes, always start by calling the relevant guide:
88
88
  - search_nodes({query: "AI langchain"}) - Search for AI-capable nodes
89
89
 
90
90
  2. **Configure** the node (ALWAYS START WITH STANDARD DETAIL):
91
- - ✅ get_node("nodes-base.slack", {detail: 'standard'}) - Get essential properties FIRST (~1-2KB, shows required fields)
92
- - get_node("nodes-base.slack", {detail: 'full'}) - Get complete schema only if standard insufficient (~100KB+)
93
- - get_node("nodes-base.slack", {detail: 'minimal'}) - Get basic metadata only (~200 tokens)
94
- - search_node_properties("nodes-base.slack", "auth") - Find specific properties
91
+ - ✅ get_node({nodeType: "nodes-base.slack", detail: "standard"}) - Get essential properties FIRST (~1-2KB, shows required fields)
92
+ - get_node({nodeType: "nodes-base.slack", detail: "full"}) - Get complete schema only if standard insufficient (~100KB+)
93
+ - get_node({nodeType: "nodes-base.slack", mode: "docs"}) - Get readable markdown documentation
94
+ - get_node({nodeType: "nodes-base.slack", mode: "search_properties", propertyQuery: "auth"}) - Find specific properties
95
95
 
96
96
  3. **Validate** before deployment:
97
- - validate_node_minimal("nodes-base.slack", config) - Check required fields (includes automatic structure validation)
98
- - validate_node_operation("nodes-base.slack", config) - Full validation with fixes (includes automatic structure validation)
99
- - validate_workflow(workflow) - Validate entire workflow
97
+ - validate_node({nodeType: "nodes-base.slack", config: {...}, mode: "minimal"}) - Quick required fields check
98
+ - validate_node({nodeType: "nodes-base.slack", config: {...}}) - Full validation with errors/warnings/suggestions
99
+ - validate_workflow({workflow: {...}}) - Validate entire workflow
100
100
 
101
- ## Tool Categories
101
+ ## Tool Categories (19 Tools Total)
102
102
 
103
- **Discovery Tools**
103
+ **Discovery Tools** (1 tool)
104
104
  - search_nodes - Full-text search across all nodes (supports OR, AND, FUZZY modes)
105
105
 
106
- **Configuration Tools**
107
- - get_node - Unified node information tool with progressive detail levels:
108
- - detail='minimal': Basic metadata (~200 tokens)
109
- - detail='standard': Essential properties (default, ~1-2KB) - USE THIS FIRST!
110
- - detail='full': Complete schema (~100KB+, use only when standard insufficient)
111
- - mode='versions': View version history and breaking changes
112
- - includeTypeInfo=true: Add type structure metadata
113
- - search_node_properties - Search for specific properties within a node
114
- - get_property_dependencies - Analyze property visibility dependencies
115
-
116
- **Validation Tools**
117
- - validate_node_minimal - Quick validation of required fields (includes structure validation)
118
- - validate_node_operation - Full validation with operation awareness (includes structure validation)
119
- - validate_workflow - Complete workflow validation including connections
120
-
121
- **Template Tools**
122
- - get_node_for_task - Get pre-configured node for specific tasks
123
- - search_templates - Search workflow templates by keyword
106
+ **Configuration Tools** (1 consolidated tool)
107
+ - get_node - Unified node information tool:
108
+ - detail='minimal'/'standard'/'full': Progressive detail levels
109
+ - mode='docs': Readable markdown documentation
110
+ - mode='search_properties': Find specific properties
111
+ - mode='versions'/'compare'/'breaking'/'migrations': Version management
112
+
113
+ **Validation Tools** (2 tools)
114
+ - validate_node - Unified validation with mode='full' or mode='minimal'
115
+ - validate_workflow - Complete workflow validation (nodes, connections, expressions)
116
+
117
+ **Template Tools** (2 tools)
124
118
  - get_template - Get complete workflow JSON by ID
125
- - list_node_templates - Find templates using specific nodes
126
- - get_templates_for_task - Get curated templates by task type
119
+ - search_templates - Unified template search:
120
+ - searchMode='keyword': Text search (default)
121
+ - searchMode='by_nodes': Find templates using specific nodes
122
+ - searchMode='by_task': Curated task-based templates
123
+ - searchMode='by_metadata': Filter by complexity/services
127
124
 
128
- **n8n API Tools** (requires N8N_API_URL configuration)
125
+ **n8n API Tools** (12 tools, requires N8N_API_URL configuration)
129
126
  - n8n_create_workflow - Create new workflows
130
- - n8n_update_partial_workflow - Update workflows using diff operations
131
- - n8n_validate_workflow - Validate workflow from n8n instance
132
- - n8n_trigger_webhook_workflow - Trigger workflow execution
127
+ - n8n_get_workflow - Get workflow with mode='full'/'details'/'structure'/'minimal'
128
+ - n8n_update_full_workflow - Full workflow replacement
129
+ - n8n_update_partial_workflow - Incremental diff-based updates
130
+ - n8n_delete_workflow - Delete workflow
131
+ - n8n_list_workflows - List workflows with filters
132
+ - n8n_validate_workflow - Validate workflow by ID
133
+ - n8n_autofix_workflow - Auto-fix common issues
134
+ - n8n_trigger_webhook_workflow - Trigger via webhook
135
+ - n8n_executions - Unified execution management (action='get'/'list'/'delete')
136
+ - n8n_health_check - Check n8n API connectivity
137
+ - n8n_workflow_versions - Version history and rollback
133
138
 
134
139
  ## Performance Characteristics
135
140
  - Instant (<10ms): search_nodes, get_node (minimal/standard)
136
- - Fast (<100ms): validate_node_minimal, get_node_for_task
141
+ - Fast (<100ms): validate_node, get_template
137
142
  - Moderate (100-500ms): validate_workflow, get_node (full detail)
138
143
  - Network-dependent: All n8n_* tools
139
144
 
@@ -1 +1 @@
1
- {"version":3,"file":"tools-documentation.js","sourceRoot":"","sources":["../../src/mcp/tools-documentation.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"tools-documentation.js","sourceRoot":"","sources":["../../src/mcp/tools-documentation.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"tools-n8n-friendly.d.ts","sourceRoot":"","sources":["../../src/mcp/tools-n8n-friendly.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAyHA,CAAC;AAMF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,CAiCxD"}
1
+ {"version":3,"file":"tools-n8n-friendly.d.ts","sourceRoot":"","sources":["../../src/mcp/tools-n8n-friendly.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAqEA,CAAC;AAMF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,CAiCxD"}
@@ -3,21 +3,15 @@ Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.n8nFriendlyDescriptions = void 0;
4
4
  exports.makeToolsN8nFriendly = makeToolsN8nFriendly;
5
5
  exports.n8nFriendlyDescriptions = {
6
- validate_node_operation: {
7
- description: 'Validate n8n node. ALWAYS pass two parameters: nodeType (string) and config (object). Example call: {"nodeType": "nodes-base.slack", "config": {"resource": "channel", "operation": "create"}}',
6
+ validate_node: {
7
+ description: 'Validate n8n node config. Pass nodeType (string) and config (object). Use mode="full" for comprehensive validation, mode="minimal" for quick check. Example: {"nodeType": "nodes-base.slack", "config": {"resource": "channel", "operation": "create"}}',
8
8
  params: {
9
9
  nodeType: 'String value like "nodes-base.slack"',
10
10
  config: 'Object value like {"resource": "channel", "operation": "create"} or empty object {}',
11
+ mode: 'Optional string: "full" (default) or "minimal"',
11
12
  profile: 'Optional string: "minimal" or "runtime" or "ai-friendly" or "strict"'
12
13
  }
13
14
  },
14
- validate_node_minimal: {
15
- description: 'Check required fields. MUST pass: nodeType (string) and config (object). Example: {"nodeType": "nodes-base.webhook", "config": {}}',
16
- params: {
17
- nodeType: 'String like "nodes-base.webhook"',
18
- config: 'Object, use {} for empty'
19
- }
20
- },
21
15
  search_nodes: {
22
16
  description: 'Search nodes. Pass query (string). Example: {"query": "webhook"}',
23
17
  params: {
@@ -25,80 +19,44 @@ exports.n8nFriendlyDescriptions = {
25
19
  limit: 'Optional number, default 20'
26
20
  }
27
21
  },
28
- get_node_info: {
29
- description: 'Get node details. Pass nodeType (string). Example: {"nodeType": "nodes-base.httpRequest"}',
30
- params: {
31
- nodeType: 'String with prefix like "nodes-base.httpRequest"'
32
- }
33
- },
34
- get_node_essentials: {
35
- description: 'Get node basics. Pass nodeType (string). Example: {"nodeType": "nodes-base.slack"}',
36
- params: {
37
- nodeType: 'String with prefix like "nodes-base.slack"'
38
- }
39
- },
40
- get_node_for_task: {
41
- description: 'Find node for task. Pass task (string). Example: {"task": "send_http_request"}',
42
- params: {
43
- task: 'String task name like "send_http_request"'
44
- }
45
- },
46
- list_tasks: {
47
- description: 'List tasks by category. Pass category (string). Example: {"category": "HTTP/API"}',
22
+ get_node: {
23
+ description: 'Get node info with multiple modes. Pass nodeType (string). Use mode="info" for config, mode="docs" for documentation, mode="search_properties" with propertyQuery for finding fields. Example: {"nodeType": "nodes-base.httpRequest", "detail": "standard"}',
48
24
  params: {
49
- category: 'String: "HTTP/API" or "Webhooks" or "Database" or "AI/LangChain" or "Data Processing" or "Communication"'
25
+ nodeType: 'String with prefix like "nodes-base.httpRequest"',
26
+ mode: 'Optional string: "info" (default), "docs", "search_properties", "versions", "compare", "breaking", "migrations"',
27
+ detail: 'Optional string: "minimal", "standard" (default), "full"',
28
+ propertyQuery: 'For mode="search_properties": search term like "auth"'
50
29
  }
51
30
  },
52
31
  validate_workflow: {
53
- description: 'Validate workflow. Pass workflow object. MUST have: {"workflow": {"nodes": [array of node objects], "connections": {object with node connections}}}. Each node needs: name, type, typeVersion, position.',
32
+ description: 'Validate workflow structure, connections, and expressions. Pass workflow object. MUST have: {"workflow": {"nodes": [array of node objects], "connections": {object with node connections}}}. Each node needs: name, type, typeVersion, position.',
54
33
  params: {
55
34
  workflow: 'Object with two required fields: nodes (array) and connections (object). Example: {"nodes": [{"name": "Webhook", "type": "n8n-nodes-base.webhook", "typeVersion": 2, "position": [250, 300], "parameters": {}}], "connections": {}}',
56
- options: 'Optional object. Example: {"validateNodes": true, "profile": "runtime"}'
57
- }
58
- },
59
- validate_workflow_connections: {
60
- description: 'Validate workflow connections only. Pass workflow object. Example: {"workflow": {"nodes": [...], "connections": {}}}',
61
- params: {
62
- workflow: 'Object with nodes array and connections object. Minimal example: {"nodes": [{"name": "Webhook"}], "connections": {}}'
63
- }
64
- },
65
- validate_workflow_expressions: {
66
- description: 'Validate n8n expressions in workflow. Pass workflow object. Example: {"workflow": {"nodes": [...], "connections": {}}}',
67
- params: {
68
- workflow: 'Object with nodes array and connections object containing n8n expressions like {{ $json.data }}'
69
- }
70
- },
71
- get_property_dependencies: {
72
- description: 'Get field dependencies. Pass nodeType (string) and optional config (object). Example: {"nodeType": "nodes-base.httpRequest", "config": {}}',
73
- params: {
74
- nodeType: 'String like "nodes-base.httpRequest"',
75
- config: 'Optional object, use {} for empty'
76
- }
77
- },
78
- get_node_as_tool_info: {
79
- description: 'Get AI tool usage. Pass nodeType (string). Example: {"nodeType": "nodes-base.slack"}',
80
- params: {
81
- nodeType: 'String with prefix like "nodes-base.slack"'
35
+ options: 'Optional object. Example: {"validateNodes": true, "validateConnections": true, "validateExpressions": true, "profile": "runtime"}'
82
36
  }
83
37
  },
84
38
  search_templates: {
85
- description: 'Search workflow templates. Pass query (string). Example: {"query": "chatbot"}',
39
+ description: 'Search workflow templates with multiple modes. Use searchMode="keyword" for text search, searchMode="by_nodes" to find by node types, searchMode="by_task" for task-based templates, searchMode="by_metadata" for filtering. Example: {"query": "chatbot"} or {"searchMode": "by_task", "task": "webhook_processing"}',
86
40
  params: {
87
- query: 'String keyword like "chatbot" or "webhook"',
41
+ query: 'For searchMode="keyword": string keyword like "chatbot"',
42
+ searchMode: 'Optional: "keyword" (default), "by_nodes", "by_task", "by_metadata"',
43
+ nodeTypes: 'For searchMode="by_nodes": array like ["n8n-nodes-base.httpRequest"]',
44
+ task: 'For searchMode="by_task": task like "webhook_processing", "ai_automation"',
88
45
  limit: 'Optional number, default 20'
89
46
  }
90
47
  },
91
48
  get_template: {
92
49
  description: 'Get template by ID. Pass templateId (number). Example: {"templateId": 1234}',
93
50
  params: {
94
- templateId: 'Number ID like 1234'
51
+ templateId: 'Number ID like 1234',
52
+ mode: 'Optional: "full" (default), "nodes_only", "structure"'
95
53
  }
96
54
  },
97
55
  tools_documentation: {
98
56
  description: 'Get tool docs. Pass optional depth (string). Example: {"depth": "essentials"} or {}',
99
57
  params: {
100
- depth: 'Optional string: "essentials" or "overview" or "detailed"',
101
- topic: 'Optional string topic name'
58
+ depth: 'Optional string: "essentials" (default) or "full"',
59
+ topic: 'Optional string tool name like "search_nodes"'
102
60
  }
103
61
  }
104
62
  };
@@ -1 +1 @@
1
- {"version":3,"file":"tools-n8n-friendly.js","sourceRoot":"","sources":["../../src/mcp/tools-n8n-friendly.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"tools-n8n-friendly.js","sourceRoot":"","sources":["../../src/mcp/tools-n8n-friendly.ts"],"names":[],"mappings":";;;AAyFA,oDAiCC;AA/GY,QAAA,uBAAuB,GAG/B;IAEH,aAAa,EAAE;QACb,WAAW,EAAE,yPAAyP;QACtQ,MAAM,EAAE;YACN,QAAQ,EAAE,sCAAsC;YAChD,MAAM,EAAE,qFAAqF;YAC7F,IAAI,EAAE,gDAAgD;YACtD,OAAO,EAAE,sEAAsE;SAChF;KACF;IAGD,YAAY,EAAE;QACZ,WAAW,EAAE,kEAAkE;QAC/E,MAAM,EAAE;YACN,KAAK,EAAE,6CAA6C;YACpD,KAAK,EAAE,6BAA6B;SACrC;KACF;IAGD,QAAQ,EAAE;QACR,WAAW,EAAE,6PAA6P;QAC1Q,MAAM,EAAE;YACN,QAAQ,EAAE,kDAAkD;YAC5D,IAAI,EAAE,iHAAiH;YACvH,MAAM,EAAE,0DAA0D;YAClE,aAAa,EAAE,uDAAuD;SACvE;KACF;IAGD,iBAAiB,EAAE;QACjB,WAAW,EAAE,kPAAkP;QAC/P,MAAM,EAAE;YACN,QAAQ,EAAE,qOAAqO;YAC/O,OAAO,EAAE,mIAAmI;SAC7I;KACF;IAGD,gBAAgB,EAAE;QAChB,WAAW,EAAE,uTAAuT;QACpU,MAAM,EAAE;YACN,KAAK,EAAE,yDAAyD;YAChE,UAAU,EAAE,qEAAqE;YACjF,SAAS,EAAE,sEAAsE;YACjF,IAAI,EAAE,2EAA2E;YACjF,KAAK,EAAE,6BAA6B;SACrC;KACF;IAED,YAAY,EAAE;QACZ,WAAW,EAAE,6EAA6E;QAC1F,MAAM,EAAE;YACN,UAAU,EAAE,qBAAqB;YACjC,IAAI,EAAE,uDAAuD;SAC9D;KACF;IAGD,mBAAmB,EAAE;QACnB,WAAW,EAAE,qFAAqF;QAClG,MAAM,EAAE;YACN,KAAK,EAAE,mDAAmD;YAC1D,KAAK,EAAE,+CAA+C;SACvD;KACF;CACF,CAAC;AAMF,SAAgB,oBAAoB,CAAC,KAAY;IAC/C,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAc,CAAC;QACrC,MAAM,YAAY,GAAG,+BAAuB,CAAC,QAAQ,CAAC,CAAC;QACvD,IAAI,YAAY,EAAE,CAAC;YAEjB,MAAM,WAAW,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;YAGhC,WAAW,CAAC,WAAW,GAAG,YAAY,CAAC,WAAW,CAAC;YAGnD,IAAI,IAAI,CAAC,WAAW,EAAE,UAAU,EAAE,CAAC;gBACjC,WAAW,CAAC,WAAW,GAAG;oBACxB,GAAG,IAAI,CAAC,WAAW;oBACnB,UAAU,EAAE,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE;iBAC/C,CAAC;gBAGF,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;oBAC9D,IAAI,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;wBAC/B,WAAW,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG;4BAC1C,GAAG,WAAW,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC;4BAC5C,WAAW,EAAE,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC;yBACxC,CAAC;oBACJ,CAAC;gBACH,CAAC,CAAC,CAAC;YACL,CAAC;YAED,OAAO,WAAW,CAAC;QACrB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "n8n-mcp",
3
- "version": "2.26.1",
3
+ "version": "2.26.2",
4
4
  "description": "Integration between n8n workflow automation and Model Context Protocol (MCP)",
5
5
  "dependencies": {
6
6
  "@modelcontextprotocol/sdk": "^1.13.2",
@@ -1,3 +0,0 @@
1
- import { ToolDocumentation } from '../types';
2
- export declare const getNodeAsToolInfoDoc: ToolDocumentation;
3
- //# sourceMappingURL=get-node-as-tool-info.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"get-node-as-tool-info.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/configuration/get-node-as-tool-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,oBAAoB,EAAE,iBAoElC,CAAC"}
@@ -1,73 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.getNodeAsToolInfoDoc = void 0;
4
- exports.getNodeAsToolInfoDoc = {
5
- name: 'get_node_as_tool_info',
6
- category: 'configuration',
7
- essentials: {
8
- description: 'Explains how to use ANY node as an AI tool with requirements and examples.',
9
- keyParameters: ['nodeType'],
10
- example: 'get_node_as_tool_info({nodeType: "nodes-base.slack"})',
11
- performance: 'Fast - returns guidance and examples',
12
- tips: [
13
- 'ANY node can be used as AI tool, not just AI-marked ones',
14
- 'Community nodes need N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true',
15
- 'Provides specific use cases and connection requirements'
16
- ]
17
- },
18
- full: {
19
- description: `Shows how to use any n8n node as an AI tool in AI Agent workflows. In n8n, ANY node can be connected to an AI Agent's tool port, allowing the AI to use that node's functionality. This tool provides specific guidance, requirements, and examples for using a node as an AI tool.`,
20
- parameters: {
21
- nodeType: {
22
- type: 'string',
23
- required: true,
24
- description: 'Full node type WITH prefix: "nodes-base.slack", "nodes-base.googleSheets", etc.',
25
- examples: [
26
- 'nodes-base.slack',
27
- 'nodes-base.httpRequest',
28
- 'nodes-base.googleSheets',
29
- 'nodes-langchain.documentLoader'
30
- ]
31
- }
32
- },
33
- returns: `Object containing:
34
- - nodeType: The node's full type identifier
35
- - displayName: Human-readable name
36
- - isMarkedAsAITool: Whether node has usableAsTool property
37
- - aiToolCapabilities: Detailed AI tool usage information including:
38
- - canBeUsedAsTool: Always true in n8n
39
- - requiresEnvironmentVariable: For community nodes
40
- - commonUseCases: Specific AI tool use cases
41
- - requirements: Connection and environment setup
42
- - examples: Code examples for common scenarios
43
- - tips: Best practices for AI tool usage`,
44
- examples: [
45
- 'get_node_as_tool_info({nodeType: "nodes-base.slack"}) - Get AI tool guidance for Slack',
46
- 'get_node_as_tool_info({nodeType: "nodes-base.httpRequest"}) - Learn to use HTTP Request as AI tool',
47
- 'get_node_as_tool_info({nodeType: "nodes-base.postgres"}) - Database queries as AI tools'
48
- ],
49
- useCases: [
50
- 'Understanding how to connect any node to AI Agent',
51
- 'Learning environment requirements for community nodes',
52
- 'Getting specific use case examples for AI tool usage',
53
- 'Checking if a node is optimized for AI usage',
54
- 'Understanding credential requirements for AI tools'
55
- ],
56
- performance: 'Very fast - returns pre-computed guidance and examples',
57
- bestPractices: [
58
- 'Use this before configuring nodes as AI tools',
59
- 'Check environment requirements for community nodes',
60
- 'Review common use cases to understand best applications',
61
- 'Test nodes independently before connecting to AI Agent',
62
- 'Give tools descriptive names in AI Agent configuration'
63
- ],
64
- pitfalls: [
65
- 'Community nodes require environment variable to be used as tools',
66
- 'Not all nodes make sense as AI tools (e.g., triggers)',
67
- 'Some nodes require specific credentials configuration',
68
- 'Tool descriptions in AI Agent must be clear and detailed'
69
- ],
70
- relatedTools: ['list_ai_tools', 'get_node_essentials', 'validate_node_operation']
71
- }
72
- };
73
- //# sourceMappingURL=get-node-as-tool-info.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"get-node-as-tool-info.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/configuration/get-node-as-tool-info.ts"],"names":[],"mappings":";;;AAEa,QAAA,oBAAoB,GAAsB;IACrD,IAAI,EAAE,uBAAuB;IAC7B,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE;QACV,WAAW,EAAE,4EAA4E;QACzF,aAAa,EAAE,CAAC,UAAU,CAAC;QAC3B,OAAO,EAAE,uDAAuD;QAChE,WAAW,EAAE,sCAAsC;QACnD,IAAI,EAAE;YACJ,0DAA0D;YAC1D,mEAAmE;YACnE,yDAAyD;SAC1D;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,qRAAqR;QAClS,UAAU,EAAE;YACV,QAAQ,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,QAAQ,EAAE,IAAI;gBACd,WAAW,EAAE,iFAAiF;gBAC9F,QAAQ,EAAE;oBACR,kBAAkB;oBAClB,wBAAwB;oBACxB,yBAAyB;oBACzB,gCAAgC;iBACjC;aACF;SACF;QACD,OAAO,EAAE;;;;;;;;;;2CAU8B;QACvC,QAAQ,EAAE;YACR,wFAAwF;YACxF,oGAAoG;YACpG,yFAAyF;SAC1F;QACD,QAAQ,EAAE;YACR,mDAAmD;YACnD,uDAAuD;YACvD,sDAAsD;YACtD,8CAA8C;YAC9C,oDAAoD;SACrD;QACD,WAAW,EAAE,wDAAwD;QACrE,aAAa,EAAE;YACb,+CAA+C;YAC/C,oDAAoD;YACpD,yDAAyD;YACzD,wDAAwD;YACxD,wDAAwD;SACzD;QACD,QAAQ,EAAE;YACR,kEAAkE;YAClE,uDAAuD;YACvD,uDAAuD;YACvD,0DAA0D;SAC3D;QACD,YAAY,EAAE,CAAC,eAAe,EAAE,qBAAqB,EAAE,yBAAyB,CAAC;KAClF;CACF,CAAC"}
@@ -1,3 +0,0 @@
1
- import { ToolDocumentation } from '../types';
2
- export declare const getNodeDocumentationDoc: ToolDocumentation;
3
- //# sourceMappingURL=get-node-documentation.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"get-node-documentation.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/configuration/get-node-documentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,uBAAuB,EAAE,iBA0CrC,CAAC"}
@@ -1,47 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.getNodeDocumentationDoc = void 0;
4
- exports.getNodeDocumentationDoc = {
5
- name: 'get_node_documentation',
6
- category: 'configuration',
7
- essentials: {
8
- description: 'Get readable docs with examples/auth/patterns. Better than raw schema! 87% coverage. Format: "nodes-base.slack"',
9
- keyParameters: ['nodeType'],
10
- example: 'get_node_documentation({nodeType: "nodes-base.slack"})',
11
- performance: 'Fast - pre-parsed',
12
- tips: [
13
- '87% coverage',
14
- 'Includes auth examples',
15
- 'Human-readable format'
16
- ]
17
- },
18
- full: {
19
- description: 'Returns human-readable documentation parsed from n8n-docs including examples, authentication setup, and common patterns. More useful than raw schema for understanding node usage.',
20
- parameters: {
21
- nodeType: { type: 'string', required: true, description: 'Full node type with prefix (e.g., "nodes-base.slack")' }
22
- },
23
- returns: 'Parsed markdown documentation with examples, authentication guides, common patterns',
24
- examples: [
25
- 'get_node_documentation({nodeType: "nodes-base.slack"}) - Slack usage guide',
26
- 'get_node_documentation({nodeType: "nodes-base.googleSheets"}) - Sheets examples'
27
- ],
28
- useCases: [
29
- 'Understanding authentication setup',
30
- 'Finding usage examples',
31
- 'Learning common patterns'
32
- ],
33
- performance: 'Fast - Pre-parsed documentation stored in database',
34
- bestPractices: [
35
- 'Use for learning node usage',
36
- 'Check coverage with get_database_statistics',
37
- 'Combine with get_node_essentials'
38
- ],
39
- pitfalls: [
40
- 'Not all nodes have docs (87% coverage)',
41
- 'May be outdated for new features',
42
- 'Requires full node type prefix'
43
- ],
44
- relatedTools: ['get_node_info', 'get_node_essentials', 'search_nodes']
45
- }
46
- };
47
- //# sourceMappingURL=get-node-documentation.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"get-node-documentation.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/configuration/get-node-documentation.ts"],"names":[],"mappings":";;;AAEa,QAAA,uBAAuB,GAAsB;IACxD,IAAI,EAAE,wBAAwB;IAC9B,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE;QACV,WAAW,EAAE,iHAAiH;QAC9H,aAAa,EAAE,CAAC,UAAU,CAAC;QAC3B,OAAO,EAAE,wDAAwD;QACjE,WAAW,EAAE,mBAAmB;QAChC,IAAI,EAAE;YACJ,cAAc;YACd,wBAAwB;YACxB,uBAAuB;SACxB;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,oLAAoL;QACjM,UAAU,EAAE;YACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uDAAuD,EAAE;SACnH;QACD,OAAO,EAAE,qFAAqF;QAC9F,QAAQ,EAAE;YACR,4EAA4E;YAC5E,iFAAiF;SAClF;QACD,QAAQ,EAAE;YACR,oCAAoC;YACpC,wBAAwB;YACxB,0BAA0B;SAC3B;QACD,WAAW,EAAE,oDAAoD;QACjE,aAAa,EAAE;YACb,6BAA6B;YAC7B,6CAA6C;YAC7C,kCAAkC;SACnC;QACD,QAAQ,EAAE;YACR,wCAAwC;YACxC,kCAAkC;YAClC,gCAAgC;SACjC;QACD,YAAY,EAAE,CAAC,eAAe,EAAE,qBAAqB,EAAE,cAAc,CAAC;KACvE;CACF,CAAC"}
@@ -1,3 +0,0 @@
1
- import { ToolDocumentation } from '../types';
2
- export declare const getNodeEssentialsDoc: ToolDocumentation;
3
- //# sourceMappingURL=get-node-essentials.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"get-node-essentials.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/configuration/get-node-essentials.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,oBAAoB,EAAE,iBAmFlC,CAAC"}
@@ -1,88 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.getNodeEssentialsDoc = void 0;
4
- exports.getNodeEssentialsDoc = {
5
- name: 'get_node_essentials',
6
- category: 'configuration',
7
- essentials: {
8
- description: 'Returns only the most commonly-used properties for a node (10-20 fields). Response is 95% smaller than get_node_info (5KB vs 100KB+). Essential properties include required fields, common options, and authentication settings. Use validate_node_operation for working configurations.',
9
- keyParameters: ['nodeType'],
10
- example: 'get_node_essentials({nodeType: "nodes-base.slack"})',
11
- performance: '<10ms, ~5KB response',
12
- tips: [
13
- 'Always use this before get_node_info',
14
- 'Use validate_node_operation for examples',
15
- 'Perfect for understanding node structure'
16
- ]
17
- },
18
- full: {
19
- description: 'Returns a curated subset of node properties focusing on the most commonly-used fields. Essential properties are hand-picked for each node type and include: required fields, primary operations, authentication options, and the most frequent configuration patterns. NOTE: Examples have been removed to avoid confusion - use validate_node_operation to get working configurations with proper validation.',
20
- parameters: {
21
- nodeType: { type: 'string', description: 'Full node type with prefix, e.g., "nodes-base.slack", "nodes-base.httpRequest"', required: true }
22
- },
23
- returns: `Object containing:
24
- {
25
- "nodeType": "nodes-base.slack",
26
- "displayName": "Slack",
27
- "description": "Consume Slack API",
28
- "category": "output",
29
- "version": "2.3",
30
- "requiredProperties": [], // Most nodes have no strictly required fields
31
- "commonProperties": [
32
- {
33
- "name": "resource",
34
- "displayName": "Resource",
35
- "type": "options",
36
- "options": ["channel", "message", "user"],
37
- "default": "message"
38
- },
39
- {
40
- "name": "operation",
41
- "displayName": "Operation",
42
- "type": "options",
43
- "options": ["post", "update", "delete"],
44
- "default": "post"
45
- },
46
- // ... 10-20 most common properties
47
- ],
48
- "operations": [
49
- {"name": "Post", "description": "Post a message"},
50
- {"name": "Update", "description": "Update a message"}
51
- ],
52
- "metadata": {
53
- "totalProperties": 121,
54
- "isAITool": false,
55
- "hasCredentials": true
56
- }
57
- }`,
58
- examples: [
59
- 'get_node_essentials({nodeType: "nodes-base.httpRequest"}) - HTTP configuration basics',
60
- 'get_node_essentials({nodeType: "nodes-base.slack"}) - Slack messaging essentials',
61
- 'get_node_essentials({nodeType: "nodes-base.googleSheets"}) - Sheets operations',
62
- '// Workflow: search → essentials → validate',
63
- 'const nodes = search_nodes({query: "database"});',
64
- 'const mysql = get_node_essentials({nodeType: "nodes-base.mySql"});',
65
- 'validate_node_operation("nodes-base.mySql", {operation: "select"}, "minimal");'
66
- ],
67
- useCases: [
68
- 'Quickly understand node structure without information overload',
69
- 'Identify which properties are most important',
70
- 'Learn node basics before diving into advanced features',
71
- 'Build workflows faster with curated property sets'
72
- ],
73
- performance: '<10ms response time, ~5KB payload (vs 100KB+ for full schema)',
74
- bestPractices: [
75
- 'Always start with essentials, only use get_node_info if needed',
76
- 'Use validate_node_operation to get working configurations',
77
- 'Check authentication requirements first',
78
- 'Use search_node_properties if specific property not in essentials'
79
- ],
80
- pitfalls: [
81
- 'Advanced properties not included - use get_node_info for complete schema',
82
- 'Node-specific validators may require additional fields',
83
- 'Some nodes have 50+ properties, essentials shows only top 10-20'
84
- ],
85
- relatedTools: ['get_node_info for complete schema', 'search_node_properties for finding specific fields', 'validate_node_minimal to check configuration']
86
- }
87
- };
88
- //# sourceMappingURL=get-node-essentials.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"get-node-essentials.js","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/configuration/get-node-essentials.ts"],"names":[],"mappings":";;;AAEa,QAAA,oBAAoB,GAAsB;IACrD,IAAI,EAAE,qBAAqB;IAC3B,QAAQ,EAAE,eAAe;IACzB,UAAU,EAAE;QACV,WAAW,EAAE,0RAA0R;QACvS,aAAa,EAAE,CAAC,UAAU,CAAC;QAC3B,OAAO,EAAE,qDAAqD;QAC9D,WAAW,EAAE,sBAAsB;QACnC,IAAI,EAAE;YACJ,sCAAsC;YACtC,0CAA0C;YAC1C,0CAA0C;SAC3C;KACF;IACD,IAAI,EAAE;QACJ,WAAW,EAAE,gZAAgZ;QAC7Z,UAAU,EAAE;YACV,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gFAAgF,EAAE,QAAQ,EAAE,IAAI,EAAE;SAC5I;QACD,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCX;QACE,QAAQ,EAAE;YACR,uFAAuF;YACvF,kFAAkF;YAClF,gFAAgF;YAChF,6CAA6C;YAC7C,kDAAkD;YAClD,oEAAoE;YACpE,gFAAgF;SACjF;QACD,QAAQ,EAAE;YACR,gEAAgE;YAChE,8CAA8C;YAC9C,wDAAwD;YACxD,mDAAmD;SACpD;QACD,WAAW,EAAE,+DAA+D;QAC5E,aAAa,EAAE;YACb,gEAAgE;YAChE,2DAA2D;YAC3D,yCAAyC;YACzC,mEAAmE;SACpE;QACD,QAAQ,EAAE;YACR,0EAA0E;YAC1E,wDAAwD;YACxD,iEAAiE;SAClE;QACD,YAAY,EAAE,CAAC,mCAAmC,EAAE,oDAAoD,EAAE,8CAA8C,CAAC;KAC1J;CACF,CAAC"}
@@ -1,3 +0,0 @@
1
- import { ToolDocumentation } from '../types';
2
- export declare const getNodeInfoDoc: ToolDocumentation;
3
- //# sourceMappingURL=get-node-info.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"get-node-info.d.ts","sourceRoot":"","sources":["../../../../src/mcp/tool-docs/configuration/get-node-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,eAAO,MAAM,cAAc,EAAE,iBA+F5B,CAAC"}