@netpad/mcp-server 0.1.0 → 2.0.0

package/CHANGELOG.md

@@ -5,6 +5,136 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.0.0] - 2026-01-15
+
+### Added
+
+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.
+
+#### Application Management Tools (7 new tools)
+- `list_application_templates` - List available application templates (contact-app, support-portal, event-registration, etc.)
+- `get_application_template` - Get detailed template information with forms, workflows, and contracts
+- `create_application` - Generate code to create a new NetPad application
+- `generate_application_contract` - Generate API contracts defining inputs, outputs, and side effects
+- `generate_application_release` - Generate release configuration with semantic versioning
+- `generate_export_bundle` - Generate export bundle structure for sharing
+- `preview_application_config` - Preview application configuration before creation
+
+#### Marketplace & npm Integration Tools (8 new tools)
+- `list_marketplace_categories` - List marketplace categories (business, events, feedback, etc.)
+- `search_marketplace` - Search marketplace for applications with filters
+- `publish_to_marketplace` - Generate code to publish an application to marketplace
+- `install_from_marketplace` - Generate code to install from marketplace
+- `generate_npm_package` - Generate npm package.json with netpad configuration
+- `sync_to_npm` - Generate code to sync application to npm registry
+- `import_from_npm` - Generate code to import application from npm
+- `validate_npm_package_name` - Validate npm package name format
+
+#### Workflow Automation Tools (10 new tools)
+- `list_workflow_node_types` - List 25+ workflow node types across categories
+- `list_workflow_templates` - List workflow templates (form-to-email, lead-qualification, etc.)
+- `get_workflow_template` - Get detailed workflow template configuration
+- `create_workflow` - Generate code to create a workflow
+- `add_workflow_node` - Generate code to add nodes to workflow
+- `connect_workflow_nodes` - Generate code to connect workflow nodes
+- `configure_workflow_trigger` - Generate trigger configuration
+- `test_workflow` - Generate workflow test code
+- `get_workflow_execution_history` - Generate execution history retrieval code
+- `preview_workflow_config` - Preview workflow configuration
+
+#### Conversational & Search Form Tools (11 new tools)
+- `list_conversational_templates` - List AI-powered conversational form templates
+- `get_conversational_template` - Get template details (it-helpdesk, customer-feedback, etc.)
+- `create_conversational_form` - Create conversational forms with topics, personas, and extraction
+- `configure_rag_settings` - Configure RAG (Retrieval-Augmented Generation) for forms
+- `add_rag_document` - Generate code to upload documents for RAG
+- `list_search_operators` - List search operators by field type
+- `create_search_form` - Create MongoDB search forms with configurable operators
+- `configure_search_operators` - Configure operators for specific fields
+- `test_conversational_form` - Generate conversational form test code
+- `test_search_form` - Generate search form test code
+
+#### Enhanced Template Tools (5 new tools)
+- `list_template_categories` - List 10 template categories
+- `list_form_templates` - List 24 pre-built form templates
+- `get_form_template` - Get detailed template with all fields and configuration
+- `create_form_from_template` - Create form from template with customizations
+- `preview_template_config` - Preview template configuration
+
+#### Data Browser & Connection Tools (12 new tools)
+- `list_connection_types` - List supported MongoDB connection types
+- `generate_connection_config` - Generate connection vault configuration
+- `list_query_templates` - List pre-built query templates
+- `get_query_template` - Get specific query template
+- `generate_data_browser_query` - Generate find/aggregate/distinct/count queries
+- `generate_aggregation_pipeline` - Generate complex aggregation pipelines
+- `generate_index_recommendations` - Get index suggestions based on query patterns
+- `generate_schema_analysis` - Generate schema inference code
+- `generate_data_export` - Generate data export code (JSON/CSV/XLSX)
+- `generate_connection_test` - Generate connection test code
+- `generate_list_databases` - Generate database listing code
+- `generate_list_collections` - Generate collection listing code
+
+#### New Resources (9 new resources)
+- `netpad://reference/application-templates` - Application templates reference
+- `netpad://reference/workflow-nodes` - Workflow node types reference
+- `netpad://reference/workflow-templates` - Workflow templates reference
+- `netpad://reference/conversational-templates` - Conversational form templates
+- `netpad://reference/search-operators` - Search operators by field type
+- `netpad://reference/form-templates` - 24 form templates
+- `netpad://reference/template-categories` - Template categories
+- `netpad://reference/connection-types` - MongoDB connection types
+- `netpad://reference/query-templates` - Query templates
+
+#### Form Templates (24 templates)
+Added comprehensive form template library across 10 categories:
+- **Business**: Contact Form, Lead Capture, Quote Request, Newsletter Signup
+- **Events**: Event Registration, RSVP, Volunteer Signup, Webinar Registration
+- **Feedback**: Customer Satisfaction, NPS Survey, Product Feedback, General Feedback
+- **Support**: Support Ticket, Appointment Booking
+- **E-commerce**: Order Form, Return Request
+- **Healthcare**: Patient Intake (encrypted), Health Screening
+- **HR**: Job Application
+- **Finance**: Expense Report
+- **Education**: Course Enrollment, Scholarship Application
+- **Real Estate**: Property Inquiry, Rental Application
+
+#### Conversational Form Templates (4 templates)
+- `it-helpdesk` - IT support ticket collection through conversation
+- `customer-feedback` - Customer experience feedback collection
+- `lead-qualification` - Sales lead qualification with scoring
+- `patient-intake` - Healthcare patient information gathering
+
+#### Workflow Templates (5 templates)
+- `form-to-email` - Send email notifications on form submission
+- `form-to-database` - Save submissions to MongoDB
+- `lead-qualification` - Qualify and route leads based on criteria
+- `webhook-to-database` - Process incoming webhooks to database
+- `scheduled-report` - Generate and send scheduled reports
+
+### Changed
+
+- Package version bumped from 0.1.0 to 2.0.0
+- Description updated to reflect 75 tools
+- Added keywords for new features (workflow, applications, marketplace, etc.)
+
+### Technical Details
+
+- 6 new tool modules added:
+  - `application-management-tools.ts` - Application lifecycle management
+  - `marketplace-tools.ts` - Marketplace and npm integration
+  - `workflow-tools.ts` - Workflow automation
+  - `conversational-search-tools.ts` - Conversational and search forms
+  - `template-tools.ts` - Enhanced form templates
+  - `data-browser-tools.ts` - MongoDB data browser
+- Total tool count: 75 tools
+- Total resources: 16 resources
+- Built with TypeScript and tsup
+- Uses @modelcontextprotocol/sdk v1.0.0
+- Requires Node.js 18+
+
+---
+
 ## [0.1.0] - 2025-01-03
 
 ### Added

