docs: update README and documentation to match current state (v2.5.1)

- Update n8n version from v1.97.1 to v1.99.1 in README
- Fix 7 broken documentation links to point to existing files
- Standardize Docker image size to ~280MB across all docs (was inconsistent: 150MB/200MB/283MB)
- Add missing npm scripts for test commands (test:essentials, test:enhanced-validation, etc.)
- Update CHANGELOG.md with missing versions 2.4.0 through 2.5.1
- Update README_CLAUDE_SETUP.md to list all 21+ MCP tools (was only showing 6)
- Document 5 additional npm scripts in CLAUDE.md
- Update AI-capable nodes count to 263 (was 35 in old docs)

All documentation now accurately reflects the current codebase state.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

docs/CHANGELOG.md

@@ -2,6 +2,100 @@
 
 All notable changes to this project will be documented in this file.
 
+## [2.5.1] - 2025-01-25
+
+### Added
+- **AI Tool Support Enhancement**: Major improvements to AI tool integration
+  - **NEW**: `get_node_as_tool_info` tool - Get specific information about using ANY node as an AI tool
+  - **ENHANCED**: `get_node_info` now includes `aiToolCapabilities` section for all nodes
+  - **ENHANCED**: `list_ai_tools` - Added usage guidance explaining ANY node can be used as a tool
+  - **ENHANCED**: `WorkflowValidator` - Now validates `ai_tool` connections in workflows
+  - AI workflow pattern detection - Warns when AI Agents have no tools connected
+  - Community node detection - Reminds about N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE environment variable
+  - **NEW**: AI Tool TaskTemplates - Added use_google_sheets_as_tool, use_slack_as_tool, multi_tool_ai_agent
+  - Comprehensive examples showing how to connect regular nodes as AI tools
+  - Tool usage documentation with $fromAI() expression examples
+
+### Changed
+- Clarified that ANY node can be used as an AI tool, not just nodes with usableAsTool property
+- Enhanced workflow validation to understand and validate ai_tool connections
+- Improved expression validation to support $fromAI() dynamic AI parameters
+
+## [2.5.0] - 2025-01-20
+
+### Added
+- **Complete Workflow Validation**: Professional-grade workflow validation system
+  - **NEW**: `validate_workflow` tool - Validate entire workflows before deployment
+  - **NEW**: `validate_workflow_connections` tool - Check workflow structure and connections
+  - **NEW**: `validate_workflow_expressions` tool - Validate all n8n expressions in a workflow
+  - **NEW**: `ExpressionValidator` - Comprehensive n8n expression syntax validation
+  - **NEW**: `WorkflowValidator` - Complete workflow structure and logic validation
+  - Detects cycles (infinite loops) in workflows
+  - Validates node references in expressions ($node["Node Name"])
+  - Checks for orphaned nodes and missing connections
+  - Expression syntax validation with common mistake detection
+  - Workflow best practices analysis with suggestions
+  - Supports partial validation (nodes only, connections only, expressions only)
+  - Test coverage for all validation scenarios
+
+## [2.4.2] - 2025-01-15
+
+### Added
+- **Enhanced Node Configuration Validation**: Operation-aware validation with dramatic accuracy improvements
+  - **NEW**: `validate_node_operation` tool - Operation-aware validation with 80%+ fewer false positives
+  - **NEW**: `validate_node_minimal` tool - Lightning-fast validation for just required fields
+  - **NEW**: Validation profiles - Choose between minimal, runtime, ai-friendly, or strict validation
+  - **NEW**: `EnhancedConfigValidator` - Smart validation that only checks relevant properties
+  - **NEW**: Node-specific validators - Custom logic for Slack, Google Sheets, OpenAI, MongoDB, Webhook, Postgres, MySQL
+  - **NEW**: SQL safety features - Detects SQL injection risks, unsafe DELETE/UPDATE queries
+  - Added operation context filtering (only validates properties for selected operation)
+  - Integrated working examples in validation responses when errors found
+  - Added actionable next steps and auto-fix suggestions
+  - Basic code syntax validation for JavaScript/Python in Code node
+  - Dramatic improvement for complex multi-operation nodes
+  - Test results: Slack validation reduced from 45 errors to 1 error!
+
+### Removed
+- Deprecated `validate_node_config` tool in favor of new operation-aware validators
+
+## [2.4.1] - 2025-01-10
+
+### Added
+- **n8n Workflow Templates**: Integration with n8n.io template library
+  - **NEW**: `list_node_templates` tool - Find workflow templates using specific nodes
+  - **NEW**: `get_template` tool - Get complete workflow JSON for import
+  - **NEW**: `search_templates` tool - Search templates by keywords
+  - **NEW**: `get_templates_for_task` tool - Get curated templates for common tasks
+  - Added Templates system with n8n.io API integration
+  - Templates filtered to last 6 months only (freshness guarantee)
+  - Manual fetch system - not part of regular rebuild
+  - Full workflow JSON available for immediate use
+  - 10 task categories: AI automation, data sync, webhooks, etc.
+
+## [2.4.0] - 2025-01-05
+
+### Added
+- **AI-Optimized MCP Tools**: Dramatically improved AI agent experience
+  - **NEW**: `get_node_essentials` tool - Returns only 10-20 essential properties (95% size reduction)
+  - **NEW**: `search_node_properties` tool - Search for specific properties within nodes
+  - **NEW**: `get_node_for_task` tool - Pre-configured settings for 14 common tasks
+  - **NEW**: `list_tasks` tool - Discover available task templates
+  - **NEW**: `validate_node_config` tool - Validate configurations before use
+  - **NEW**: `get_property_dependencies` tool - Analyze property visibility dependencies
+  - Added PropertyFilter service with curated essential properties for 20+ nodes
+  - Added ExampleGenerator with working examples for common use cases
+  - Added TaskTemplates service with 14 pre-configured tasks
+  - Added ConfigValidator service for comprehensive validation
+  - Added PropertyDependencies service for dependency analysis
+  - Enhanced all property descriptions - 100% coverage
+  - Added version information to essentials response
+  - Response sizes reduced from 100KB+ to <5KB for common nodes
+
+### Changed
+- **License Change**: Changed from Apache 2.0 to MIT License for wider adoption
+- Fixed missing AI and LangChain node documentation
+- Improved documentation mapping for better coverage
+
 ## [2.3.3] - 2025-06-16
 
 ### Added

