Release v2.11.0

Added

• Comprehensive Template Pagination: All template search and list tools now return paginated responses
  • Consistent PaginatedResponse format with items, total, limit, offset, and hasMore fields
  • Customizable limits (1-100) and offset parameters for all template tools
  • Count methods for accurate pagination information across all template queries
• New list_templates Tool: Efficient browsing of all available templates
  • Returns minimal data (id, name, views, nodeCount) for quick overview
  • Supports sorting by views, created_at, or name
  • Optimized for discovering templates without downloading full workflow data
• Flexible Template Retrieval Modes: Enhanced get_template with three response modes
  • nodes_only: Returns just node types and names (minimal tokens)
  • structure: Returns nodes with positions and connections (moderate detail)
  • full: Returns complete workflow JSON (default, maximum detail)
  • Reduces token usage by 80-90% in minimal modes

Enhanced

• Template Database Compression: Implemented gzip compression for workflow JSONs
  • Workflow data compressed from ~75MB to 12.10MB (84% reduction)
  • Database size reduced from 117MB to 48MB despite 5x more templates
  • Transparent compression/decompression with base64 encoding
  • No API changes - compression is handled internally
• Template Quality Filtering: Automatic filtering of low-quality templates
  • Templates with ≤10 views are excluded from the database
  • Expanded coverage from 499 to 2,596 high-quality templates (5x increase)
  • Filtered 4,505 raw templates down to 2,596 based on popularity
  • Ensures AI agents work with proven, valuable workflows
• Enhanced Database Statistics: Template metrics now included
  • Shows total template count, average/min/max views
  • Provides complete database overview including template coverage

Performance

• Database Optimization: 59% size reduction while storing 5x more content
  • Previous: ~40MB database with 499 templates
  • Current: ~48MB database with 2,596 templates
  • Without compression would be ~120MB+
• Token Efficiency: 80-90% reduction in response size for minimal queries
  • list_templates: ~10 tokens per template vs 100+ for full data
  • get_template with nodes_only: Returns just essential node information
  • Pagination prevents overwhelming responses for large result sets

Fixed

• Test Suite Compatibility: Updated all tests for new template system
  • Fixed parameter validation tests to expect new method signatures
  • Updated integration tests to use templates with >10 views
  • Removed redundant test files that were testing at wrong abstraction level
  • All 1,700+ tests now passing

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.11.0

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

Documentation

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

🤖 Generated with Claude Code