package/README.md

@@ -1,6 +1,16 @@
 # @netpad/mcp-server
 
-An MCP (Model Context Protocol) server that helps developers build form applications with [@netpad/forms](https://www.npmjs.com/package/@netpad/forms) and the NetPad platform.
+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.
+
+## What's New in v2.0.0
+
+- **Application Management**: Create, release, and manage NetPad applications with contracts
+- **Marketplace & npm Integration**: Publish to marketplace and sync with npm registry
+- **Workflow Automation**: 25+ node types for building automation workflows
+- **Conversational Forms**: AI-powered data collection with RAG support
+- **Search Forms**: MongoDB-powered search interfaces with configurable operators
+- **25+ Form Templates**: Pre-built templates across 10 categories
+- **Data Browser**: MongoDB connection management and query tools
 
 ## Features
 
@@ -8,20 +18,41 @@ An MCP (Model Context Protocol) server that helps developers build form applicat
 - **Form Generation**: Generate complete form configurations from natural language descriptions
 - **Field Configuration**: Create individual field configs with validation, conditional logic, and computed fields
 - **Multi-Page Wizards**: Generate step-by-step form configurations
+- **25+ Templates**: Pre-built templates for business, events, feedback, support, healthcare, and more
 - **Validation**: Configure and validate form schemas
 
 ### Application Development
+- **Application Management**: Create and manage NetPad applications with releases and contracts
+- **Marketplace Publishing**: Publish applications to the NetPad marketplace
+- **npm Integration**: Sync applications to npm for distribution
 - **Next.js Scaffolding**: Generate complete Next.js applications with forms
-- **Workflow Integration**: Connect forms to NetPad workflows for processing
-- **MongoDB Queries**: Generate queries for form submission data
 - **API Routes**: Generate Next.js API routes for form operations
 
-### Developer Experience
-- **Use Case Templates**: Pre-built templates for common form types
-- **Field Suggestions**: Get recommended fields for your use case
-- **Best Practices**: Access guidelines for form design, security, and workflows
-- **Error Debugging**: Explain errors and get solutions
-- **Documentation**: Embedded docs and examples
+### Workflow Automation
+- **Visual Workflows**: Build automation with 25+ node types
+- **Triggers**: Form submission, webhook, schedule, manual, API
+- **Logic Nodes**: Conditional routing, switch, filter, loop
+- **Data Nodes**: Transform, code execution, variable management
+- **Integrations**: MongoDB, HTTP, Email, Slack, Google Sheets
+
+### Conversational Forms & RAG
+- **AI-Powered Forms**: Natural language data collection
+- **Topic Management**: Define conversation topics with priority and depth
+- **RAG Integration**: Knowledge-guided conversations with document retrieval
+- **Persona Configuration**: Professional, friendly, casual, or empathetic styles
+
+### Search Forms
+- **MongoDB Search**: Build search interfaces for your data
+- **Configurable Operators**: equals, contains, between, regex, and more
+- **Result Views**: Table, cards, or list layouts
+- **Smart Dropdowns**: Distinct values with counts
+
+### Data Browser
+- **Connection Management**: Atlas, self-hosted, and Atlas Data API support
+- **Query Templates**: Pre-built queries for common operations
+- **Aggregation Pipelines**: Complex data analysis
+- **Schema Analysis**: Infer collection schemas
+- **Index Recommendations**: Optimize query performance
 
 ## Installation
 
@@ -42,7 +73,7 @@ Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
 ```json
 {
   "mcpServers": {
-    "netpad-forms": {
+    "netpad": {
       "command": "npx",
       "args": ["@netpad/mcp-server"]
     }
@@ -57,7 +88,7 @@ Add to `~/.cursor/mcp.json`:
 ```json
 {
   "mcpServers": {
-    "netpad-forms": {
+    "netpad": {
       "command": "npx",
       "args": ["@netpad/mcp-server"]
     }
@@ -65,9 +96,9 @@ Add to `~/.cursor/mcp.json`:
 }
 ```
 
-## Available Tools (22 total)
+## Available Tools (75 total)
 
-### Form Building Tools
+### Form Building Tools (6)
 
 | Tool | Description |
 |------|-------------|
@@ -78,17 +109,89 @@ Add to `~/.cursor/mcp.json`:
 | `generate_multipage_config` | Generate multi-page wizard configuration |
 | `validate_form_config` | Validate a form configuration |
 
-### Application Building Tools
+### Application Management Tools (7)
 
 | Tool | Description |
 |------|-------------|
-| `scaffold_nextjs_app` | Generate a complete Next.js application with forms |
-| `generate_workflow_integration` | Generate workflow integration code |
-| `generate_mongodb_query` | Generate MongoDB queries for form data |
-| `generate_api_route` | Generate Next.js API routes |
-| `generate_react_code` | Generate React components for forms |
+| `list_application_templates` | List available application templates |
+| `get_application_template` | Get detailed template information |
+| `create_application` | Generate code to create a new application |
+| `generate_application_contract` | Generate API contract for an application |
+| `generate_application_release` | Generate release configuration |
+| `generate_export_bundle` | Generate export bundle structure |
+| `preview_application_config` | Preview application configuration |
+
+### Marketplace & npm Tools (8)
+
+| Tool | Description |
+|------|-------------|
+| `list_marketplace_categories` | List marketplace categories |
+| `search_marketplace` | Search marketplace for applications |
+| `publish_to_marketplace` | Generate code to publish an application |
+| `install_from_marketplace` | Generate code to install from marketplace |
+| `generate_npm_package` | Generate npm package.json for application |
+| `sync_to_npm` | Generate code to sync application to npm |
+| `import_from_npm` | Generate code to import from npm |
+| `validate_npm_package_name` | Validate npm package name |
+
+### Workflow Tools (10)
+
+| Tool | Description |
+|------|-------------|
+| `list_workflow_node_types` | List available workflow node types |
+| `list_workflow_templates` | List workflow templates |
+| `get_workflow_template` | Get detailed workflow template |
+| `create_workflow` | Generate code to create a workflow |
+| `add_workflow_node` | Generate code to add a node |
+| `connect_workflow_nodes` | Generate code to connect nodes |
+| `configure_workflow_trigger` | Generate trigger configuration |
+| `test_workflow` | Generate workflow test code |
+| `get_workflow_execution_history` | Generate execution history code |
+| `preview_workflow_config` | Preview workflow configuration |
+
+### Conversational & Search Form Tools (11)
 
-### Reference Tools
+| Tool | Description |
+|------|-------------|
+| `list_conversational_templates` | List conversational form templates |
+| `get_conversational_template` | Get template details |
+| `create_conversational_form` | Create AI-powered conversational form |
+| `configure_rag_settings` | Configure RAG for a form |
+| `add_rag_document` | Upload document for RAG |
+| `list_search_operators` | List available search operators |
+| `create_search_form` | Create MongoDB search form |
+| `configure_search_operators` | Configure field operators |
+| `test_conversational_form` | Generate test code |
+| `test_search_form` | Generate search test code |
+
+### Template Tools (5)
+
+| Tool | Description |
+|------|-------------|
+| `list_template_categories` | List all template categories |
+| `list_form_templates` | List 25+ form templates |
+| `get_form_template` | Get detailed template |
+| `create_form_from_template` | Create form from template |
+| `preview_template_config` | Preview template configuration |
+
+### Data Browser Tools (12)
+
+| Tool | Description |
+|------|-------------|
+| `list_connection_types` | List supported connection types |
+| `generate_connection_config` | Generate connection configuration |
+| `list_query_templates` | List query templates |
+| `get_query_template` | Get specific query template |
+| `generate_data_browser_query` | Generate MongoDB queries |
+| `generate_aggregation_pipeline` | Generate aggregation pipelines |
+| `generate_index_recommendations` | Get index suggestions |
+| `generate_schema_analysis` | Generate schema analysis code |
+| `generate_data_export` | Generate data export code |
+| `generate_connection_test` | Generate connection test code |
+| `generate_list_databases` | Generate list databases code |
+| `generate_list_collections` | Generate list collections code |
+
+### Reference Tools (5)
 
 | Tool | Description |
 |------|-------------|
@@ -98,117 +201,136 @@ Add to `~/.cursor/mcp.json`:
 | `list_validation_options` | List validation rule options |
 | `list_theme_options` | List theme customization options |
 
-### Helper Tools
+### Helper Tools (11)
 
 | Tool | Description |
 |------|-------------|
-| `get_use_case_template` | Get pre-built templates (leadCapture, eventRegistration, feedbackSurvey) |
-| `suggest_form_fields` | Get field recommendations for your use case |
-| `get_best_practices` | Get best practices (formDesign, workflowPatterns, securityGuidelines, troubleshooting) |
+| `scaffold_nextjs_app` | Generate a complete Next.js application |
+| `generate_workflow_integration` | Generate workflow integration code |
+| `generate_mongodb_query` | Generate MongoDB queries for form data |
+| `generate_api_route` | Generate Next.js API routes |
+| `generate_react_code` | Generate React components |
+| `get_use_case_template` | Get pre-built use case templates |
+| `suggest_form_fields` | Get field recommendations |
+| `get_best_practices` | Get best practices guides |
 | `debug_form_config` | Analyze form configuration for issues |
-| `explain_error` | Explain error codes and provide solutions |
+| `explain_error` | Explain error codes with solutions |
 | `get_documentation` | Access documentation topics |
 
-## Example Interactions
+## Form Templates (24)
 
-### Create a Form from Description
+Pre-built templates across 10 categories:
 
-```
-User: Create a lead capture form for a SaaS product
-
-Claude: [Uses generate_form and suggest_form_fields tools]
-Here's your lead capture form with recommended fields for SaaS:
-- First Name, Last Name, Work Email, Company, Job Title
-- Company Size dropdown
-- Interest checkboxes (Demo, Pricing, Docs, Partnership)
-- Message field
-```
+| Category | Templates |
+|----------|-----------|
+| **Business** | Contact Form, Lead Capture, Quote Request, Newsletter Signup |
+| **Events** | Event Registration, RSVP, Volunteer Signup, Webinar Registration |
+| **Feedback** | Customer Satisfaction, NPS Survey, Product Feedback, General Feedback |
+| **Support** | Support Ticket, Appointment Booking |
+| **E-commerce** | Order Form, Return Request |
+| **Healthcare** | Patient Intake, Health Screening |
+| **HR** | Job Application |
+| **Finance** | Expense Report |
+| **Education** | Course Enrollment, Scholarship Application |
+| **Real Estate** | Property Inquiry, Rental Application |
 
-### Generate a Complete Application
+## Conversational Form Templates
 
-```
-User: Scaffold a Next.js app for this contact form
-
-Claude: [Uses scaffold_nextjs_app tool]
-Here's your complete Next.js application:
-- package.json with all dependencies
-- Form page component with submission handling
-- Layout with Material-UI theming
-- Environment variable template
-- Setup instructions
-```
+AI-powered data collection templates:
 
-### Connect Form to Workflow
+| Template | Use Case |
+|----------|----------|
+| `it-helpdesk` | IT support ticket collection |
+| `customer-feedback` | Customer experience feedback |
+| `lead-qualification` | Sales lead qualification |
+| `patient-intake` | Healthcare patient information |
 
-```
-User: I want to save form submissions to MongoDB and send a notification email
-
-Claude: [Uses generate_workflow_integration with 'full_pipeline' type]
-Here's the integration code:
-- NetPad client setup
-- Form submission handler
-- Workflow trigger with payload
-- Status polling and error handling
-- Example workflow configuration
-```
+## Workflow Templates
 
-### Debug a Form Issue
+Pre-built automation patterns:
 
-```
-User: I'm getting a 401 error when submitting the form
+| Template | Description |
+|----------|-------------|
+| `form-to-email` | Send email on form submission |
+| `form-to-database` | Save submissions to MongoDB |
+| `lead-qualification` | Qualify and route leads |
+| `webhook-to-database` | Process webhooks to database |
+| `scheduled-report` | Generate scheduled reports |
+
+## Resources
+
+The server exposes documentation as MCP resources:
+
+### Documentation
+- `netpad://docs/readme` - Main documentation
+- `netpad://docs/architecture` - Architecture guide
+- `netpad://docs/quick-start` - Quick start guide
+- `netpad://docs/examples` - Code examples
+
+### References
+- `netpad://reference/field-types` - Field type reference
+- `netpad://reference/operators` - Operator reference
+- `netpad://reference/formulas` - Formula function reference
+- `netpad://reference/application-templates` - Application templates
+- `netpad://reference/workflow-nodes` - Workflow node types
+- `netpad://reference/workflow-templates` - Workflow templates
+- `netpad://reference/conversational-templates` - Conversational form templates
+- `netpad://reference/search-operators` - Search operators
+- `netpad://reference/form-templates` - Form templates
+- `netpad://reference/template-categories` - Template categories
+- `netpad://reference/connection-types` - MongoDB connection types
+- `netpad://reference/query-templates` - Query templates
 
-Claude: [Uses explain_error tool]
-## Error: 401
+## Example Interactions
 
-**Explanation:** Authentication failed. The API key is missing, invalid, or expired.
+### Create an Application
 
-**Solutions:**
-1. Verify your API key is correct in environment variables
-2. Check that the key starts with np_live_ or np_test_
-3. Ensure the key has not been revoked in the NetPad dashboard
-4. For test environments, use np_test_ prefixed keys
 ```
+User: Create a customer feedback application with a survey form and email workflow
 
-### Get Field Suggestions
+Claude: [Uses create_application, create_form_from_template, create_workflow tools]
+Here's your complete application:
+- Customer Feedback Application with NPS survey
+- Workflow to send thank-you emails
+- MongoDB storage for responses
+```
+
+### Build a Search Interface
 
 ```
-User: What fields should I include for a healthcare appointment form?
-
-Claude: [Uses suggest_form_fields with industry: 'healthcare']
-Recommended fields:
-- Patient name, email, phone
-- Date of birth, insurance info
-- Preferred appointment date/time
-- Reason for visit
-
-Tips:
-- Ensure HIPAA compliance for health data
-- Add clear consent checkboxes for data usage
+User: I need a search form for my products collection
+
+Claude: [Uses create_search_form tool]
+Here's your search form with:
+- Text search on name and description
+- Category dropdown with distinct values
+- Price range filter
+- Results in table layout with pagination
 ```
 
-## Available Prompts
+### Create a Conversational Form
 
-Pre-built prompts for common form types:
+```
+User: I want an AI-powered IT helpdesk intake form
 
-| Prompt | Description |
-|--------|-------------|
-| `create-contact-form` | Generate a basic contact form |
-| `create-registration-form` | Generate a user registration form |
-| `create-survey-form` | Generate a multi-page survey |
-| `create-order-form` | Generate an order form with computed totals |
-| `explain-conditional-logic` | Explain how conditional logic works |
+Claude: [Uses create_conversational_form with it-helpdesk template]
+Here's your conversational form:
+- Professional AI persona
+- Topics: Issue type, urgency, description, environment
+- Automatic data extraction to structured format
+```
 
-## Resources
+### Generate MongoDB Queries
 
-The server exposes documentation as MCP resources:
+```
+User: I need to analyze form submissions by month
 
-- `netpad://docs/readme` - Main documentation
-- `netpad://docs/architecture` - Architecture guide
-- `netpad://docs/quick-start` - Quick start guide
-- `netpad://docs/examples` - Code examples
-- `netpad://reference/field-types` - Field type reference
-- `netpad://reference/operators` - Operator reference
-- `netpad://reference/formulas` - Formula function reference
+Claude: [Uses generate_aggregation_pipeline tool]
+Here's the aggregation pipeline:
+- Groups submissions by year/month
+- Counts per period
+- Sorted chronologically
+```
 
 ## Development
 
@@ -244,7 +366,7 @@ Or test via command line:
 echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node dist/index.js
 
 # Call a tool
-echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_field_types","arguments":{"category":"text"}}}' | node dist/index.js
+echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_form_templates","arguments":{}}}' | node dist/index.js
 ```
 
 ## Related Packages