Release v2.24.0

Release v2.24.0

Generating release notes from v2.10.4 to HEAD

✨ Features

• Enhance workflow mutation telemetry for better AI responses (czlonkowski#419) (99c5907)
• Add DISABLED_TOOLS environment variable for tool filtering (Issue czlonkowski#410) (53252ad)
• Telemetry-driven quick wins to reduce AI agent validation errors by 30-40% (60ab66d)
• Add workflow activation/deactivation via diff operations (346fa3c)
• Add comprehensive workflow versioning and rollback system with automatic backup (czlonkowski#359) (04e7c53)
• Add auto-update node versions to autofixer (c7f8614)
• Auto-update connection references when renaming nodes (czlonkowski#353) (czlonkowski#354) (551fea8)
• Add Claude Skills documentation and setup guide (czlonkowski#344) (dbdc88d)
• Enhanced error messages and documentation for workflow validation (fixes czlonkowski#331) v2.20.3 (czlonkowski#339) (538618b)
• Add MCP server icon support (SEP-973) v2.20.0 (czlonkowski#333) (5881304)
• Add Session Lifecycle Events and Retry Policy (Phase 3 + 4) (085f6db)
• Implement session persistence for v2.19.0 (Phase 1 + Phase 2) (1d34ad8)
• Add library usage support for multi-tenant deployments (6256105)
• Add environment-aware debugging to diagnostic tools (275e4f8)
• Add Docker/cloud environment detection to telemetry (v2.18.1) (914805f)
• Replace placeholder benchmarks with meaningful MCP tool performance tests (cf3c66c)
• Add TypeScript type safety with strategic any assertions (v2.17.5) (f3164e2)
• Add comprehensive AI Agents guide and deprecate list_ai_tools (59ae78f)
• Add canonical AI tool examples for search_nodes includeExamples (cb224de)
• Implement comprehensive AI node validation (Phase 1) (2627028)
• Implement security audit fixes - rate limiting and SSRF protection (Issue czlonkowski#265 PR czlonkowski#2) (06cbb40)
• Implement smart parameters (branch, case) for multi-output nodes (Phase 1, Task 2) (ee125c5)
• Implement rewireConnection operation (Phase 1, Task 1) (f9194ee)
• Implement Phase 8 integration tests for system tools (69f3a31)
• Implement Phase 7 integration tests for execution management (abc6a31)
• Implement Phase 6B integration tests for workflow autofix (6e04246)
• Implement Phase 6A integration tests (workflow validation) (3331b72)
• Implement Phase 5 integration tests (workflow management) (1cfbdc3)
• Implement Phase 4 integration tests for workflow updates (73db3df)
• Implement integration testing foundation (Phase 1) (2305aaa)
• Enhance webhook error messages with execution guidance (64b9cf4)
• Add intelligent execution data filtering to n8n_get_execution tool (ec0d2e8)
• Add workflow cleanup and recovery operations (v2.14.4) (34cb8f8)
• Enhance template sanitization and prevent secret leaks (d862f49)
• Add incremental template updates and fix metadata generation (fff47f9)
• Implement anonymous telemetry system with Supabase integration (09e69df)
• Add anonymous telemetry system with Supabase integration (5960d28)
• Add operation and resource validation with intelligent suggestions (f6160d4)
• Remove unnecessary 5-operation limit from n8n_update_partial_workflow (60f78d5)
• Implement webhook path autofixer and improve node similarity service (0c31f12)
• Add intelligent node type suggestions and auto-fix capability (11df329)
• Implement comprehensive expression format validation system (14bd0f5)
• Implement multi-tenant support with dynamic tool registration (f237fad)
• Implement code review improvements for flexible instance configuration (34c7f75)
• Add flexible instance configuration support with security improvements (34fbdc3)
• Add optional fields parameter to search_templates tool (abc226f)
• Add template metadata generation and smart discovery (1e586c0)
• Add structured template metadata generation with OpenAI (6e24da7)
• Implement fuzzy node type matching for template discovery (b4021ac)
• Enhance template tooling with pagination and flexible retrieval (e7895d2)
• Implement template compression and view count filtering (f35097e)

🐛 Bug Fixes

• Resolve empty settings validation error in workflow updates (czlonkowski#431) (czlonkowski#432) (fc37907)
• Eliminate stack overflow in session removal (czlonkowski#427) (czlonkowski#428) (5575630)
• Add structural hash tracking for workflow mutations (czlonkowski#422) (1bbfaab)
• Critical telemetry improvements for data quality and security (czlonkowski#421) (597bd29)
• AI Agent validator not executing due to nodeType format mismatch (Critical) (8728a80)
• Add helpful error messages for 'changes' vs 'updates' parameter (Issue czlonkowski#392) (a66cb18)
• Add missing typeVersion to workflow activation test nodes (08a4be8)
• Remove outdated "Cannot activate" limitation from test expectations (4d3b8fb)
• Update test expectations for workflow activation response format (5688384)
• Gracefully handle FTS5 unavailability in sql.js fallback (czlonkowski#398) (a4ef1ef)
• Resolve Docker port configuration mismatch (Issue czlonkowski#228) (czlonkowski#373) (590dc08)
• Resolve release workflow YAML parsing errors with script-based approach (b230042)
• Remove emoji from heredoc in release workflow to fix YAML parsing (79ef853)
• Sync package.runtime.json to match package.json version 2.22.4 (czlonkowski#368) (2682be3)
• Sync package.runtime.json to match package.json version 2.22.4 (9f29115)
• Add defensive response validation for n8n API list operations (issue czlonkowski#349) (817bf7d)
• Address code review findings for HTTP Request validation (ced7faf)
• Update test expectations for validateOnly mode to include warnings field (95ea6ca)
• Pass warnings through MCP handler to user (a4c7e09)
• Add warnings for If/Switch node connection parameters (issue czlonkowski#360) (0778c55)
• Resolve YAML syntax error in release.yml workflow (952a97e)
• Resolve flaky test failures in timing and performance tests (c52a3dd)
• TypeScript compilation errors in test-automator generated tests (bc156fc)
• Add commit-based release notes to GitHub releases (czlonkowski#355) (0e26ea6)
• Exclude version upgrade fixes in "no fixable issues" test (1bfbf05)
• Mock getNodeVersions in workflow-auto-fixer tests (5ea00e1)
• AI node connection validation in partial workflow updates (czlonkowski#357) (czlonkowski#358) (5702a64)
• Recognize all trigger node types including executeWorkflowTrigger (czlonkowski#351) (czlonkowski#352) (eac4e67)
• Sticky notes validation - eliminate false positives in workflow updates (czlonkowski#350) (c76ffd9)
• Add missing tslib dependency to fix npx installation failures (czlonkowski#342) (czlonkowski#347) (32a25e2)
• Reduce validation false positives from 80% to 0% (czlonkowski#346) (ab6b554)
• Add structuredContent to HTTP wrapper for validation tools (czlonkowski#343) (ef1cf74)
• Clarified n8n_update_partial_workflow instructions in system message (czlonkowski#336) (41830c8)
• Critical memory leak in sql.js adapter (fixes czlonkowski#330) (czlonkowski#335) (0d2d9bd)
• Prevent Docker multi-arch race condition (fixes czlonkowski#328) (czlonkowski#334) (05f68b8)
• Implement warm start pattern for session restoration (v2.19.5) (czlonkowski#320) (fe13091)
• Reconnect transport layer during session restoration (v2.19.3) (czlonkowski#317) (112b401)
• Emit onSessionCreated event during standard initialize flow (czlonkowski#315) (aa8a6a7)
• Skip FTS5 validation for sql.js databases in Docker (ee99cb7)
• Add missing export fields to package.runtime.json and refactor createSession (b67d6ba)
• Resolve session lifecycle retry test failures (3ba5584)
• Update session-management-api tests for relaxed validation (be0211d)
• Relax session ID validation for MCP proxy compatibility (0d71a16)
• Add library export fields to npm package (main, types, exports) (54c5987)
• Update session validation tests to match relaxed validation behavior (275e573)
• Update test to match new Google Sheets validation logic (c580a3d)
• Enable schema-based resourceLocator mode validation (fc8fb66)
• Add edge case handling and test coverage for schema-based validation (4625ebf)
• Migrate resourceLocator validation to schema-driven approach (czlonkowski#304, czlonkowski#306) (43dea68)
• Update handleHealthCheck test for environment-aware debugging (34811ea)
• Resolve test failures with database rebuild and performance threshold adjustments (52c9902)
• Docker-config test - set MCP_MODE=http for detached container (b8227ff)
• Docker entrypoint test - set MCP_MODE=http for detached container (f61fd9b)
• Resolve SQL parsing for triggers in schema initialization (f072b2e)
• Add FTS5 search index to prevent 69% search failure rate (v2.18.5) (cfd2325)
• Resolve sql.js adapter bypass in NodeRepository constructor (Issue czlonkowski#296) (36eb8e3)
• Critical safety fixes for startup error logging (v2.18.3) (6479ac2)
• Restore 'won't be used' phrase in validation warnings for clarity (ae11738)
• Resolve validation warning system false positives (96.5% noise reduction) (6e36571)
• Resolve CI/CD release pipeline failures and optimize workflow (2113714)
• Handle baseDescription fallback for all node types in parsers (dd521d0)
• Update langchain validation test to reflect v2.17.4 behavior (331883f)
• Correct version extraction and typeVersion validation for langchain nodes (b986bee)
• Add validation for resourceLocator properties in AI model nodes (e95ac7c)
• Handle null/invalid nodes_used in metadata generation (d2a250e)
• Correct CHANGELOG date to 2025-10-07 (de95fb2)
• Docker/cloud telemetry user ID stability (v2.17.1) (2bcd7c7)
• Expression validation for langchain nodes - skip node repo and expression validation (36dc8b4)
• Skip ALL node repository validation for langchain nodes (correct placement) (1ad2c6f)
• Skip node repository lookup for langchain nodes (28cff8c)
• Update unit tests for Calculator and Think tool validators (0818b4d)
• Resolve remaining AI validation integration test failures (5e2a6bd)
• Correct error code access path in integration tests (ec9d8fd)
• Resolve TypeScript compilation errors in integration tests (ddc4de8)
• Standardize error codes and parameter names in AI tool validators (c67659a)
• Get_node_essentials examples now use consistent workflowNodeType (MEDIUM-02) (81dfbbb)
• Resolve node type normalization bug blocking all AI validation (HIGH-01, HIGH-04, HIGH-08) (92eb4ef)
• Resolve TypeScript compilation blockers in AI validation tests (Phase 1) (91ad084)
• Address code review Priority 1 fixes for AI validation (225bb06)
• Skip rate-limiting integration tests due to CI server...

Release v2.10.4

Release v2.10.4

Updated

• n8n Dependencies: Updated to latest versions for compatibility and new features
  • n8n: 1.105.2 → 1.106.3
  • n8n-core: 1.104.1 → 1.105.3
  • n8n-workflow: 1.102.1 → 1.103.3
  • @n8n/n8n-nodes-langchain: 1.104.1 → 1.105.3
• Node Database: Rebuilt with 535 nodes from updated n8n packages
• All 1,728 tests passing with updated dependencies

---

Installation

NPM Package

# Install globally
npm install -g n8n-mcp

# Or run directly
npx n8n-mcp

Docker

# Standard image
docker run -p 3000:3000 ghcr.io/czlonkowski/n8n-mcp:v2.10.4

# Railway optimized
docker run -p 3000:3000 ghcr.io/czlonkowski/n8n-mcp-railway:v2.10.4

Documentation

• Installation Guide
• Docker Deployment
• n8n Integration
• Complete Changelog

🤖 Generated with Claude Code

Release v2.10.3

Release v2.10.3

Fixed

• Validation System Robustness: Fixed multiple critical validation issues affecting AI agents and workflow validation (fixes czlonkowski#58, czlonkowski#68, czlonkowski#70, czlonkowski#73)
  • Issue czlonkowski#73: Fixed validate_node_minimal crash when config is undefined
    • Added safe property access with optional chaining (config?.resource)
    • Tool now handles undefined, null, and malformed configs gracefully
  • Issue czlonkowski#58: Fixed validate_node_operation crash on invalid nodeType
    • Added type checking before calling string methods
    • Prevents "Cannot read properties of undefined (reading 'replace')" error
  • Issue czlonkowski#70: Fixed validation profile settings being ignored
    • Extended profile parameter to all validation phases (nodes, connections, expressions)
    • Added Sticky Notes filtering to reduce false positives
    • Enhanced cycle detection to allow legitimate loops (SplitInBatches)
  • Issue czlonkowski#68: Added error recovery suggestions for AI agents
    • New addErrorRecoverySuggestions() method provides actionable recovery steps
    • Categorizes errors and suggests specific fixes for each type
    • Helps AI agents self-correct when validation fails

Added

• Input Validation System: Comprehensive validation for all MCP tool inputs
  • Created validation-schemas.ts with custom validation utilities
  • No external dependencies - pure TypeScript implementation
  • Tool-specific validation schemas for all MCP tools
  • Clear error messages with field-level details
• Enhanced Cycle Detection: Improved detection of legitimate loops vs actual cycles
  • Recognizes SplitInBatches loop patterns as valid
  • Reduces false positive cycle warnings
• Comprehensive Test Suite: Added 16 tests covering all validation fixes
  • Tests for crash prevention with malformed inputs
  • Tests for profile behavior across validation phases
  • Tests for error recovery suggestions
  • Tests for legitimate loop patterns

Enhanced

• Validation Profiles: Now consistently applied across all validation phases
  • minimal: Reduces warnings for basic validation
  • runtime: Standard validation for production workflows
  • ai-friendly: Optimized for AI agent workflow creation
  • strict: Maximum validation for critical workflows
• Error Messages: More helpful and actionable for both humans and AI agents
  • Specific recovery suggestions for common errors
  • Clear guidance on fixing validation issues
  • Examples of correct configurations

---

Installation

NPM Package

# Install globally
npm install -g n8n-mcp

# Or run directly
npx n8n-mcp

Docker

# Standard image
docker run -p 3000:3000 ghcr.io/czlonkowski/n8n-mcp:v2.10.3

# Railway optimized
docker run -p 3000:3000 ghcr.io/czlonkowski/n8n-mcp-railway:v2.10.3

Documentation

• Installation Guide
• Docker Deployment
• n8n Integration
• Complete Changelog

🤖 Generated with Claude Code