docs/DOCKER_README.md

@@ -39,7 +39,7 @@ curl http://localhost:3000/health
 Pre-built images are available on GitHub Container Registry:
 
 ```bash
-# Pull the latest image (~150MB optimized)
+# Pull the latest image (~280MB optimized)
 docker pull ghcr.io/czlonkowski/n8n-mcp:latest
 
 # Run with HTTP mode
@@ -434,7 +434,7 @@ secrets:
 ### Image Details
 
 - Base: `node:20-alpine`
-- Size: ~283MB compressed
+- Size: ~280MB compressed
 - Features: Pre-built database with all node information
 - Database: Complete SQLite with 525+ nodes
 - Architectures: `linux/amd64`, `linux/arm64`

docs/README_CLAUDE_SETUP.md

@@ -1,6 +1,6 @@
 # Claude Desktop Configuration for n8n-MCP
 
-This guide helps you connect n8n-MCP to Claude Desktop, giving Claude comprehensive knowledge about n8n's 525+ workflow automation nodes.
+This guide helps you connect n8n-MCP to Claude Desktop, giving Claude comprehensive knowledge about n8n's 525 workflow automation nodes, including 263 AI-capable tools.
 
 ## 🎯 Prerequisites
 
@@ -50,14 +50,13 @@ No installation needed - runs directly from Docker:
 ```json
 {
   "mcpServers": {
-    "n8n-docker": {
+    "n8n-mcp": {
       "command": "docker",
       "args": [
-        "run", "--rm", "-i",
+        "run", "-i", "--rm",
         "-e", "MCP_MODE=stdio",
         "-e", "LOG_LEVEL=error",
         "-e", "DISABLE_CONSOLE_OUTPUT=true",
-        "-v", "n8n-mcp-data:/app/data",
         "ghcr.io/czlonkowski/n8n-mcp:latest"
       ]
     }
@@ -113,23 +112,47 @@ After restarting Claude Desktop:
 2. Try asking Claude: "What n8n nodes are available for working with Slack?"
 3. Or use a tool directly: "Use the list_nodes tool to show me trigger nodes"
 
-## 🔧 Available Tools
+## 🔧 Available Tools (v2.5.1)
 
-Once connected, you can ask Claude to:
+### Essential Tool - Start Here!
+- **`start_here_workflow_guide`** - Essential guide and best practices (ALWAYS use this first!)
 
-- **List nodes**: "Show me all n8n nodes for working with databases"
-- **Get node details**: "How do I use the HTTP Request node?"
-- **Search documentation**: "Find n8n nodes that support OAuth"
-- **Find AI tools**: "What AI-capable nodes are available?"
-- **View statistics**: "Show me n8n-MCP database statistics"
+### Core Tools
+- **`list_nodes`** - List all n8n nodes with filtering options
+- **`get_node_info`** - Get comprehensive information (now includes aiToolCapabilities)
+- **`get_node_essentials`** - Get only 10-20 essential properties (95% smaller!)
+- **`search_nodes`** - Full-text search across all node documentation
+- **`search_node_properties`** - Find specific properties within nodes
+- **`get_node_documentation`** - Get parsed documentation from n8n-docs
+- **`get_database_statistics`** - View database metrics and coverage
 
-Claude will automatically use the appropriate tools:
-- `list_nodes` - Filter and list nodes
-- `get_node_info` - Get detailed node information
-- `search_nodes` - Full-text search
-- `list_ai_tools` - Find AI-capable nodes
-- `get_node_documentation` - Get official docs
-- `get_database_statistics` - View coverage metrics
+### AI Tools (Enhanced in v2.5.1)
+- **`list_ai_tools`** - List AI-capable nodes (ANY node can be used as AI tool!)
+- **`get_node_as_tool_info`** - Get guidance on using any node as an AI tool
+
+### Task & Template Tools
+- **`get_node_for_task`** - Pre-configured node settings for common tasks
+- **`list_tasks`** - Discover available task templates
+- **`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
+
+### Validation Tools (Professional Grade)
+- **`validate_node_operation`** - Smart validation with operation awareness
+- **`validate_node_minimal`** - Quick validation for just required fields
+- **`validate_workflow`** - Complete workflow validation (validates AI tool connections)
+- **`validate_workflow_connections`** - Check workflow structure
+- **`validate_workflow_expressions`** - Validate n8n expressions including $fromAI()
+- **`get_property_dependencies`** - Analyze property visibility conditions
+
+### Example Questions to Ask Claude:
+- "Show me all n8n nodes for working with databases"
+- "How do I use the HTTP Request node?"
+- "Get the essentials for Slack node" (uses get_node_essentials)
+- "How can I use Google Sheets as an AI tool?"
+- "Validate my workflow before deployment"
+- "Find templates for webhook automation"
 
 ## 🔍 Troubleshooting