n8n-mcp/docs/CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

2.7.18 - 2025-07-18

Fixed

• Node type prefix normalization for AI agents (Issue #71)
  • AI agents can now use node types directly from n8n workflow exports without manual conversion
  • Added automatic normalization: n8n-nodes-base.httpRequest → nodes-base.httpRequest
  • Added automatic normalization: @n8n/n8n-nodes-langchain.agent → nodes-langchain.agent
  • Fixed 9 MCP tools that were failing with full package names:
    • get_node_info, get_node_essentials, get_node_as_tool_info
    • search_node_properties, validate_node_minimal, validate_node_config
    • get_property_dependencies, search_nodes, get_node_documentation
  • Maintains backward compatibility - existing short prefixes continue to work
  • Created centralized normalizeNodeType utility for consistent handling across all tools

Added

• Node type utilities in src/utils/node-utils.ts
  • normalizeNodeType() - Converts full package names to database format
  • getNodeTypeAlternatives() - Provides fallback options for edge cases
  • getWorkflowNodeType() - Constructs proper n8n workflow format from database values
• workflowNodeType field in all MCP tool responses that return node information
  • AI agents now receive both nodeType (internal format) and workflowNodeType (n8n format)
  • Example: nodeType: "nodes-base.webhook", workflowNodeType: "n8n-nodes-base.webhook"
  • Prevents confusion where AI agents would search nodes and use wrong format in workflows
  • Added to: search_nodes, get_node_info, get_node_essentials, get_node_as_tool_info, validate_node_operation

2.7.17 - 2025-07-17

Fixed

• Removed faulty auto-generated examples from MCP tools (Issue #60)
  • Removed examples from get_node_essentials responses that were misleading AI agents
  • Removed examples from validate_node_operation when validation errors occur
  • Examples were showing incorrect configurations (e.g., Slack showing "channel" property instead of required "select" property)
  • Tools now focus on validation errors and fix suggestions instead of potentially incorrect examples
  • Preserved helpful format hints in get_node_for_task (these show input formats like "#general" or URL examples, not node configurations)
  • This change reduces confusion and helps AI agents build correct workflows on the first attempt

Changed

• Updated tool documentation to reflect removal of auto-generated examples
• get_node_essentials now points users to validate_node_operation for working configurations
• Enhanced validation error messages to be more helpful without relying on examples

2.7.16 - 2025-07-17

Added

• Comprehensive MCP tools documentation (Issue #60)
  • Documented 30 previously undocumented MCP tools
  • Added complete parameter descriptions, examples, and best practices
  • Implemented modular documentation system with per-tool files
  • Documentation optimized for AI agent consumption (utilitarian approach)
  • Added documentation for all n8n management tools (n8n_*)
  • Added documentation for workflow validation tools
  • Added documentation for template management tools
  • Improved tools_documentation() to serve as central documentation hub

Enhanced

• Tool documentation system completely rewritten for AI optimization
  • Each tool now has its own documentation module
  • Consistent structure: description, parameters, examples, tips, common errors
  • AI-friendly formatting with clear sections and examples
  • Reduced redundancy while maintaining completeness

2.7.15 - 2025-07-15

Fixed

• HTTP Server URL Handling: Fixed hardcoded localhost URLs in HTTP server output (Issue #41, #42)
  • Added intelligent URL detection that considers BASE_URL, PUBLIC_URL, and proxy headers
  • Server now displays correct public URLs when deployed behind reverse proxies
  • Added support for X-Forwarded-Proto and X-Forwarded-Host headers when TRUST_PROXY is enabled
  • Fixed port display logic to hide standard ports (80/443) in URLs
  • Added new GET endpoints (/, /mcp) for better API discovery

Security

• Host Header Injection Prevention: Added hostname validation to prevent malicious proxy headers
  • Only accepts valid hostnames (alphanumeric, dots, hyphens, optional port)
  • Rejects hostnames with paths, usernames, or special characters
  • Falls back to safe defaults when invalid headers are detected
• URL Scheme Validation: Restricted URL schemes to http/https only
  • Blocks dangerous schemes like javascript:, file://, data:
  • Validates all configured URLs (BASE_URL, PUBLIC_URL)
• Information Disclosure: Removed sensitive environment data from API responses
  • Root endpoint no longer exposes internal configuration
  • Only shows essential API information

Added

• URL Detection Utility: New url-detector.ts module for intelligent URL detection
  • Prioritizes explicit configuration (BASE_URL/PUBLIC_URL)
  • Falls back to proxy headers when TRUST_PROXY is enabled
  • Uses host/port configuration as final fallback
  • Includes comprehensive security validations
• Test Scripts: Added test scripts for URL configuration and security validation
  • test-url-configuration.ts: Tests various URL detection scenarios
  • test-security.ts: Validates security fixes for malicious headers

Changed

• Consistent Versioning: Fixed version inconsistency between server implementations
  • Both http-server.ts and http-server-single-session.ts now use PROJECT_VERSION
  • Removed hardcoded version strings
• HTTP Bridge: Updated to use HOST/PORT environment variables for default URL construction
• Documentation: Updated HTTP deployment guide with URL configuration section

[2.7.14] - 2025-07-15

Fixed

• Partial Update Tool: Fixed validation/execution discrepancy that caused "settings must NOT have additional properties" error (Issue #45)
  • Removed logic in cleanWorkflowForUpdate that was incorrectly adding default settings to workflows
  • The function now only removes read-only fields without adding any new properties
  • This fixes the issue where partial updates would pass validation but fail during execution
  • Added comprehensive test coverage in test-issue-45-fix.ts

2.7.13 - 2025-07-11

Fixed

• npx Execution: Fixed WASM file resolution for sql.js when running via npx n8n-mcp (Issue #31)
  • Enhanced WASM file locator to try multiple path resolution strategies
  • Added require.resolve() for reliable package location in npm environments
  • Made better-sqlite3 an optional dependency to prevent installation failures
  • Improved error messages when sql.js fails to load
  • The package now works correctly with npx without any manual configuration

Changed

• Database Adapter: Improved path resolution for both local development and npm package contexts
  • Supports various npm installation scenarios (global, local, npx cache)
  • Better fallback handling for sql.js WebAssembly file loading

2.7.12 - 2025-07-10

Updated

• n8n Dependencies: Updated to latest versions for compatibility and new features
  • n8n: 1.100.1 → 1.101.1
  • n8n-core: 1.99.0 → 1.100.0
  • n8n-workflow: 1.97.0 → 1.98.0
  • @n8n/n8n-nodes-langchain: 1.99.0 → 1.100.1
• Node Database: Rebuilt with 528 nodes from updated n8n packages
• All validation tests passing with updated dependencies

2.7.11 - 2025-07-10

Enhanced

• Token Efficiency: Significantly reduced MCP tool description lengths for better AI agent performance
  • Documentation tools: Average 129 chars (down from ~250-450)
  • Management tools: Average 93 chars (down from ~200-400)
  • Overall token reduction: ~65-70%
  • Moved detailed documentation to tools_documentation() system
  • Only 2 tools exceed 200 chars (list_nodes: 204, n8n_update_partial_workflow: 284)
  • Preserved all essential information while removing redundancy

Fixed

• search_nodes Tool: Major improvements to search functionality for AI agents
  • Primary nodes (webhook, httpRequest) now appear first in search results instead of being buried
  • Fixed issue where searching "webhook" returned specialized triggers instead of the main Webhook node
  • Fixed issue where searching "http call" didn't prioritize HTTP Request node
  • Fixed FUZZY mode returning no results for typos like "slak" (lowered threshold from 300 to 200)
  • Removed unnecessary searchInfo messages that appeared on every search
  • Fixed HTTP node type comparison case sensitivity issue
  • Implemented relevance-based ranking with special boosting for primary nodes
• search_templates FTS5 Error: Fixed "no such module: fts5" error in environments without FTS5 support (fixes Claude Desktop issue)
  • Made FTS5 completely optional - detects support at runtime
  • Removed FTS5 from required schema to prevent initialization failures
  • Automatically falls back to LIKE search when FTS5 is unavailable
  • FTS5 tables and triggers created conditionally only if supported
  • Template search now works in ALL SQLite environments

Added

• FTS5 Full-Text Search: Added SQLite FTS5 support for faster and more intelligent node searching
  • Automatic fallback to LIKE queries if FTS5 is unavailable
  • Supports advanced search modes: OR (default), AND (all terms required), FUZZY (typo-tolerant)
  • Significantly improves search performance for large databases
  • FUZZY mode now uses edit distance (Levenshtein) for better typo tolerance
• FTS5 Detection: Added runtime detection of FTS5 support
  • checkFTS5Support() method in database adapters
  • Conditional initialization of FTS5 features
  • Graceful degradation when FTS5 not available

[Unreleased]

Fixed

• Code Node Documentation: Corrected information about $helpers object and getWorkflowStaticData function
  • $getWorkflowStaticData() is a standalone function, NOT $helpers.getWorkflowStaticData()
  • Updated Code node guide to clarify which functions are standalone vs methods on $helpers
  • Added validation warning when using incorrect $helpers.getWorkflowStaticData syntax
  • Based on n8n community feedback and GitHub issues showing this is a common confusion point

Added

• Expression vs Code Node Clarification: Added comprehensive documentation about differences between expression and Code node contexts
  • New section "IMPORTANT: Code Node vs Expression Context" explaining key differences
  • Lists expression-only functions not available in Code nodes ($now(), $today(), Tournament template functions)
  • Clarifies different syntax: $('Node Name') vs $node['Node Name']
  • Documents reversed JMESPath parameter order between contexts
  • Added "Expression Functions NOT in Code Nodes" section with alternatives
• Enhanced Code Node Validation: Added new validation checks for common expression/Code node confusion
  • Detects expression syntax {{...}} in Code nodes with clear error message
  • Warns about using $node[] syntax instead of $() in Code nodes
  • Identifies expression-only functions with helpful alternatives
  • Checks for wrong JMESPath parameter order
  • Test script test-expression-code-validation.ts to verify validation works correctly

2.7.11 - 2025-07-09

Fixed

• Issue #26: Fixed critical issue where AI agents were placing error handling properties inside parameters instead of at node level
  • Root cause: AI agents were confused by examples showing parameters.path updates and assumed all properties followed the same pattern
  • Error handling properties (onError, retryOnFail, maxTries, waitBetweenTries, alwaysOutputData) must be placed at the NODE level
  • Other node-level properties (executeOnce, disabled, notes, notesInFlow, credentials) were previously undocumented for AI agents
  • Updated n8n_create_workflow and n8n_update_partial_workflow documentation with explicit examples and warnings
  • Verified fix with workflows tGyHrsBNWtaK0inQ, usVP2XRXhI35m3Ts, and swuogdCCmNY7jj71

Added

• Comprehensive Node-Level Properties Reference in tools documentation (tools_documentation())
  • Documents ALL available node-level properties with explanations
  • Shows correct placement and usage for each property
  • Provides complete example node configuration
  • Accessible via tools_documentation({depth: "full"}) for AI agents
• Enhanced Workflow Validation for additional node-level properties
  • Now validates executeOnce, disabled, notes, notesInFlow types
  • Checks for misplacement of ALL node-level properties (expanded from 6 to 11)
  • Provides clear error messages with correct examples when properties are misplaced
  • Shows specific fix with example node structure
• Test Script test-node-level-properties.ts demonstrating correct usage
  • Shows all node-level properties in proper configuration
  • Demonstrates common mistakes to avoid
  • Validates workflow configurations
• Comprehensive Code Node Documentation in tools_documentation
  • New code_node_guide topic with complete reference for JavaScript and Python
  • Covers all built-in variables: $input, $json, $node, $workflow, $execution, $prevNode
  • Documents helper functions: DateTime (Luxon), JMESPath, $helpers methods
  • Includes return format requirements with correct/incorrect examples
  • Security considerations and banned operations
  • Common patterns: data transformation, filtering, aggregation, error handling
  • Code node as AI tool examples
  • Performance best practices and debugging tips
• Enhanced Code Node Validation with n8n-specific patterns
  • Validates return statement presence and format
  • Checks for array of objects with json property
  • Detects common mistakes (returning primitives, missing array wrapper)
  • Validates n8n variable usage ($input, items, $json context)
  • Security checks (eval, exec, require, file system access)
  • Language-specific validation for JavaScript and Python
  • Mode-specific warnings ($json in wrong mode)
  • Async/await pattern validation
  • External library detection with helpful alternatives
• Expanded Code Node Examples in ExampleGenerator
  • Data transformation, aggregation, and filtering examples
  • API integration with error handling
  • Python data processing example
  • Code node as AI tool pattern
  • CSV to JSON transformation
  • All examples include proper return format
• New Code Node Task Templates
  • custom_ai_tool: Create custom tools for AI agents
  • aggregate_data: Summary statistics from multiple items
  • batch_process_with_api: Process items in batches with rate limiting
  • error_safe_transform: Robust data transformation with validation
  • async_data_processing: Concurrent processing with limits
  • python_data_analysis: Statistical analysis using Python
  • All templates include comprehensive error handling
• Fixed Misleading Documentation based on real-world testing:
  • Crypto Module: Clarified that require('crypto') IS available despite editor warnings
  • Helper Functions: Fixed documentation showing $getWorkflowStaticData() is standalone, not on $helpers
  • JMESPath: Corrected syntax from jmespath.search() to $jmespath()
  • Node Access: Fixed from $node['Node Name'] to $('Node Name')
  • Python: Documented item.json.to_py() for JsProxy conversion
  • Added comprehensive "Available Functions and Libraries" section
  • Created security examples showing proper crypto usage
  • JMESPath Numeric Literals: Added critical documentation about n8n-specific requirement for backticks around numbers in filters
    • Example: [?age >= \18`]not[?age >= 18]`
    • Added validation to detect and warn about missing backticks
    • Based on Claude Desktop feedback from workflow testing
  • Webhook Data Structure: Fixed common webhook data access gotcha
    • Webhook payload is at items[0].json.body, NOT items[0].json
    • Added dedicated "Webhook Data Access" section in Code node documentation
    • Created webhook processing example showing correct data access
    • Added validation to detect incorrect webhook data access patterns
    • New task template process_webhook_data with complete example

Enhanced

• MCP Tool Documentation significantly improved:
  • n8n_create_workflow now includes complete node example with all properties
  • n8n_update_partial_workflow shows difference between node-level vs parameter updates
  • Added "CRITICAL" warnings about property placement
  • Updated best practices and common pitfalls sections
• Workflow Validator improvements:
  • Expanded property checking from 6 to 11 node-level properties
  • Better error messages showing complete correct structure
  • Type validation for all node-level boolean and string properties
• Code Node Validation enhanced with new checks:
  • Detects incorrect $helpers.getWorkflowStaticData() usage
  • Warns about $helpers usage without availability check
  • Validates crypto usage with proper require statement
  • All based on common errors found in production workflows
• Type Definitions updated:
  • Added notesInFlow to WorkflowNode interface in workflow-validator.ts
  • Fixed credentials type from Record<string, string> to Record<string, unknown> in n8n-api.ts
• NodeSpecificValidators now includes comprehensive Code node validation
  • Language-specific syntax checks
  • Return format validation with detailed error messages
  • n8n variable usage validation
  • Security pattern detection
  • Error handling recommendations
  • Mode-specific suggestions
• Config Validator improved Code node validation
  • Better return statement detection
  • Enhanced syntax checking for both JavaScript and Python
  • More helpful error messages with examples
  • Detection of common n8n Code node mistakes
• Fixed Documentation Inaccuracies based on user testing and n8n official docs:
  • JMESPath: Corrected syntax to $jmespath() instead of jmespath.search()
  • Node Access: Fixed to show $('Node Name') syntax, not $node
  • Python: Documented _input.all() and item.json.to_py() for JsProxy conversion
  • Python: Added underscore prefix documentation for all built-in variables
  • Validation: Skip property visibility warnings for Code nodes to reduce false positives

2.7.10 - 2025-07-09

Documentation Update

• Added comprehensive documentation on how to update error handling properties using n8n_update_partial_workflow
• Error handling properties can be updated at the node level using the workflow diff engine:
  • continueOnFail: boolean - Whether to continue workflow on node failure
  • onError: 'continueRegularOutput' | 'continueErrorOutput' | 'stopWorkflow' - Error handling strategy
  • retryOnFail: boolean - Whether to retry on failure
  • maxTries: number - Maximum retry attempts
  • waitBetweenTries: number - Milliseconds to wait between retries
  • alwaysOutputData: boolean - Always output data even on error
• Added test script demonstrating error handling property updates
• Updated WorkflowNode type to include onError property in n8n-api types
• Workflow diff engine now properly handles all error handling properties

2.7.10 - 2025-07-07

Added

• Enhanced authentication logging for better debugging of client authentication issues
• Specific error reasons for authentication failures: no_auth_header, invalid_auth_format, invalid_token
• AUTH_TOKEN_FILE support in single-session HTTP server for consistency
• Empty token validation to prevent security issues
• Whitespace trimming for authentication tokens

Fixed

• Issue #22: Improved authentication failure diagnostics for mcp-remote client debugging
• Issue #16: Fixed AUTH_TOKEN_FILE validation for HTTP mode in Docker production stacks - Docker entrypoint now properly validates and supports AUTH_TOKEN_FILE environment variable
• Security: Removed token length from logs to prevent information disclosure

Security

• Authentication tokens are now trimmed to handle whitespace edge cases
• Empty tokens are explicitly rejected with clear error messages
• Removed sensitive information (token lengths) from authentication logs

2.7.8 - 2025-07-06

Added

• npx support for zero-installation usage - users can now run npx n8n-mcp without installing
• npm package distribution with runtime-only dependencies (8 deps vs 50+ dev deps)
• Dedicated publish script for npm releases with OTP support
• Database path resolution supporting npx, global, and local installations

Fixed

• Issue #15: Added npx execution support as requested
• Removed development dependencies from npm package (reduced from 1GB+ to ~50MB)
• Node.js version conflicts by excluding n8n dependencies from runtime package

Changed

• npm package now uses package.runtime.json for publishing (no n8n dependencies)
• Enhanced .gitignore to exclude npm publishing artifacts
• README now highlights npx as the primary installation method

2.7.5 - 2025-07-06

Added

• AUTH_TOKEN_FILE support for reading authentication tokens from files (Docker secrets compatible) - partial implementation
• Known Issues section in README documenting Claude Desktop container duplication bug
• Enhanced authentication documentation in Docker README

Fixed

• Issue #16: AUTH_TOKEN_FILE was documented but not implemented (partially fixed - see v2.7.10 for complete fix)
• HTTP server now properly supports both AUTH_TOKEN and AUTH_TOKEN_FILE environment variables

Changed

• Authentication logic now checks AUTH_TOKEN first, then falls back to AUTH_TOKEN_FILE
• Updated Docker documentation to clarify authentication options

2.7.4 - 2025-07-03

Changed

• Renamed start_here_workflow_guide tool to tools_documentation for better clarity
• Converted tool output from JSON to LLM-friendly plain text format
• Made documentation concise by default with "essentials" depth

Added

• depth parameter to control documentation detail level ("essentials" or "full")
• Per-tool documentation - get help for any specific MCP tool
• Two-tier documentation system:
  • Essentials: Brief description, key parameters, example, performance, tips
  • Full: Complete documentation with all details, examples, best practices
• Quick reference mode when called without parameters
• Documentation for 8 commonly used tools
• Test script for tools documentation (test:tools-documentation)

Removed

• Removed duplicate tools_documentation tool definition
• Removed unused getWorkflowGuide method (380+ lines)
• Removed old handlers-documentation.ts file

2.7.3 - 2025-07-02

Added

• MCP Tools Documentation system (initial implementation)
• tools_documentation tool for comprehensive MCP tool documentation
• Documentation includes parameters, examples, best practices, and pitfalls
• Search tools by keyword functionality
• Browse tools by category
• Quick reference guide with workflow patterns

Fixed

• Cleaned up redundant tool definitions

2.7.2 - 2025-07-01

Fixed

• HTTP deployment documentation improvements
• Docker configuration updates with n8n API options

Changed

• Updated version handling in multiple configuration files

2.7.1 - 2025-06-30

Fixed

• Workflow diff engine edge cases
• Transactional update processing improvements

Added

• Additional test coverage for diff operations
• Debug scripts for update operations

2.7.0 - 2025-06-29

Added

• New n8n_update_partial_workflow tool for efficient diff-based workflow editing with transactional updates
• WorkflowDiffEngine for applying targeted edits without sending full workflow JSON (80-90% token savings)
• 13 diff operations: addNode, removeNode, updateNode, moveNode, enableNode, disableNode, addConnection, removeConnection, updateConnection, updateSettings, updateName, addTag, removeTag
• Smart node references supporting both node ID and name
• Transaction safety with validation before applying changes
• Validation-only mode for testing diff operations
• Comprehensive test coverage for all diff operations
• Example guide in docs/workflow-diff-examples.md
• Two-pass processing allowing operations in any order
• Operation limit of 5 operations per request for reliability
• n8n_diagnostic tool to troubleshoot management tools visibility issues
• Version utility (src/utils/version.ts) for centralized version management
• Script to sync package.runtime.json version

Changed

• Renamed n8n_update_workflow to n8n_update_full_workflow to clarify it replaces entire workflow
• Renamed core MCP files for clarity:
  • tools-update.ts → tools.ts
  • server-update.ts → server.ts
  • http-server-fixed.ts → http-server.ts
• Updated imports across 21+ files to use new file names

Fixed

• Version mismatch issue where version was hardcoded instead of reading from package.json (GitHub issue #5)
• MCP validation error by simplifying schema to allow additional properties
• n8n API validation by removing all read-only fields in cleanWorkflowForUpdate
• Claude Desktop compatibility by adding additionalProperties: true
• Removed DEBUG console.log statements from MCP server

Removed

• Legacy HTTP server implementation (src/http-server.ts)
• Unused legacy API client (src/utils/n8n-client.ts)
• Unnecessary file name suffixes (-update, -fixed)

2.6.3 - 2025-06-26

Added

• n8n_validate_workflow tool to validate workflows directly from n8n instance by ID
• Fetches workflow from n8n API and runs comprehensive validation
• Supports all validation profiles and options
• Part of complete lifecycle: discover → build → validate → deploy → execute

2.6.2 - 2025-06-26

Added

• Node type validation to verify node types exist in n8n
• Smart suggestions for common mistakes (e.g., webhook → n8n-nodes-base.webhook)
• Minimum viable workflow validation preventing single-node workflows (except webhooks)
• Empty connection detection for multi-node workflows
• Helper functions: getWorkflowStructureExample() and getWorkflowFixSuggestions()

Fixed

• nodes-base prefix detection now catches errors before database lookup
• Enhanced error messages with clear guidance on proper workflow structure

2.6.1 - 2025-06-26

Added

• typeVersion validation in workflow validator
• Enforces typeVersion on all versioned nodes
• Warns on outdated node versions
• Prevents invalid version numbers

Fixed

• Missing typeVersion errors with correct version suggestions
• Invalid version detection exceeding maximum supported

2.6.0 - 2025-06-26

Added

• 14 n8n management tools for complete workflow lifecycle management:
  • n8n_create_workflow - Create workflows programmatically
  • n8n_update_workflow - Update existing workflows
  • n8n_trigger_webhook_workflow - Execute workflows via webhooks
  • n8n_list_executions - Monitor workflow executions
  • n8n_health_check - Check n8n instance connectivity
  • And 9 more workflow and execution management tools
• Integration with n8n-manager-for-ai-agents functionality
• Conditional tool registration based on N8N_API_URL and N8N_API_KEY configuration
• Smart error handling for API limitations

2.5.1 - 2025-06-24

Added

• get_node_as_tool_info tool for specific information about using ANY node as an AI tool
• Enhanced AI tool support with usage guidance
• Improved start_here_workflow_guide with Claude Project setup

Changed

• Enhanced AI tool detection and documentation
• Updated documentation to match current state

2.5.0 - 2025-06-24

Added

• Comprehensive workflow validation system:
  • validate_workflow - Validate entire workflows before deployment
  • validate_workflow_connections - Check workflow structure and connections
  • validate_workflow_expressions - Validate all n8n expressions
• Expression validator for n8n syntax validation
• AI tool connection validation
• Phase 2 validation improvements

2.4.2 - 2025-06-24

Added

• Enhanced operation-aware validation system
• validate_node_operation - Verify node configuration with operation awareness
• validate_node_minimal - Quick validation for required fields only
• Node-specific validation logic
• Validation profiles support

Fixed

• Validation improvements based on AI agent feedback

2.4.1 - 2025-06-20

Added

• n8n workflow templates integration:
  • list_node_templates - Find workflow templates using specific nodes
  • get_template - Get complete workflow JSON for import
  • search_templates - Search templates by keywords
  • get_templates_for_task - Get curated templates for common tasks
• Template fetching from n8n.io API
• Robust template fetching with retries
• Expanded template window from 6 months to 1 year

Fixed

• Made templates available in Docker by removing axios from runtime
• Template service made optional in Docker environment
• Non-deterministic CHECK constraint removed from templates table

2.4.0 - 2025-06-18

Added

• AI-optimized tools with 95% size reduction:
  • get_node_essentials - Returns only essential properties (10-20) with examples
  • search_node_properties - Find specific properties without downloading everything
  • get_node_for_task - Get pre-configured node settings for common tasks
  • list_tasks - List all available task templates
  • get_property_dependencies - Analyze property dependencies and visibility conditions
• Property filter service with curated essential properties
• Example generator for common use cases
• Task templates with pre-configured settings
• Docker build optimization (82% smaller images, 10x faster builds)

Changed

• Switched to MIT license for wider adoption
• Optimized Docker builds to exclude n8n dependencies at runtime
• Improved tool descriptions and added workflow guide tool

Fixed

• Docker build failures in GitHub Actions
• Claude Desktop stdio communication issues
• Version array handling in node parser

Removed

• Legacy MCP implementation files
• n8n dependencies from Docker runtime image

2.3.3 - 2025-06-16

Added

• Smart dependency update system for n8n packages
• GitHub Actions workflow for automated n8n updates
• Alternative Renovate configuration

Fixed

• n8n package interdependent version requirements
• Node type references in validation script

2.3.2 - 2025-06-14

Added

• Single-session HTTP server architecture
• Direct JSON-RPC implementation for HTTP mode
• Console output isolation for clean JSON-RPC responses

Fixed

• "stream is not readable" error in HTTP server
• "Server not initialized" error with StreamableHTTPServerTransport
• MCP HTTP server stream errors

2.3.1 - 2025-06-13

Added

• HTTP server mode for remote deployment with token authentication
• MCP-compatible HTTP endpoints
• Security features: CORS, rate limiting, request size limits
• Comprehensive HTTP testing scripts

2.3.0 - 2025-06-12

Added

• Universal Node.js compatibility with automatic database adapter fallback
• Database adapter pattern with BetterSQLiteAdapter and SQLJSAdapter
• Automatic adapter selection based on environment
• sql.js persistence layer with debounced saves

Changed

• Database operations now use unified adapter interface
• Transparent adapter switching for different Node.js versions

2.2.0 - 2025-06-12

Added

• Enhanced node parser with versioned node support
• Dedicated property extractor for complex node structures
• Full support for @n8n/n8n-nodes-langchain package
• AI tool detection (35 tools with usableAsTool property)

Changed

• Major refactor based on IMPLEMENTATION_PLAN.md v2.2
• Improved property/operation extraction (452/458 nodes have properties)
• Enhanced documentation mapping

Fixed

• VersionedNodeType handling
• Documentation mapping issues
• Property extraction for 98.7% of nodes

2.1.0 - 2025-06-09

Added

• Node extraction scripts for n8n modules
• Docker setup for n8n module processing
• Enhanced documentation fetcher
• Node source extractor utility

2.0.0 - 2025-06-08

Added

• Complete overhaul to enhanced documentation-only MCP server
• SQLite database with FTS5 for fast searching
• Comprehensive MCP tools for querying n8n nodes
• Node documentation service as core component

Changed

• Architecture redesign focusing on documentation serving
• Removed workflow execution capabilities
• Simplified to documentation and knowledge serving

1.0.0 - 2025-06-08

Added

• Initial release
• Basic n8n and MCP integration
• Core workflow automation features