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.
- package/dist/mcp/tool-docs/configuration/get-node.d.ts +3 -0
- package/dist/mcp/tool-docs/configuration/get-node.d.ts.map +1 -0
- package/dist/mcp/tool-docs/configuration/get-node.js +92 -0
- package/dist/mcp/tool-docs/configuration/get-node.js.map +1 -0
- package/dist/mcp/tool-docs/configuration/index.d.ts +1 -6
- package/dist/mcp/tool-docs/configuration/index.d.ts.map +1 -1
- package/dist/mcp/tool-docs/configuration/index.js +3 -13
- package/dist/mcp/tool-docs/configuration/index.js.map +1 -1
- package/dist/mcp/tool-docs/discovery/index.d.ts +0 -3
- package/dist/mcp/tool-docs/discovery/index.d.ts.map +1 -1
- package/dist/mcp/tool-docs/discovery/index.js +1 -7
- package/dist/mcp/tool-docs/discovery/index.js.map +1 -1
- package/dist/mcp/tool-docs/discovery/search-nodes.js +1 -1
- package/dist/mcp/tool-docs/discovery/search-nodes.js.map +1 -1
- package/dist/mcp/tool-docs/guides/ai-agents-guide.d.ts.map +1 -1
- package/dist/mcp/tool-docs/guides/ai-agents-guide.js +2 -3
- package/dist/mcp/tool-docs/guides/ai-agents-guide.js.map +1 -1
- package/dist/mcp/tool-docs/index.d.ts.map +1 -1
- package/dist/mcp/tool-docs/index.js +3 -23
- package/dist/mcp/tool-docs/index.js.map +1 -1
- package/dist/mcp/tool-docs/system/tools-documentation.js +1 -1
- package/dist/mcp/tool-docs/system/tools-documentation.js.map +1 -1
- package/dist/mcp/tool-docs/templates/get-template.js +4 -4
- package/dist/mcp/tool-docs/templates/get-template.js.map +1 -1
- package/dist/mcp/tool-docs/templates/index.d.ts +0 -4
- package/dist/mcp/tool-docs/templates/index.d.ts.map +1 -1
- package/dist/mcp/tool-docs/templates/index.js +1 -9
- package/dist/mcp/tool-docs/templates/index.js.map +1 -1
- package/dist/mcp/tool-docs/templates/search-templates.d.ts.map +1 -1
- package/dist/mcp/tool-docs/templates/search-templates.js +102 -48
- package/dist/mcp/tool-docs/templates/search-templates.js.map +1 -1
- package/dist/mcp/tool-docs/validation/index.d.ts +1 -4
- package/dist/mcp/tool-docs/validation/index.d.ts.map +1 -1
- package/dist/mcp/tool-docs/validation/index.js +3 -9
- package/dist/mcp/tool-docs/validation/index.js.map +1 -1
- package/dist/mcp/tool-docs/validation/validate-node.d.ts +3 -0
- package/dist/mcp/tool-docs/validation/validate-node.d.ts.map +1 -0
- package/dist/mcp/tool-docs/validation/validate-node.js +84 -0
- package/dist/mcp/tool-docs/validation/validate-node.js.map +1 -0
- package/dist/mcp/tool-docs/validation/validate-workflow.js +1 -1
- package/dist/mcp/tool-docs/validation/validate-workflow.js.map +1 -1
- package/dist/mcp/tool-docs/workflow_management/index.d.ts +1 -6
- package/dist/mcp/tool-docs/workflow_management/index.d.ts.map +1 -1
- package/dist/mcp/tool-docs/workflow_management/index.js +3 -13
- package/dist/mcp/tool-docs/workflow_management/index.js.map +1 -1
- package/dist/mcp/tool-docs/workflow_management/n8n-autofix-workflow.d.ts.map +1 -1
- package/dist/mcp/tool-docs/workflow_management/n8n-autofix-workflow.js +2 -3
- package/dist/mcp/tool-docs/workflow_management/n8n-autofix-workflow.js.map +1 -1
- package/dist/mcp/tool-docs/workflow_management/n8n-delete-workflow.js +1 -1
- package/dist/mcp/tool-docs/workflow_management/n8n-delete-workflow.js.map +1 -1
- package/dist/mcp/tool-docs/workflow_management/n8n-executions.d.ts +3 -0
- package/dist/mcp/tool-docs/workflow_management/n8n-executions.d.ts.map +1 -0
- package/dist/mcp/tool-docs/workflow_management/n8n-executions.js +86 -0
- package/dist/mcp/tool-docs/workflow_management/n8n-executions.js.map +1 -0
- package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow.d.ts.map +1 -1
- package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow.js +44 -25
- package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow.js.map +1 -1
- package/dist/mcp/tool-docs/workflow_management/n8n-list-workflows.js +1 -1
- package/dist/mcp/tool-docs/workflow_management/n8n-list-workflows.js.map +1 -1
- package/dist/mcp/tool-docs/workflow_management/n8n-trigger-webhook-workflow.js +8 -8
- package/dist/mcp/tool-docs/workflow_management/n8n-trigger-webhook-workflow.js.map +1 -1
- package/dist/mcp/tools-documentation.d.ts.map +1 -1
- package/dist/mcp/tools-documentation.js +39 -34
- package/dist/mcp/tools-documentation.js.map +1 -1
- package/dist/mcp/tools-n8n-friendly.d.ts.map +1 -1
- package/dist/mcp/tools-n8n-friendly.js +20 -62
- package/dist/mcp/tools-n8n-friendly.js.map +1 -1
- package/package.json +1 -1
- package/dist/mcp/tool-docs/configuration/get-node-as-tool-info.d.ts +0 -3
- package/dist/mcp/tool-docs/configuration/get-node-as-tool-info.d.ts.map +0 -1
- package/dist/mcp/tool-docs/configuration/get-node-as-tool-info.js +0 -73
- package/dist/mcp/tool-docs/configuration/get-node-as-tool-info.js.map +0 -1
- package/dist/mcp/tool-docs/configuration/get-node-documentation.d.ts +0 -3
- package/dist/mcp/tool-docs/configuration/get-node-documentation.d.ts.map +0 -1
- package/dist/mcp/tool-docs/configuration/get-node-documentation.js +0 -47
- package/dist/mcp/tool-docs/configuration/get-node-documentation.js.map +0 -1
- package/dist/mcp/tool-docs/configuration/get-node-essentials.d.ts +0 -3
- package/dist/mcp/tool-docs/configuration/get-node-essentials.d.ts.map +0 -1
- package/dist/mcp/tool-docs/configuration/get-node-essentials.js +0 -88
- package/dist/mcp/tool-docs/configuration/get-node-essentials.js.map +0 -1
- package/dist/mcp/tool-docs/configuration/get-node-info.d.ts +0 -3
- package/dist/mcp/tool-docs/configuration/get-node-info.d.ts.map +0 -1
- package/dist/mcp/tool-docs/configuration/get-node-info.js +0 -100
- package/dist/mcp/tool-docs/configuration/get-node-info.js.map +0 -1
- package/dist/mcp/tool-docs/configuration/get-property-dependencies.d.ts +0 -3
- package/dist/mcp/tool-docs/configuration/get-property-dependencies.d.ts.map +0 -1
- package/dist/mcp/tool-docs/configuration/get-property-dependencies.js +0 -81
- package/dist/mcp/tool-docs/configuration/get-property-dependencies.js.map +0 -1
- package/dist/mcp/tool-docs/configuration/search-node-properties.d.ts +0 -3
- package/dist/mcp/tool-docs/configuration/search-node-properties.d.ts.map +0 -1
- package/dist/mcp/tool-docs/configuration/search-node-properties.js +0 -99
- package/dist/mcp/tool-docs/configuration/search-node-properties.js.map +0 -1
- package/dist/mcp/tool-docs/discovery/get-database-statistics.d.ts +0 -3
- package/dist/mcp/tool-docs/discovery/get-database-statistics.d.ts.map +0 -1
- package/dist/mcp/tool-docs/discovery/get-database-statistics.js +0 -69
- package/dist/mcp/tool-docs/discovery/get-database-statistics.js.map +0 -1
- package/dist/mcp/tool-docs/discovery/list-ai-tools.d.ts +0 -3
- package/dist/mcp/tool-docs/discovery/list-ai-tools.d.ts.map +0 -1
- package/dist/mcp/tool-docs/discovery/list-ai-tools.js +0 -53
- package/dist/mcp/tool-docs/discovery/list-ai-tools.js.map +0 -1
- package/dist/mcp/tool-docs/discovery/list-nodes.d.ts +0 -3
- package/dist/mcp/tool-docs/discovery/list-nodes.d.ts.map +0 -1
- package/dist/mcp/tool-docs/discovery/list-nodes.js +0 -54
- package/dist/mcp/tool-docs/discovery/list-nodes.js.map +0 -1
- package/dist/mcp/tool-docs/templates/get-templates-for-task.d.ts +0 -3
- package/dist/mcp/tool-docs/templates/get-templates-for-task.d.ts.map +0 -1
- package/dist/mcp/tool-docs/templates/get-templates-for-task.js +0 -76
- package/dist/mcp/tool-docs/templates/get-templates-for-task.js.map +0 -1
- package/dist/mcp/tool-docs/templates/list-node-templates.d.ts +0 -3
- package/dist/mcp/tool-docs/templates/list-node-templates.d.ts.map +0 -1
- package/dist/mcp/tool-docs/templates/list-node-templates.js +0 -80
- package/dist/mcp/tool-docs/templates/list-node-templates.js.map +0 -1
- package/dist/mcp/tool-docs/templates/list-tasks.d.ts +0 -3
- package/dist/mcp/tool-docs/templates/list-tasks.d.ts.map +0 -1
- package/dist/mcp/tool-docs/templates/list-tasks.js +0 -48
- package/dist/mcp/tool-docs/templates/list-tasks.js.map +0 -1
- package/dist/mcp/tool-docs/templates/search-templates-by-metadata.d.ts +0 -3
- package/dist/mcp/tool-docs/templates/search-templates-by-metadata.d.ts.map +0 -1
- package/dist/mcp/tool-docs/templates/search-templates-by-metadata.js +0 -120
- package/dist/mcp/tool-docs/templates/search-templates-by-metadata.js.map +0 -1
- package/dist/mcp/tool-docs/validation/validate-node-minimal.d.ts +0 -3
- package/dist/mcp/tool-docs/validation/validate-node-minimal.d.ts.map +0 -1
- package/dist/mcp/tool-docs/validation/validate-node-minimal.js +0 -49
- package/dist/mcp/tool-docs/validation/validate-node-minimal.js.map +0 -1
- package/dist/mcp/tool-docs/validation/validate-node-operation.d.ts +0 -3
- package/dist/mcp/tool-docs/validation/validate-node-operation.d.ts.map +0 -1
- package/dist/mcp/tool-docs/validation/validate-node-operation.js +0 -100
- package/dist/mcp/tool-docs/validation/validate-node-operation.js.map +0 -1
- package/dist/mcp/tool-docs/validation/validate-workflow-connections.d.ts +0 -3
- package/dist/mcp/tool-docs/validation/validate-workflow-connections.d.ts.map +0 -1
- package/dist/mcp/tool-docs/validation/validate-workflow-connections.js +0 -58
- package/dist/mcp/tool-docs/validation/validate-workflow-connections.js.map +0 -1
- package/dist/mcp/tool-docs/validation/validate-workflow-expressions.d.ts +0 -3
- package/dist/mcp/tool-docs/validation/validate-workflow-expressions.d.ts.map +0 -1
- package/dist/mcp/tool-docs/validation/validate-workflow-expressions.js +0 -58
- package/dist/mcp/tool-docs/validation/validate-workflow-expressions.js.map +0 -1
- package/dist/mcp/tool-docs/workflow_management/n8n-delete-execution.d.ts +0 -3
- package/dist/mcp/tool-docs/workflow_management/n8n-delete-execution.d.ts.map +0 -1
- package/dist/mcp/tool-docs/workflow_management/n8n-delete-execution.js +0 -59
- package/dist/mcp/tool-docs/workflow_management/n8n-delete-execution.js.map +0 -1
- package/dist/mcp/tool-docs/workflow_management/n8n-get-execution.d.ts +0 -3
- package/dist/mcp/tool-docs/workflow_management/n8n-get-execution.d.ts.map +0 -1
- package/dist/mcp/tool-docs/workflow_management/n8n-get-execution.js +0 -270
- package/dist/mcp/tool-docs/workflow_management/n8n-get-execution.js.map +0 -1
- package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-details.d.ts +0 -3
- package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-details.d.ts.map +0 -1
- package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-details.js +0 -51
- package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-details.js.map +0 -1
- package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-minimal.d.ts +0 -3
- package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-minimal.d.ts.map +0 -1
- package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-minimal.js +0 -51
- package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-minimal.js.map +0 -1
- package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-structure.d.ts +0 -3
- package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-structure.d.ts.map +0 -1
- package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-structure.js +0 -51
- package/dist/mcp/tool-docs/workflow_management/n8n-get-workflow-structure.js.map +0 -1
- package/dist/mcp/tool-docs/workflow_management/n8n-list-executions.d.ts +0 -3
- package/dist/mcp/tool-docs/workflow_management/n8n-list-executions.d.ts.map +0 -1
- package/dist/mcp/tool-docs/workflow_management/n8n-list-executions.js +0 -86
- 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",
|
|
92
|
-
- get_node("nodes-base.slack",
|
|
93
|
-
- get_node("nodes-base.slack",
|
|
94
|
-
-
|
|
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
|
-
-
|
|
98
|
-
-
|
|
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 -
|
|
108
|
-
- detail='minimal':
|
|
109
|
-
-
|
|
110
|
-
-
|
|
111
|
-
- mode='versions':
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
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
|
-
-
|
|
126
|
-
-
|
|
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
|
-
-
|
|
131
|
-
-
|
|
132
|
-
-
|
|
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):
|
|
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":";;AAEA,oDA+DC;AAED,
|
|
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,
|
|
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
|
-
|
|
7
|
-
description: 'Validate n8n node.
|
|
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
|
-
|
|
29
|
-
description: 'Get node
|
|
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
|
-
|
|
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.
|
|
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: '
|
|
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"
|
|
101
|
-
topic: 'Optional string
|
|
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":";;;
|
|
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 +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 +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 +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 +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"}
|