@netpad/mcp-server 0.2.0 → 2.1.0
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/CHANGELOG.md +159 -0
- package/README.md +240 -103
- package/dist/index.js +6327 -850
- package/dist/index.js.map +1 -1
- package/package.json +8 -3
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,165 @@ All notable changes to this project will be documented in this file.
|
|
|
5
5
|
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
|
6
6
|
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
7
7
|
|
|
8
|
+
## [2.0.1] - 2026-01-16
|
|
9
|
+
|
|
10
|
+
### Added
|
|
11
|
+
|
|
12
|
+
#### AI-Assisted Workflow Configuration
|
|
13
|
+
- Added `aiAssist` metadata to workflow node config fields, enabling AI-powered configuration generation in the NetPad UI
|
|
14
|
+
- Supported fields with AI assistance:
|
|
15
|
+
- `mongodb-query.filter` - Generate MongoDB queries from natural language
|
|
16
|
+
- `transform.expression` - Generate JavaScript transform expressions
|
|
17
|
+
- `http-request.url` - Generate API URLs dynamically
|
|
18
|
+
- `http-request.headers` - Generate HTTP headers
|
|
19
|
+
- `http-request.body` - Generate request payloads
|
|
20
|
+
- `email-send.to` - Generate recipient expressions
|
|
21
|
+
- `email-send.subject` - Generate email subjects
|
|
22
|
+
- `email-send.body` - Generate email content
|
|
23
|
+
- `ai-generate.prompt` - Generate AI prompts
|
|
24
|
+
- `ai-classify.categories` - Generate classification categories
|
|
25
|
+
- `ai-classify.instructions` - Generate classification instructions
|
|
26
|
+
- `code.code` - Generate JavaScript code
|
|
27
|
+
|
|
28
|
+
#### New Node Type
|
|
29
|
+
- Added `code` node type to `custom` category for executing custom JavaScript code
|
|
30
|
+
|
|
31
|
+
### Changed
|
|
32
|
+
- Added `AIAssistConfig` and `NodeConfigFieldDefinition` type exports for external type checking
|
|
33
|
+
- Updated README with AI-assisted configuration documentation
|
|
34
|
+
|
|
35
|
+
---
|
|
36
|
+
|
|
37
|
+
## [2.0.0] - 2026-01-15
|
|
38
|
+
|
|
39
|
+
### Added
|
|
40
|
+
|
|
41
|
+
This major release expands the MCP server from 22 tools to **75 tools**, adding comprehensive support for applications, workflows, marketplace, conversational forms, and data browsing.
|
|
42
|
+
|
|
43
|
+
#### Application Management Tools (7 new tools)
|
|
44
|
+
- `list_application_templates` - List available application templates (contact-app, support-portal, event-registration, etc.)
|
|
45
|
+
- `get_application_template` - Get detailed template information with forms, workflows, and contracts
|
|
46
|
+
- `create_application` - Generate code to create a new NetPad application
|
|
47
|
+
- `generate_application_contract` - Generate API contracts defining inputs, outputs, and side effects
|
|
48
|
+
- `generate_application_release` - Generate release configuration with semantic versioning
|
|
49
|
+
- `generate_export_bundle` - Generate export bundle structure for sharing
|
|
50
|
+
- `preview_application_config` - Preview application configuration before creation
|
|
51
|
+
|
|
52
|
+
#### Marketplace & npm Integration Tools (8 new tools)
|
|
53
|
+
- `list_marketplace_categories` - List marketplace categories (business, events, feedback, etc.)
|
|
54
|
+
- `search_marketplace` - Search marketplace for applications with filters
|
|
55
|
+
- `publish_to_marketplace` - Generate code to publish an application to marketplace
|
|
56
|
+
- `install_from_marketplace` - Generate code to install from marketplace
|
|
57
|
+
- `generate_npm_package` - Generate npm package.json with netpad configuration
|
|
58
|
+
- `sync_to_npm` - Generate code to sync application to npm registry
|
|
59
|
+
- `import_from_npm` - Generate code to import application from npm
|
|
60
|
+
- `validate_npm_package_name` - Validate npm package name format
|
|
61
|
+
|
|
62
|
+
#### Workflow Automation Tools (10 new tools)
|
|
63
|
+
- `list_workflow_node_types` - List 25+ workflow node types across categories
|
|
64
|
+
- `list_workflow_templates` - List workflow templates (form-to-email, lead-qualification, etc.)
|
|
65
|
+
- `get_workflow_template` - Get detailed workflow template configuration
|
|
66
|
+
- `create_workflow` - Generate code to create a workflow
|
|
67
|
+
- `add_workflow_node` - Generate code to add nodes to workflow
|
|
68
|
+
- `connect_workflow_nodes` - Generate code to connect workflow nodes
|
|
69
|
+
- `configure_workflow_trigger` - Generate trigger configuration
|
|
70
|
+
- `test_workflow` - Generate workflow test code
|
|
71
|
+
- `get_workflow_execution_history` - Generate execution history retrieval code
|
|
72
|
+
- `preview_workflow_config` - Preview workflow configuration
|
|
73
|
+
|
|
74
|
+
#### Conversational & Search Form Tools (11 new tools)
|
|
75
|
+
- `list_conversational_templates` - List AI-powered conversational form templates
|
|
76
|
+
- `get_conversational_template` - Get template details (it-helpdesk, customer-feedback, etc.)
|
|
77
|
+
- `create_conversational_form` - Create conversational forms with topics, personas, and extraction
|
|
78
|
+
- `configure_rag_settings` - Configure RAG (Retrieval-Augmented Generation) for forms
|
|
79
|
+
- `add_rag_document` - Generate code to upload documents for RAG
|
|
80
|
+
- `list_search_operators` - List search operators by field type
|
|
81
|
+
- `create_search_form` - Create MongoDB search forms with configurable operators
|
|
82
|
+
- `configure_search_operators` - Configure operators for specific fields
|
|
83
|
+
- `test_conversational_form` - Generate conversational form test code
|
|
84
|
+
- `test_search_form` - Generate search form test code
|
|
85
|
+
|
|
86
|
+
#### Enhanced Template Tools (5 new tools)
|
|
87
|
+
- `list_template_categories` - List 10 template categories
|
|
88
|
+
- `list_form_templates` - List 24 pre-built form templates
|
|
89
|
+
- `get_form_template` - Get detailed template with all fields and configuration
|
|
90
|
+
- `create_form_from_template` - Create form from template with customizations
|
|
91
|
+
- `preview_template_config` - Preview template configuration
|
|
92
|
+
|
|
93
|
+
#### Data Browser & Connection Tools (12 new tools)
|
|
94
|
+
- `list_connection_types` - List supported MongoDB connection types
|
|
95
|
+
- `generate_connection_config` - Generate connection vault configuration
|
|
96
|
+
- `list_query_templates` - List pre-built query templates
|
|
97
|
+
- `get_query_template` - Get specific query template
|
|
98
|
+
- `generate_data_browser_query` - Generate find/aggregate/distinct/count queries
|
|
99
|
+
- `generate_aggregation_pipeline` - Generate complex aggregation pipelines
|
|
100
|
+
- `generate_index_recommendations` - Get index suggestions based on query patterns
|
|
101
|
+
- `generate_schema_analysis` - Generate schema inference code
|
|
102
|
+
- `generate_data_export` - Generate data export code (JSON/CSV/XLSX)
|
|
103
|
+
- `generate_connection_test` - Generate connection test code
|
|
104
|
+
- `generate_list_databases` - Generate database listing code
|
|
105
|
+
- `generate_list_collections` - Generate collection listing code
|
|
106
|
+
|
|
107
|
+
#### New Resources (9 new resources)
|
|
108
|
+
- `netpad://reference/application-templates` - Application templates reference
|
|
109
|
+
- `netpad://reference/workflow-nodes` - Workflow node types reference
|
|
110
|
+
- `netpad://reference/workflow-templates` - Workflow templates reference
|
|
111
|
+
- `netpad://reference/conversational-templates` - Conversational form templates
|
|
112
|
+
- `netpad://reference/search-operators` - Search operators by field type
|
|
113
|
+
- `netpad://reference/form-templates` - 24 form templates
|
|
114
|
+
- `netpad://reference/template-categories` - Template categories
|
|
115
|
+
- `netpad://reference/connection-types` - MongoDB connection types
|
|
116
|
+
- `netpad://reference/query-templates` - Query templates
|
|
117
|
+
|
|
118
|
+
#### Form Templates (24 templates)
|
|
119
|
+
Added comprehensive form template library across 10 categories:
|
|
120
|
+
- **Business**: Contact Form, Lead Capture, Quote Request, Newsletter Signup
|
|
121
|
+
- **Events**: Event Registration, RSVP, Volunteer Signup, Webinar Registration
|
|
122
|
+
- **Feedback**: Customer Satisfaction, NPS Survey, Product Feedback, General Feedback
|
|
123
|
+
- **Support**: Support Ticket, Appointment Booking
|
|
124
|
+
- **E-commerce**: Order Form, Return Request
|
|
125
|
+
- **Healthcare**: Patient Intake (encrypted), Health Screening
|
|
126
|
+
- **HR**: Job Application
|
|
127
|
+
- **Finance**: Expense Report
|
|
128
|
+
- **Education**: Course Enrollment, Scholarship Application
|
|
129
|
+
- **Real Estate**: Property Inquiry, Rental Application
|
|
130
|
+
|
|
131
|
+
#### Conversational Form Templates (4 templates)
|
|
132
|
+
- `it-helpdesk` - IT support ticket collection through conversation
|
|
133
|
+
- `customer-feedback` - Customer experience feedback collection
|
|
134
|
+
- `lead-qualification` - Sales lead qualification with scoring
|
|
135
|
+
- `patient-intake` - Healthcare patient information gathering
|
|
136
|
+
|
|
137
|
+
#### Workflow Templates (5 templates)
|
|
138
|
+
- `form-to-email` - Send email notifications on form submission
|
|
139
|
+
- `form-to-database` - Save submissions to MongoDB
|
|
140
|
+
- `lead-qualification` - Qualify and route leads based on criteria
|
|
141
|
+
- `webhook-to-database` - Process incoming webhooks to database
|
|
142
|
+
- `scheduled-report` - Generate and send scheduled reports
|
|
143
|
+
|
|
144
|
+
### Changed
|
|
145
|
+
|
|
146
|
+
- Package version bumped from 0.1.0 to 2.0.0
|
|
147
|
+
- Description updated to reflect 75 tools
|
|
148
|
+
- Added keywords for new features (workflow, applications, marketplace, etc.)
|
|
149
|
+
|
|
150
|
+
### Technical Details
|
|
151
|
+
|
|
152
|
+
- 6 new tool modules added:
|
|
153
|
+
- `application-management-tools.ts` - Application lifecycle management
|
|
154
|
+
- `marketplace-tools.ts` - Marketplace and npm integration
|
|
155
|
+
- `workflow-tools.ts` - Workflow automation
|
|
156
|
+
- `conversational-search-tools.ts` - Conversational and search forms
|
|
157
|
+
- `template-tools.ts` - Enhanced form templates
|
|
158
|
+
- `data-browser-tools.ts` - MongoDB data browser
|
|
159
|
+
- Total tool count: 75 tools
|
|
160
|
+
- Total resources: 16 resources
|
|
161
|
+
- Built with TypeScript and tsup
|
|
162
|
+
- Uses @modelcontextprotocol/sdk v1.0.0
|
|
163
|
+
- Requires Node.js 18+
|
|
164
|
+
|
|
165
|
+
---
|
|
166
|
+
|
|
8
167
|
## [0.1.0] - 2025-01-03
|
|
9
168
|
|
|
10
169
|
### Added
|
package/README.md
CHANGED
|
@@ -1,6 +1,16 @@
|
|
|
1
1
|
# @netpad/mcp-server
|
|
2
2
|
|
|
3
|
-
An MCP (Model Context Protocol) server
|
|
3
|
+
An MCP (Model Context Protocol) server for AI-assisted NetPad application development. This comprehensive toolkit provides **75 tools** for building forms, workflows, applications, and data-driven experiences with the NetPad platform.
|
|
4
|
+
|
|
5
|
+
## What's New in v2.0.0
|
|
6
|
+
|
|
7
|
+
- **Application Management**: Create, release, and manage NetPad applications with contracts
|
|
8
|
+
- **Marketplace & npm Integration**: Publish to marketplace and sync with npm registry
|
|
9
|
+
- **Workflow Automation**: 25+ node types for building automation workflows
|
|
10
|
+
- **Conversational Forms**: AI-powered data collection with RAG support
|
|
11
|
+
- **Search Forms**: MongoDB-powered search interfaces with configurable operators
|
|
12
|
+
- **25+ Form Templates**: Pre-built templates across 10 categories
|
|
13
|
+
- **Data Browser**: MongoDB connection management and query tools
|
|
4
14
|
|
|
5
15
|
## Features
|
|
6
16
|
|
|
@@ -8,20 +18,42 @@ An MCP (Model Context Protocol) server that helps developers build form applicat
|
|
|
8
18
|
- **Form Generation**: Generate complete form configurations from natural language descriptions
|
|
9
19
|
- **Field Configuration**: Create individual field configs with validation, conditional logic, and computed fields
|
|
10
20
|
- **Multi-Page Wizards**: Generate step-by-step form configurations
|
|
21
|
+
- **25+ Templates**: Pre-built templates for business, events, feedback, support, healthcare, and more
|
|
11
22
|
- **Validation**: Configure and validate form schemas
|
|
12
23
|
|
|
13
24
|
### Application Development
|
|
25
|
+
- **Application Management**: Create and manage NetPad applications with releases and contracts
|
|
26
|
+
- **Marketplace Publishing**: Publish applications to the NetPad marketplace
|
|
27
|
+
- **npm Integration**: Sync applications to npm for distribution
|
|
14
28
|
- **Next.js Scaffolding**: Generate complete Next.js applications with forms
|
|
15
|
-
- **Workflow Integration**: Connect forms to NetPad workflows for processing
|
|
16
|
-
- **MongoDB Queries**: Generate queries for form submission data
|
|
17
29
|
- **API Routes**: Generate Next.js API routes for form operations
|
|
18
30
|
|
|
19
|
-
###
|
|
20
|
-
- **
|
|
21
|
-
- **
|
|
22
|
-
- **
|
|
23
|
-
- **
|
|
24
|
-
- **
|
|
31
|
+
### Workflow Automation
|
|
32
|
+
- **Visual Workflows**: Build automation with 25+ node types
|
|
33
|
+
- **Triggers**: Form submission, webhook, schedule, manual, API
|
|
34
|
+
- **Logic Nodes**: Conditional routing, switch, filter, loop
|
|
35
|
+
- **Data Nodes**: Transform, code execution, variable management
|
|
36
|
+
- **Integrations**: MongoDB, HTTP, Email, Slack, Google Sheets
|
|
37
|
+
- **AI-Assisted Configuration**: Many node fields support AI generation (transforms, code, prompts, HTTP requests)
|
|
38
|
+
|
|
39
|
+
### Conversational Forms & RAG
|
|
40
|
+
- **AI-Powered Forms**: Natural language data collection
|
|
41
|
+
- **Topic Management**: Define conversation topics with priority and depth
|
|
42
|
+
- **RAG Integration**: Knowledge-guided conversations with document retrieval
|
|
43
|
+
- **Persona Configuration**: Professional, friendly, casual, or empathetic styles
|
|
44
|
+
|
|
45
|
+
### Search Forms
|
|
46
|
+
- **MongoDB Search**: Build search interfaces for your data
|
|
47
|
+
- **Configurable Operators**: equals, contains, between, regex, and more
|
|
48
|
+
- **Result Views**: Table, cards, or list layouts
|
|
49
|
+
- **Smart Dropdowns**: Distinct values with counts
|
|
50
|
+
|
|
51
|
+
### Data Browser
|
|
52
|
+
- **Connection Management**: Atlas, self-hosted, and Atlas Data API support
|
|
53
|
+
- **Query Templates**: Pre-built queries for common operations
|
|
54
|
+
- **Aggregation Pipelines**: Complex data analysis
|
|
55
|
+
- **Schema Analysis**: Infer collection schemas
|
|
56
|
+
- **Index Recommendations**: Optimize query performance
|
|
25
57
|
|
|
26
58
|
## Installation
|
|
27
59
|
|
|
@@ -42,7 +74,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
|
|
|
42
74
|
```json
|
|
43
75
|
{
|
|
44
76
|
"mcpServers": {
|
|
45
|
-
"netpad
|
|
77
|
+
"netpad": {
|
|
46
78
|
"command": "npx",
|
|
47
79
|
"args": ["@netpad/mcp-server"]
|
|
48
80
|
}
|
|
@@ -57,7 +89,7 @@ Add to `~/.cursor/mcp.json`:
|
|
|
57
89
|
```json
|
|
58
90
|
{
|
|
59
91
|
"mcpServers": {
|
|
60
|
-
"netpad
|
|
92
|
+
"netpad": {
|
|
61
93
|
"command": "npx",
|
|
62
94
|
"args": ["@netpad/mcp-server"]
|
|
63
95
|
}
|
|
@@ -65,9 +97,9 @@ Add to `~/.cursor/mcp.json`:
|
|
|
65
97
|
}
|
|
66
98
|
```
|
|
67
99
|
|
|
68
|
-
## Available Tools (
|
|
100
|
+
## Available Tools (75 total)
|
|
69
101
|
|
|
70
|
-
### Form Building Tools
|
|
102
|
+
### Form Building Tools (6)
|
|
71
103
|
|
|
72
104
|
| Tool | Description |
|
|
73
105
|
|------|-------------|
|
|
@@ -78,17 +110,89 @@ Add to `~/.cursor/mcp.json`:
|
|
|
78
110
|
| `generate_multipage_config` | Generate multi-page wizard configuration |
|
|
79
111
|
| `validate_form_config` | Validate a form configuration |
|
|
80
112
|
|
|
81
|
-
### Application
|
|
113
|
+
### Application Management Tools (7)
|
|
82
114
|
|
|
83
115
|
| Tool | Description |
|
|
84
116
|
|------|-------------|
|
|
85
|
-
| `
|
|
86
|
-
| `
|
|
87
|
-
| `
|
|
88
|
-
| `
|
|
89
|
-
| `
|
|
117
|
+
| `list_application_templates` | List available application templates |
|
|
118
|
+
| `get_application_template` | Get detailed template information |
|
|
119
|
+
| `create_application` | Generate code to create a new application |
|
|
120
|
+
| `generate_application_contract` | Generate API contract for an application |
|
|
121
|
+
| `generate_application_release` | Generate release configuration |
|
|
122
|
+
| `generate_export_bundle` | Generate export bundle structure |
|
|
123
|
+
| `preview_application_config` | Preview application configuration |
|
|
124
|
+
|
|
125
|
+
### Marketplace & npm Tools (8)
|
|
126
|
+
|
|
127
|
+
| Tool | Description |
|
|
128
|
+
|------|-------------|
|
|
129
|
+
| `list_marketplace_categories` | List marketplace categories |
|
|
130
|
+
| `search_marketplace` | Search marketplace for applications |
|
|
131
|
+
| `publish_to_marketplace` | Generate code to publish an application |
|
|
132
|
+
| `install_from_marketplace` | Generate code to install from marketplace |
|
|
133
|
+
| `generate_npm_package` | Generate npm package.json for application |
|
|
134
|
+
| `sync_to_npm` | Generate code to sync application to npm |
|
|
135
|
+
| `import_from_npm` | Generate code to import from npm |
|
|
136
|
+
| `validate_npm_package_name` | Validate npm package name |
|
|
137
|
+
|
|
138
|
+
### Workflow Tools (10)
|
|
139
|
+
|
|
140
|
+
| Tool | Description |
|
|
141
|
+
|------|-------------|
|
|
142
|
+
| `list_workflow_node_types` | List available workflow node types |
|
|
143
|
+
| `list_workflow_templates` | List workflow templates |
|
|
144
|
+
| `get_workflow_template` | Get detailed workflow template |
|
|
145
|
+
| `create_workflow` | Generate code to create a workflow |
|
|
146
|
+
| `add_workflow_node` | Generate code to add a node |
|
|
147
|
+
| `connect_workflow_nodes` | Generate code to connect nodes |
|
|
148
|
+
| `configure_workflow_trigger` | Generate trigger configuration |
|
|
149
|
+
| `test_workflow` | Generate workflow test code |
|
|
150
|
+
| `get_workflow_execution_history` | Generate execution history code |
|
|
151
|
+
| `preview_workflow_config` | Preview workflow configuration |
|
|
152
|
+
|
|
153
|
+
### Conversational & Search Form Tools (11)
|
|
154
|
+
|
|
155
|
+
| Tool | Description |
|
|
156
|
+
|------|-------------|
|
|
157
|
+
| `list_conversational_templates` | List conversational form templates |
|
|
158
|
+
| `get_conversational_template` | Get template details |
|
|
159
|
+
| `create_conversational_form` | Create AI-powered conversational form |
|
|
160
|
+
| `configure_rag_settings` | Configure RAG for a form |
|
|
161
|
+
| `add_rag_document` | Upload document for RAG |
|
|
162
|
+
| `list_search_operators` | List available search operators |
|
|
163
|
+
| `create_search_form` | Create MongoDB search form |
|
|
164
|
+
| `configure_search_operators` | Configure field operators |
|
|
165
|
+
| `test_conversational_form` | Generate test code |
|
|
166
|
+
| `test_search_form` | Generate search test code |
|
|
167
|
+
|
|
168
|
+
### Template Tools (5)
|
|
90
169
|
|
|
91
|
-
|
|
170
|
+
| Tool | Description |
|
|
171
|
+
|------|-------------|
|
|
172
|
+
| `list_template_categories` | List all template categories |
|
|
173
|
+
| `list_form_templates` | List 25+ form templates |
|
|
174
|
+
| `get_form_template` | Get detailed template |
|
|
175
|
+
| `create_form_from_template` | Create form from template |
|
|
176
|
+
| `preview_template_config` | Preview template configuration |
|
|
177
|
+
|
|
178
|
+
### Data Browser Tools (12)
|
|
179
|
+
|
|
180
|
+
| Tool | Description |
|
|
181
|
+
|------|-------------|
|
|
182
|
+
| `list_connection_types` | List supported connection types |
|
|
183
|
+
| `generate_connection_config` | Generate connection configuration |
|
|
184
|
+
| `list_query_templates` | List query templates |
|
|
185
|
+
| `get_query_template` | Get specific query template |
|
|
186
|
+
| `generate_data_browser_query` | Generate MongoDB queries |
|
|
187
|
+
| `generate_aggregation_pipeline` | Generate aggregation pipelines |
|
|
188
|
+
| `generate_index_recommendations` | Get index suggestions |
|
|
189
|
+
| `generate_schema_analysis` | Generate schema analysis code |
|
|
190
|
+
| `generate_data_export` | Generate data export code |
|
|
191
|
+
| `generate_connection_test` | Generate connection test code |
|
|
192
|
+
| `generate_list_databases` | Generate list databases code |
|
|
193
|
+
| `generate_list_collections` | Generate list collections code |
|
|
194
|
+
|
|
195
|
+
### Reference Tools (5)
|
|
92
196
|
|
|
93
197
|
| Tool | Description |
|
|
94
198
|
|------|-------------|
|
|
@@ -98,117 +202,150 @@ Add to `~/.cursor/mcp.json`:
|
|
|
98
202
|
| `list_validation_options` | List validation rule options |
|
|
99
203
|
| `list_theme_options` | List theme customization options |
|
|
100
204
|
|
|
101
|
-
### Helper Tools
|
|
205
|
+
### Helper Tools (11)
|
|
102
206
|
|
|
103
207
|
| Tool | Description |
|
|
104
208
|
|------|-------------|
|
|
105
|
-
| `
|
|
106
|
-
| `
|
|
107
|
-
| `
|
|
209
|
+
| `scaffold_nextjs_app` | Generate a complete Next.js application |
|
|
210
|
+
| `generate_workflow_integration` | Generate workflow integration code |
|
|
211
|
+
| `generate_mongodb_query` | Generate MongoDB queries for form data |
|
|
212
|
+
| `generate_api_route` | Generate Next.js API routes |
|
|
213
|
+
| `generate_react_code` | Generate React components |
|
|
214
|
+
| `get_use_case_template` | Get pre-built use case templates |
|
|
215
|
+
| `suggest_form_fields` | Get field recommendations |
|
|
216
|
+
| `get_best_practices` | Get best practices guides |
|
|
108
217
|
| `debug_form_config` | Analyze form configuration for issues |
|
|
109
|
-
| `explain_error` | Explain error codes
|
|
218
|
+
| `explain_error` | Explain error codes with solutions |
|
|
110
219
|
| `get_documentation` | Access documentation topics |
|
|
111
220
|
|
|
112
|
-
##
|
|
221
|
+
## Form Templates (24)
|
|
113
222
|
|
|
114
|
-
|
|
223
|
+
Pre-built templates across 10 categories:
|
|
115
224
|
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
225
|
+
| Category | Templates |
|
|
226
|
+
|----------|-----------|
|
|
227
|
+
| **Business** | Contact Form, Lead Capture, Quote Request, Newsletter Signup |
|
|
228
|
+
| **Events** | Event Registration, RSVP, Volunteer Signup, Webinar Registration |
|
|
229
|
+
| **Feedback** | Customer Satisfaction, NPS Survey, Product Feedback, General Feedback |
|
|
230
|
+
| **Support** | Support Ticket, Appointment Booking |
|
|
231
|
+
| **E-commerce** | Order Form, Return Request |
|
|
232
|
+
| **Healthcare** | Patient Intake, Health Screening |
|
|
233
|
+
| **HR** | Job Application |
|
|
234
|
+
| **Finance** | Expense Report |
|
|
235
|
+
| **Education** | Course Enrollment, Scholarship Application |
|
|
236
|
+
| **Real Estate** | Property Inquiry, Rental Application |
|
|
126
237
|
|
|
127
|
-
|
|
238
|
+
## Conversational Form Templates
|
|
128
239
|
|
|
129
|
-
|
|
130
|
-
User: Scaffold a Next.js app for this contact form
|
|
131
|
-
|
|
132
|
-
Claude: [Uses scaffold_nextjs_app tool]
|
|
133
|
-
Here's your complete Next.js application:
|
|
134
|
-
- package.json with all dependencies
|
|
135
|
-
- Form page component with submission handling
|
|
136
|
-
- Layout with Material-UI theming
|
|
137
|
-
- Environment variable template
|
|
138
|
-
- Setup instructions
|
|
139
|
-
```
|
|
240
|
+
AI-powered data collection templates:
|
|
140
241
|
|
|
141
|
-
|
|
242
|
+
| Template | Use Case |
|
|
243
|
+
|----------|----------|
|
|
244
|
+
| `it-helpdesk` | IT support ticket collection |
|
|
245
|
+
| `customer-feedback` | Customer experience feedback |
|
|
246
|
+
| `lead-qualification` | Sales lead qualification |
|
|
247
|
+
| `patient-intake` | Healthcare patient information |
|
|
142
248
|
|
|
143
|
-
|
|
144
|
-
User: I want to save form submissions to MongoDB and send a notification email
|
|
145
|
-
|
|
146
|
-
Claude: [Uses generate_workflow_integration with 'full_pipeline' type]
|
|
147
|
-
Here's the integration code:
|
|
148
|
-
- NetPad client setup
|
|
149
|
-
- Form submission handler
|
|
150
|
-
- Workflow trigger with payload
|
|
151
|
-
- Status polling and error handling
|
|
152
|
-
- Example workflow configuration
|
|
153
|
-
```
|
|
249
|
+
## Workflow Templates
|
|
154
250
|
|
|
155
|
-
|
|
251
|
+
Pre-built automation patterns:
|
|
156
252
|
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
**Solutions:**
|
|
166
|
-
1. Verify your API key is correct in environment variables
|
|
167
|
-
2. Check that the key starts with np_live_ or np_test_
|
|
168
|
-
3. Ensure the key has not been revoked in the NetPad dashboard
|
|
169
|
-
4. For test environments, use np_test_ prefixed keys
|
|
170
|
-
```
|
|
171
|
-
|
|
172
|
-
### Get Field Suggestions
|
|
173
|
-
|
|
174
|
-
```
|
|
175
|
-
User: What fields should I include for a healthcare appointment form?
|
|
176
|
-
|
|
177
|
-
Claude: [Uses suggest_form_fields with industry: 'healthcare']
|
|
178
|
-
Recommended fields:
|
|
179
|
-
- Patient name, email, phone
|
|
180
|
-
- Date of birth, insurance info
|
|
181
|
-
- Preferred appointment date/time
|
|
182
|
-
- Reason for visit
|
|
183
|
-
|
|
184
|
-
Tips:
|
|
185
|
-
- Ensure HIPAA compliance for health data
|
|
186
|
-
- Add clear consent checkboxes for data usage
|
|
187
|
-
```
|
|
253
|
+
| Template | Description |
|
|
254
|
+
|----------|-------------|
|
|
255
|
+
| `form-to-email` | Send email on form submission |
|
|
256
|
+
| `form-to-database` | Save submissions to MongoDB |
|
|
257
|
+
| `lead-qualification` | Qualify and route leads |
|
|
258
|
+
| `webhook-to-database` | Process webhooks to database |
|
|
259
|
+
| `scheduled-report` | Generate scheduled reports |
|
|
188
260
|
|
|
189
|
-
##
|
|
261
|
+
## AI-Assisted Node Configuration
|
|
190
262
|
|
|
191
|
-
|
|
263
|
+
Many workflow node fields support AI-powered configuration generation. The `aiAssist` metadata on config fields indicates which fields can use AI generation in the NetPad UI:
|
|
192
264
|
|
|
193
|
-
|
|
|
194
|
-
|
|
195
|
-
| `
|
|
196
|
-
| `
|
|
197
|
-
| `
|
|
198
|
-
| `
|
|
199
|
-
| `
|
|
265
|
+
| Node Type | Field | AI Assistance |
|
|
266
|
+
|-----------|-------|---------------|
|
|
267
|
+
| `mongodb-query` | filter | Generate MongoDB queries from natural language |
|
|
268
|
+
| `transform` | expression | Generate JavaScript transforms |
|
|
269
|
+
| `http-request` | url, headers, body | Generate URLs, headers, and request bodies |
|
|
270
|
+
| `email-send` | to, subject, body | Generate email content |
|
|
271
|
+
| `ai-generate` | prompt | Generate AI prompts |
|
|
272
|
+
| `ai-classify` | categories, instructions | Generate classification rules |
|
|
273
|
+
| `code` | code | Generate JavaScript code |
|
|
200
274
|
|
|
201
275
|
## Resources
|
|
202
276
|
|
|
203
277
|
The server exposes documentation as MCP resources:
|
|
204
278
|
|
|
279
|
+
### Documentation
|
|
205
280
|
- `netpad://docs/readme` - Main documentation
|
|
206
281
|
- `netpad://docs/architecture` - Architecture guide
|
|
207
282
|
- `netpad://docs/quick-start` - Quick start guide
|
|
208
283
|
- `netpad://docs/examples` - Code examples
|
|
284
|
+
|
|
285
|
+
### References
|
|
209
286
|
- `netpad://reference/field-types` - Field type reference
|
|
210
287
|
- `netpad://reference/operators` - Operator reference
|
|
211
288
|
- `netpad://reference/formulas` - Formula function reference
|
|
289
|
+
- `netpad://reference/application-templates` - Application templates
|
|
290
|
+
- `netpad://reference/workflow-nodes` - Workflow node types
|
|
291
|
+
- `netpad://reference/workflow-templates` - Workflow templates
|
|
292
|
+
- `netpad://reference/conversational-templates` - Conversational form templates
|
|
293
|
+
- `netpad://reference/search-operators` - Search operators
|
|
294
|
+
- `netpad://reference/form-templates` - Form templates
|
|
295
|
+
- `netpad://reference/template-categories` - Template categories
|
|
296
|
+
- `netpad://reference/connection-types` - MongoDB connection types
|
|
297
|
+
- `netpad://reference/query-templates` - Query templates
|
|
298
|
+
|
|
299
|
+
## Example Interactions
|
|
300
|
+
|
|
301
|
+
### Create an Application
|
|
302
|
+
|
|
303
|
+
```
|
|
304
|
+
User: Create a customer feedback application with a survey form and email workflow
|
|
305
|
+
|
|
306
|
+
Claude: [Uses create_application, create_form_from_template, create_workflow tools]
|
|
307
|
+
Here's your complete application:
|
|
308
|
+
- Customer Feedback Application with NPS survey
|
|
309
|
+
- Workflow to send thank-you emails
|
|
310
|
+
- MongoDB storage for responses
|
|
311
|
+
```
|
|
312
|
+
|
|
313
|
+
### Build a Search Interface
|
|
314
|
+
|
|
315
|
+
```
|
|
316
|
+
User: I need a search form for my products collection
|
|
317
|
+
|
|
318
|
+
Claude: [Uses create_search_form tool]
|
|
319
|
+
Here's your search form with:
|
|
320
|
+
- Text search on name and description
|
|
321
|
+
- Category dropdown with distinct values
|
|
322
|
+
- Price range filter
|
|
323
|
+
- Results in table layout with pagination
|
|
324
|
+
```
|
|
325
|
+
|
|
326
|
+
### Create a Conversational Form
|
|
327
|
+
|
|
328
|
+
```
|
|
329
|
+
User: I want an AI-powered IT helpdesk intake form
|
|
330
|
+
|
|
331
|
+
Claude: [Uses create_conversational_form with it-helpdesk template]
|
|
332
|
+
Here's your conversational form:
|
|
333
|
+
- Professional AI persona
|
|
334
|
+
- Topics: Issue type, urgency, description, environment
|
|
335
|
+
- Automatic data extraction to structured format
|
|
336
|
+
```
|
|
337
|
+
|
|
338
|
+
### Generate MongoDB Queries
|
|
339
|
+
|
|
340
|
+
```
|
|
341
|
+
User: I need to analyze form submissions by month
|
|
342
|
+
|
|
343
|
+
Claude: [Uses generate_aggregation_pipeline tool]
|
|
344
|
+
Here's the aggregation pipeline:
|
|
345
|
+
- Groups submissions by year/month
|
|
346
|
+
- Counts per period
|
|
347
|
+
- Sorted chronologically
|
|
348
|
+
```
|
|
212
349
|
|
|
213
350
|
## Development
|
|
214
351
|
|
|
@@ -244,7 +381,7 @@ Or test via command line:
|
|
|
244
381
|
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node dist/index.js
|
|
245
382
|
|
|
246
383
|
# Call a tool
|
|
247
|
-
echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"
|
|
384
|
+
echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_form_templates","arguments":{}}}' | node dist/index.js
|
|
248
385
|
```
|
|
249
386
|
|
|
250
387
|
## Related Packages
|