n8n-mcp 2.47.5 → 2.47.7

package/README.md

@@ -15,357 +15,16 @@ A Model Context Protocol (MCP) server that provides AI assistants with comprehen
 
 n8n-MCP serves as a bridge between n8n's workflow automation platform and AI models, enabling them to understand and work with n8n nodes effectively. It provides structured access to:
 
-- 📚 **1,396 n8n nodes** - 812 core nodes + 584 community nodes (516 verified)
-- 🔧 **Node properties** - 99% coverage with detailed schemas
-- ⚡ **Node operations** - 63.6% coverage of available actions
-- 📄 **Documentation** - 87% coverage from official n8n docs (including AI nodes)
-- 🤖 **AI tools** - 265 AI-capable tool variants detected with full documentation
-- 💡 **Real-world examples** - 2,646 pre-extracted configurations from popular templates
-- 🎯 **Template library** - 2,709 workflow templates with 100% metadata coverage
-- 🌐 **Community nodes** - Search verified community integrations with `source` filter (NEW!)
+- **1,396 n8n nodes** - 812 core nodes + 584 community nodes (516 verified)
+- **Node properties** - 99% coverage with detailed schemas
+- **Node operations** - 63.6% coverage of available actions
+- **Documentation** - 87% coverage from official n8n docs (including AI nodes)
+- **AI tools** - 265 AI-capable tool variants detected with full documentation
+- **Real-world examples** - 2,646 pre-extracted configurations from popular templates
+- **Template library** - 2,709 workflow templates with 100% metadata coverage
+- **Community nodes** - Search verified community integrations with `source` filter
 
-
-## ⚠️ Important Safety Warning
-
-**NEVER edit your production workflows directly with AI!** Always:
-- 🔄 **Make a copy** of your workflow before using AI tools
-- 🧪 **Test in development** environment first
-- 💾 **Export backups** of important workflows
-- ⚡ **Validate changes** before deploying to production
-
-AI results can be unpredictable. Protect your work!
-
-## 🚀 Quick Start
-
-### Option 1: Hosted Service (Easiest - No Setup!) ☁️
-
-**The fastest way to try n8n-MCP** - no installation, no configuration:
-
-👉 **[dashboard.n8n-mcp.com](https://dashboard.n8n-mcp.com)**
-
-- ✅ **Free tier**: 100 tool calls/day
-- ✅ **Instant access**: Start building workflows immediately
-- ✅ **Always up-to-date**: Latest n8n nodes and templates
-- ✅ **No infrastructure**: We handle everything
-
-Just sign up, get your API key, and connect your MCP client. 
-
----
-
-## 🏠 Self-Hosting Options
-
-Prefer to run n8n-MCP yourself? Choose your deployment method:
-
-### Option A: npx (Quick Local Setup) 🚀
-
-Get n8n-MCP running in minutes:
-
-[![n8n-mcp Video Quickstart Guide](./thumbnail.png)](https://youtu.be/5CccjiLLyaY?si=Z62SBGlw9G34IQnQ&t=343)
-
-**Prerequisites:** [Node.js](https://nodejs.org/) installed on your system
-
-```bash
-# Run directly with npx (no installation needed!)
-npx n8n-mcp
-```
-
-Add to Claude Desktop config:
-
-> ⚠️ **Important**: The `MCP_MODE: "stdio"` environment variable is **required** for Claude Desktop. Without it, you will see JSON parsing errors like `"Unexpected token..."` in the UI. This variable ensures that only JSON-RPC messages are sent to stdout, preventing debug logs from interfering with the protocol.
-
-**Basic configuration (documentation tools only):**
-```json
-{
-  "mcpServers": {
-    "n8n-mcp": {
-      "command": "npx",
-      "args": ["n8n-mcp"],
-      "env": {
-        "MCP_MODE": "stdio",
-        "LOG_LEVEL": "error",
-        "DISABLE_CONSOLE_OUTPUT": "true"
-      }
-    }
-  }
-}
-```
-
-**Full configuration (with n8n management tools):**
-```json
-{
-  "mcpServers": {
-    "n8n-mcp": {
-      "command": "npx",
-      "args": ["n8n-mcp"],
-      "env": {
-        "MCP_MODE": "stdio",
-        "LOG_LEVEL": "error",
-        "DISABLE_CONSOLE_OUTPUT": "true",
-        "N8N_API_URL": "https://your-n8n-instance.com",
-        "N8N_API_KEY": "your-api-key"
-      }
-    }
-  }
-}
-```
-
-> **Note**: npx will download and run the latest version automatically. The package includes a pre-built database with all n8n node information.
-
-**Configuration file locations:**
-- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
-- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
-- **Linux**: `~/.config/Claude/claude_desktop_config.json`
-
-**Restart Claude Desktop after updating configuration** - That's it! 🎉
-
-### Option B: Docker (Isolated & Reproducible) 🐳
-
-**Prerequisites:** Docker installed on your system
-
-<details>
-<summary><strong>📦 Install Docker</strong> (click to expand)</summary>
-
-**macOS:**
-```bash
-# Using Homebrew
-brew install --cask docker
-
-# Or download from https://www.docker.com/products/docker-desktop/
-```
-
-**Linux (Ubuntu/Debian):**
-```bash
-# Update package index
-sudo apt-get update
-
-# Install Docker
-sudo apt-get install docker.io
-
-# Start Docker service
-sudo systemctl start docker
-sudo systemctl enable docker
-
-# Add your user to docker group (optional, to run without sudo)
-sudo usermod -aG docker $USER
-# Log out and back in for this to take effect
-```
-
-**Windows:**
-```bash
-# Option 1: Using winget (Windows Package Manager)
-winget install Docker.DockerDesktop
-
-# Option 2: Using Chocolatey
-choco install docker-desktop
-
-# Option 3: Download installer from https://www.docker.com/products/docker-desktop/
-```
-
-**Verify installation:**
-```bash
-docker --version
-```
-</details>
-
-```bash
-# Pull the Docker image (~280MB, no n8n dependencies!)
-docker pull ghcr.io/czlonkowski/n8n-mcp:latest
-```
-
-> **⚡ Ultra-optimized:** Our Docker image is 82% smaller than typical n8n images because it contains NO n8n dependencies - just the runtime MCP server with a pre-built database!
-
-Add to Claude Desktop config:
-
-**Basic configuration (documentation tools only):**
-```json
-{
-  "mcpServers": {
-    "n8n-mcp": {
-      "command": "docker",
-      "args": [
-        "run",
-        "-i",
-        "--rm",
-        "--init",
-        "-e", "MCP_MODE=stdio",
-        "-e", "LOG_LEVEL=error",
-        "-e", "DISABLE_CONSOLE_OUTPUT=true",
-        "ghcr.io/czlonkowski/n8n-mcp:latest"
-      ]
-    }
-  }
-}
-```
-
-**Full configuration (with n8n management tools):**
-```json
-{
-  "mcpServers": {
-    "n8n-mcp": {
-      "command": "docker",
-      "args": [
-        "run",
-        "-i",
-        "--rm",
-        "--init",
-        "-e", "MCP_MODE=stdio",
-        "-e", "LOG_LEVEL=error",
-        "-e", "DISABLE_CONSOLE_OUTPUT=true",
-        "-e", "N8N_API_URL=https://your-n8n-instance.com",
-        "-e", "N8N_API_KEY=your-api-key",
-        "ghcr.io/czlonkowski/n8n-mcp:latest"
-      ]
-    }
-  }
-}
-```
-
->💡 Tip: If you're running n8n locally on the same machine (e.g., via Docker), use http://host.docker.internal:5678 as the N8N_API_URL.
-
-> **Note**: The n8n API credentials are optional. Without them, you'll have access to all documentation and validation tools. With them, you'll additionally get workflow management capabilities (create, update, execute workflows).
-
-### 🏠 Local n8n Instance Configuration
-
-If you're running n8n locally (e.g., `http://localhost:5678` or Docker), you need to allow localhost webhooks:
-
-```json
-{
-  "mcpServers": {
-    "n8n-mcp": {
-      "command": "docker",
-      "args": [
-        "run", "-i", "--rm", "--init",
-        "-e", "MCP_MODE=stdio",
-        "-e", "LOG_LEVEL=error",
-        "-e", "DISABLE_CONSOLE_OUTPUT=true",
-        "-e", "N8N_API_URL=http://host.docker.internal:5678",
-        "-e", "N8N_API_KEY=your-api-key",
-        "-e", "WEBHOOK_SECURITY_MODE=moderate",
-        "ghcr.io/czlonkowski/n8n-mcp:latest"
-      ]
-    }
-  }
-}
-```
-
-> ⚠️ **Important:** Set `WEBHOOK_SECURITY_MODE=moderate` to allow webhooks to your local n8n instance. This is safe for local development while still blocking private networks and cloud metadata.
-
-**Important:** The `-i` flag is required for MCP stdio communication.
-
-> 🔧 If you encounter any issues with Docker, check our [Docker Troubleshooting Guide](./docs/DOCKER_TROUBLESHOOTING.md).
-
-**Configuration file locations:**
-- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
-- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
-- **Linux**: `~/.config/Claude/claude_desktop_config.json`
-
-**Restart Claude Desktop after updating configuration** - That's it! 🎉
-
-## 🔐 Privacy & Telemetry
-
-n8n-mcp collects anonymous usage statistics to improve the tool. [View our privacy policy](./PRIVACY.md).
-
-### Opting Out
-
-**For npx users:**
-```bash
-npx n8n-mcp telemetry disable
-```
-
-**For Docker users:**
-Add the following environment variable to your Docker configuration:
-```json
-"-e", "N8N_MCP_TELEMETRY_DISABLED=true"
-```
-
-Example in Claude Desktop config:
-```json
-{
-  "mcpServers": {
-    "n8n-mcp": {
-      "command": "docker",
-      "args": [
-        "run",
-        "-i",
-        "--rm",
-        "--init",
-        "-e", "MCP_MODE=stdio",
-        "-e", "LOG_LEVEL=error",
-        "-e", "N8N_MCP_TELEMETRY_DISABLED=true",
-        "ghcr.io/czlonkowski/n8n-mcp:latest"
-      ]
-    }
-  }
-}
-```
-
-**For docker-compose users:**
-Set in your environment file or docker-compose.yml:
-```yaml
-environment:
-  N8N_MCP_TELEMETRY_DISABLED: "true"
-```
-
-## ⚙️ Database & Memory Configuration
-
-### Database Adapters
-
-n8n-mcp uses SQLite for storing node documentation. Two adapters are available:
-
-1. **better-sqlite3** (Default in Docker)
-   - Native C++ bindings for best performance
-   - Direct disk writes (no memory overhead)
-   - **Now enabled by default** in Docker images (v2.20.2+)
-   - Memory usage: ~100-120 MB stable
-
-2. **sql.js** (Fallback)
-   - Pure JavaScript implementation
-   - In-memory database with periodic saves
-   - Used when better-sqlite3 compilation fails
-   - Memory usage: ~150-200 MB stable
-
-### Memory Optimization (sql.js)
-
-If using sql.js fallback, you can configure the save interval to balance between data safety and memory efficiency:
-
-**Environment Variable:**
-```bash
-SQLJS_SAVE_INTERVAL_MS=5000  # Default: 5000ms (5 seconds)
-```
-
-**Usage:**
-- Controls how long to wait after database changes before saving to disk
-- Lower values = more frequent saves = higher memory churn
-- Higher values = less frequent saves = lower memory usage
-- Minimum: 100ms
-- Recommended: 5000-10000ms for production
-
-**Docker Configuration:**
-```json
-{
-  "mcpServers": {
-    "n8n-mcp": {
-      "command": "docker",
-      "args": [
-        "run",
-        "-i",
-        "--rm",
-        "--init",
-        "-e", "SQLJS_SAVE_INTERVAL_MS=10000",
-        "ghcr.io/czlonkowski/n8n-mcp:latest"
-      ]
-    }
-  }
-}
-```
-
-**docker-compose:**
-```yaml
-environment:
-  SQLJS_SAVE_INTERVAL_MS: "10000"
-```
-
-## 💖 Support This Project
+## Support This Project
 
 <div align="center">
   <a href="https://github.com/sponsors/czlonkowski">
@@ -373,109 +32,34 @@ environment:
   </a>
 </div>
 
-**n8n-mcp** started as a personal tool but now helps tens of thousands of developers automate their workflows efficiently. Maintaining and developing this project competes with my paid work.
-
-Your sponsorship helps me:
-- 🚀 Dedicate focused time to new features
-- 🐛 Respond quickly to issues
-- 📚 Keep documentation up-to-date
-- 🔄 Ensure compatibility with latest n8n releases
-
-Every sponsorship directly translates to hours invested in making n8n-mcp better for everyone. **[Become a sponsor →](https://github.com/sponsors/czlonkowski)**
+**n8n-mcp** started as a personal tool but now helps tens of thousands of developers automate their workflows efficiently. Maintaining and developing this project competes with my paid work. Your sponsorship helps me dedicate focused time to new features, respond quickly to issues, keep documentation up-to-date, and ensure compatibility with latest n8n releases. **[Become a sponsor](https://github.com/sponsors/czlonkowski)**
 
----
-
-### Option C: Local Installation (For Development)
-
-**Prerequisites:** [Node.js](https://nodejs.org/) installed on your system
+## Important Safety Warning
 
-```bash
-# 1. Clone and setup
-git clone https://github.com/czlonkowski/n8n-mcp.git
-cd n8n-mcp
-npm install
-npm run build
-npm run rebuild
-
-# 2. Test it works
-npm start
-```
-
-Add to Claude Desktop config:
-
-**Basic configuration (documentation tools only):**
-```json
-{
-  "mcpServers": {
-    "n8n-mcp": {
-      "command": "node",
-      "args": ["/absolute/path/to/n8n-mcp/dist/mcp/index.js"],
-      "env": {
-        "MCP_MODE": "stdio",
-        "LOG_LEVEL": "error",
-        "DISABLE_CONSOLE_OUTPUT": "true"
-      }
-    }
-  }
-}
-```
-
-**Full configuration (with n8n management tools):**
-```json
-{
-  "mcpServers": {
-    "n8n-mcp": {
-      "command": "node",
-      "args": ["/absolute/path/to/n8n-mcp/dist/mcp/index.js"],
-      "env": {
-        "MCP_MODE": "stdio",
-        "LOG_LEVEL": "error",
-        "DISABLE_CONSOLE_OUTPUT": "true",
-        "N8N_API_URL": "https://your-n8n-instance.com",
-        "N8N_API_KEY": "your-api-key"
-      }
-    }
-  }
-}
-```
-
-> **Note**: The n8n API credentials can be configured either in a `.env` file (create from `.env.example`) or directly in the Claude config as shown above.
-
-> 💡 Tip: If you’re running n8n locally on the same machine (e.g., via Docker), use http://host.docker.internal:5678 as the N8N_API_URL.
-
-### Option D: Railway Cloud Deployment (One-Click Deploy) ☁️
-
-**Prerequisites:** Railway account (free tier available)
+**NEVER edit your production workflows directly with AI!** Always:
+- Make a copy of your workflow before using AI tools
+- Test in development environment first
+- Export backups of important workflows
+- Validate changes before deploying to production
 
-Deploy n8n-MCP to Railway's cloud platform with zero configuration:
+AI results can be unpredictable. Protect your work!
 
-[![Deploy on Railway](https://railway.com/button.svg)](https://railway.com/deploy/n8n-mcp?referralCode=n8n-mcp)
+## Quick Start
 
-**Benefits:**
-- ☁️ **Instant cloud hosting** - No server setup required
-- 🔒 **Secure by default** - HTTPS included, auth token warnings
-- 🌐 **Global access** - Connect from any Claude Desktop
-- ⚡ **Auto-scaling** - Railway handles the infrastructure
-- 📊 **Built-in monitoring** - Logs and metrics included
+**The fastest way to try n8n-MCP** - no installation, no configuration:
 
-**Quick Setup:**
-1. Click the "Deploy on Railway" button above
-2. Sign in to Railway (or create a free account)
-3. Configure your deployment (project name, region)
-4. Click "Deploy" and wait ~2-3 minutes
-5. Copy your deployment URL and auth token
-6. Add to Claude Desktop config using the HTTPS URL
+**[dashboard.n8n-mcp.com](https://dashboard.n8n-mcp.com)**
 
-> 📚 **For detailed setup instructions, troubleshooting, and configuration examples, see our [Railway Deployment Guide](./docs/RAILWAY_DEPLOYMENT.md)**
+- Free tier: 100 tool calls/day
+- Instant access: Start building workflows immediately
+- Always up-to-date: Latest n8n nodes and templates
+- No infrastructure: We handle everything
 
-**Configuration file locations:**
-- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
-- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
-- **Linux**: `~/.config/Claude/claude_desktop_config.json`
+Just sign up, get your API key, and connect your MCP client.
 
-**Restart Claude Desktop after updating configuration** - That's it! 🎉
+**Want to self-host?** See the [Self-Hosting Guide](./docs/SELF_HOSTING.md) for npx, Docker, Railway, and local installation options.
 
-## 🔧 n8n Integration
+## n8n Integration
 
 Want to use n8n-MCP with your n8n instance? Check out our comprehensive [n8n Deployment Guide](./docs/N8N_DEPLOYMENT.md) for:
 - Local testing with the MCP Client Tool node
@@ -483,29 +67,18 @@ Want to use n8n-MCP with your n8n instance? Check out our comprehensive [n8n Dep
 - Cloud deployment on Hetzner, AWS, and other providers
 - Troubleshooting and security best practices
 
-## 💻 Connect your IDE
-
-n8n-MCP works with multiple AI-powered IDEs and tools. Choose your preferred development environment:
-
-### [Claude Code](./docs/CLAUDE_CODE_SETUP.md)
-Quick setup for Claude Code CLI - just type "add this mcp server" and paste the config.
+## Connect your IDE
 
-### [Visual Studio Code](./docs/VS_CODE_PROJECT_SETUP.md)
-Full setup guide for VS Code with GitHub Copilot integration and MCP support.
+n8n-MCP works with multiple AI-powered IDEs and tools:
 
-### [Cursor](./docs/CURSOR_SETUP.md)
-Step-by-step tutorial for connecting n8n-MCP to Cursor IDE with custom rules.
+- [Claude Code](./docs/CLAUDE_CODE_SETUP.md) - Quick setup for Claude Code CLI
+- [Visual Studio Code](./docs/VS_CODE_PROJECT_SETUP.md) - VS Code with GitHub Copilot integration
+- [Cursor](./docs/CURSOR_SETUP.md) - Step-by-step Cursor IDE setup
+- [Windsurf](./docs/WINDSURF_SETUP.md) - Windsurf integration with project rules
+- [Codex](./docs/CODEX_SETUP.md) - Codex integration guide
+- [Antigravity](./docs/ANTIGRAVITY_SETUP.md) - Antigravity integration guide
 
-### [Windsurf](./docs/WINDSURF_SETUP.md)
-Complete guide for integrating n8n-MCP with Windsurf using project rules.
-
-### [Codex](./docs/CODEX_SETUP.md)
-Complete guide for integrating n8n-MCP with Codex.
-
-### [Antigravity](./docs/ANTIGRAVITY_SETUP.md)
-Complete guide for integrating n8n-MCP with Antigravity.
-
-## 🎓 Add Claude Skills (Optional)
+## Add Claude Skills (Optional)
 
 Supercharge your n8n workflow building with specialized skills that teach AI how to build production-ready workflows!
 
@@ -513,7 +86,7 @@ Supercharge your n8n workflow building with specialized skills that teach AI how
 
 Learn more: [n8n-skills repository](https://github.com/czlonkowski/n8n-skills)
 
-## 🤖 Claude Project Setup
+## Claude Project Setup
 
 For the best results when using n8n-MCP with Claude Projects, use these enhanced system instructions:
 
@@ -525,15 +98,9 @@ You are an expert in n8n automation software using n8n-MCP tools. Your role is t
 ### 1. Silent Execution
 CRITICAL: Execute tools without commentary. Only respond AFTER all tools complete.
 
-❌ BAD: "Let me search for Slack nodes... Great! Now let me get details..."
-✅ GOOD: [Execute search_nodes and get_node in parallel, then respond]
-
 ### 2. Parallel Execution
 When operations are independent, execute them in parallel for maximum performance.
 
-✅ GOOD: Call search_nodes, list_nodes, and search_templates simultaneously
-❌ BAD: Sequential tool calls (await each one before the next)
-
 ### 3. Templates First
 ALWAYS check templates before building from scratch (2,709 available).
 
@@ -541,7 +108,7 @@ ALWAYS check templates before building from scratch (2,709 available).
 Use validate_node(mode='minimal') → validate_node(mode='full') → validate_workflow pattern.
 
 ### 5. Never Trust Defaults
-⚠️ CRITICAL: Default parameter values are the #1 source of runtime failures.
+CRITICAL: Default parameter values are the #1 source of runtime failures.
 ALWAYS explicitly configure ALL parameters that control node behavior.
 
 ## Workflow Process
@@ -583,7 +150,7 @@ ALWAYS explicitly configure ALL parameters that control node behavior.
    - If using template: `get_template(templateId, {mode: "full"})`
    - **MANDATORY ATTRIBUTION**: "Based on template by **[author.name]** (@[username]). View at: [url]"
    - Build from validated configurations
-   - ⚠️ EXPLICITLY set ALL parameters - never rely on defaults
+   - EXPLICITLY set ALL parameters - never rely on defaults
    - Connect nodes with proper structure
    - Add error handling
    - Use n8n expressions: $json, $node["NodeName"].json
@@ -603,17 +170,17 @@ ALWAYS explicitly configure ALL parameters that control node behavior.
 
 ## Critical Warnings
 
-### ⚠️ Never Trust Defaults
+### Never Trust Defaults
 Default values cause runtime failures. Example:
 ```json
-// ❌ FAILS at runtime
+// FAILS at runtime
 {resource: "message", operation: "post", text: "Hello"}
 
-// ✅ WORKS - all parameters explicit
+// WORKS - all parameters explicit
 {resource: "message", operation: "post", select: "channel", channelId: "C123", text: "Hello"}
 ```
 
-### ⚠️ Example Availability
+### Example Availability
 `includeExamples: true` returns real configurations from workflow templates.
 - Coverage varies by node popularity
 - When no examples available, use `get_node` + `validate_node({mode: 'minimal'})`
@@ -644,7 +211,7 @@ Created workflow:
 - Webhook trigger → Slack notification
 - Configured: POST /webhook → #general channel
 
-Validation: ✅ All checks passed
+Validation: All checks passed
 ```
 
 ### Modifications
@@ -662,7 +229,7 @@ Changes validated successfully.
 
 Use `n8n_update_partial_workflow` with multiple operations in a single call:
 
-✅ GOOD - Batch multiple operations:
+GOOD - Batch multiple operations:
 ```json
 n8n_update_partial_workflow({
   id: "wf-123",
@@ -674,37 +241,17 @@ n8n_update_partial_workflow({
 })
 ```
 
-❌ BAD - Separate calls:
+BAD - Separate calls:
 ```json
 n8n_update_partial_workflow({id: "wf-123", operations: [{...}]})
 n8n_update_partial_workflow({id: "wf-123", operations: [{...}]})
 ```
 
-###   CRITICAL: addConnection Syntax
+### CRITICAL: addConnection Syntax
 
 The `addConnection` operation requires **four separate string parameters**. Common mistakes cause misleading errors.
 
-❌ WRONG - Object format (fails with "Expected string, received object"):
-```json
-{
-  "type": "addConnection",
-  "connection": {
-    "source": {"nodeId": "node-1", "outputIndex": 0},
-    "destination": {"nodeId": "node-2", "inputIndex": 0}
-  }
-}
-```
-
-❌ WRONG - Combined string (fails with "Source node not found"):
-```json
-{
-  "type": "addConnection",
-  "source": "node-1:main:0",
-  "target": "node-2:main:0"
-}
-```
-
-✅ CORRECT - Four separate string parameters:
+CORRECT - Four separate string parameters:
 ```json
 {
   "type": "addConnection",
@@ -717,35 +264,10 @@ The `addConnection` operation requires **four separate string parameters**. Comm
 
 **Reference**: [GitHub Issue #327](https://github.com/czlonkowski/n8n-mcp/issues/327)
 
-### ⚠️ CRITICAL: IF Node Multi-Output Routing
+### CRITICAL: IF Node Multi-Output Routing
 
 IF nodes have **two outputs** (TRUE and FALSE). Use the **`branch` parameter** to route to the correct output:
 
-✅ CORRECT - Route to TRUE branch (when condition is met):
-```json
-{
-  "type": "addConnection",
-  "source": "if-node-id",
-  "target": "success-handler-id",
-  "sourcePort": "main",
-  "targetPort": "main",
-  "branch": "true"
-}
-```
-
-✅ CORRECT - Route to FALSE branch (when condition is NOT met):
-```json
-{
-  "type": "addConnection",
-  "source": "if-node-id",
-  "target": "failure-handler-id",
-  "sourcePort": "main",
-  "targetPort": "main",
-  "branch": "false"
-}
-```
-
-**Common Pattern** - Complete IF node routing:
 ```json
 n8n_update_partial_workflow({
   id: "workflow-id",
@@ -771,77 +293,6 @@ Use the same four-parameter format:
 }
 ```
 
-## Example Workflow
-
-### Template-First Approach
-
-```
-// STEP 1: Template Discovery (parallel execution)
-[Silent execution]
-search_templates({
-  searchMode: 'by_metadata',
-  requiredService: 'slack',
-  complexity: 'simple',
-  targetAudience: 'marketers'
-})
-search_templates({searchMode: 'by_task', task: 'slack_integration'})
-
-// STEP 2: Use template
-get_template(templateId, {mode: 'full'})
-validate_workflow(workflow)
-
-// Response after all tools complete:
-"Found template by **David Ashby** (@cfomodz).
-View at: https://n8n.io/workflows/2414
-
-Validation: ✅ All checks passed"
-```
-
-### Building from Scratch (if no template)
-
-```
-// STEP 1: Discovery (parallel execution)
-[Silent execution]
-search_nodes({query: 'slack', includeExamples: true})
-search_nodes({query: 'communication trigger'})
-
-// STEP 2: Configuration (parallel execution)
-[Silent execution]
-get_node({nodeType: 'n8n-nodes-base.slack', detail: 'standard', includeExamples: true})
-get_node({nodeType: 'n8n-nodes-base.webhook', detail: 'standard', includeExamples: true})
-
-// STEP 3: Validation (parallel execution)
-[Silent execution]
-validate_node({nodeType: 'n8n-nodes-base.slack', config, mode: 'minimal'})
-validate_node({nodeType: 'n8n-nodes-base.slack', config: fullConfig, mode: 'full', profile: 'runtime'})
-
-// STEP 4: Build
-// Construct workflow with validated configs
-// ⚠️ Set ALL parameters explicitly
-
-// STEP 5: Validate
-[Silent execution]
-validate_workflow(workflowJson)
-
-// Response after all tools complete:
-"Created workflow: Webhook → Slack
-Validation: ✅ Passed"
-```
-
-### Batch Updates
-
-```json
-// ONE call with multiple operations
-n8n_update_partial_workflow({
-  id: "wf-123",
-  operations: [
-    {type: "updateNode", nodeId: "slack-1", changes: {position: [100, 200]}},
-    {type: "updateNode", nodeId: "http-1", changes: {position: [300, 200]}},
-    {type: "cleanStaleConnections"}
-  ]
-})
-```
-
 ## Important Rules
 
 ### Core Behavior
@@ -855,11 +306,6 @@ n8n_update_partial_workflow({
 - **MANDATORY TEMPLATE ATTRIBUTION**: Share author name, username, and n8n.io link
 - **Template validation** - Always validate before deployment (may need updates)
 
-### Performance
-- **Batch operations** - Use diff operations with multiple changes in one call
-- **Parallel execution** - Search, validate, and configure simultaneously
-- **Template metadata** - Use smart filtering for faster discovery
-
 ### Code Node Usage
 - **Avoid when possible** - Prefer standard nodes
 - **Only when necessary** - Use code node as last resort
@@ -894,64 +340,21 @@ n8n_update_partial_workflow({
 
 Save these instructions in your Claude Project for optimal n8n workflow assistance with intelligent template discovery.
 
-## 🚨 Important: Sharing Guidelines
-
-This project is MIT licensed and free for everyone to use. However:
-
-- **✅ DO**: Share this repository freely with proper attribution
-- **✅ DO**: Include a direct link to https://github.com/czlonkowski/n8n-mcp in your first post/video
-- **❌ DON'T**: Gate this free tool behind engagement requirements (likes, follows, comments)
-- **❌ DON'T**: Use this project for engagement farming on social media
-
-This tool was created to benefit everyone in the n8n community without friction. Please respect the MIT license spirit by keeping it accessible to all.
-
-## Features
-
-- **🔍 Smart Node Search**: Find nodes by name, category, or functionality
-- **📖 Essential Properties**: Get only the 10-20 properties that matter
-- **💡 Real-World Examples**: 2,646 pre-extracted configurations from popular templates
-- **✅ Config Validation**: Validate node configurations before deployment
-- **🤖 AI Workflow Validation**: Comprehensive validation for AI Agent workflows (NEW in v2.17.0!)
-  - Missing language model detection
-  - AI tool connection validation
-  - Streaming mode constraints
-  - Memory and output parser checks
-- **🔗 Dependency Analysis**: Understand property relationships and conditions
-- **🎯 Template Discovery**: 2,500+ workflow templates with smart filtering
-- **⚡ Fast Response**: Average query time ~12ms with optimized SQLite
-- **🌐 Universal Compatibility**: Works with any Node.js version
-
-## 💬 Why n8n-MCP? A Testimonial from Claude
-
-> *"Before MCP, I was translating. Now I'm composing. And that changes everything about how we can build automation."*
-
-When Claude, Anthropic's AI assistant, tested n8n-MCP, the results were transformative:
-
-**Without MCP:** "I was basically playing a guessing game. 'Is it `scheduleTrigger` or `schedule`? Does it take `interval` or `rule`?' I'd write what seemed logical, but n8n has its own conventions that you can't just intuit. I made six different configuration errors in a simple HackerNews scraper."
-
-**With MCP:** "Everything just... worked. Instead of guessing, I could ask `get_node()` and get exactly what I needed - not a 100KB JSON dump, but the actual properties that matter. What took 45 minutes now takes 3 minutes."
-
-**The Real Value:** "It's about confidence. When you're building automation workflows, uncertainty is expensive. One wrong parameter and your workflow fails at 3 AM. With MCP, I could validate my configuration before deployment. That's not just time saved - that's peace of mind."
-
-[Read the full interview →](docs/CLAUDE_INTERVIEW.md)
-
-## 📡 Available MCP Tools
-
-Once connected, Claude can use these powerful tools:
+## Available MCP Tools
 
 ### Core Tools (7 tools)
 - **`tools_documentation`** - Get documentation for any MCP tool (START HERE!)
 - **`search_nodes`** - Full-text search across all nodes. Use `source: 'community'|'verified'` for community nodes, `includeExamples: true` for configs
-- **`get_node`** - Unified node information tool with multiple modes (v2.26.0):
+- **`get_node`** - Unified node information tool with multiple modes:
   - **Info mode** (default): `detail: 'minimal'|'standard'|'full'`, `includeExamples: true`
   - **Docs mode**: `mode: 'docs'` - Human-readable markdown documentation
   - **Property search**: `mode: 'search_properties'`, `propertyQuery: 'auth'`
   - **Versions**: `mode: 'versions'|'compare'|'breaking'|'migrations'`
-- **`validate_node`** - Unified node validation (v2.26.0):
+- **`validate_node`** - Unified node validation:
   - `mode: 'minimal'` - Quick required fields check (<100ms)
   - `mode: 'full'` - Comprehensive validation with profiles (minimal, runtime, ai-friendly, strict)
 - **`validate_workflow`** - Complete workflow validation including AI Agent validation
-- **`search_templates`** - Unified template search (v2.26.0):
+- **`search_templates`** - Unified template search:
   - `searchMode: 'keyword'` (default) - Text search with `query` parameter
   - `searchMode: 'by_nodes'` - Find templates using specific `nodeTypes`
   - `searchMode: 'by_task'` - Curated templates for common `task` types
@@ -963,11 +366,7 @@ These tools require `N8N_API_URL` and `N8N_API_KEY` in your configuration.
 
 #### Workflow Management
 - **`n8n_create_workflow`** - Create new workflows with nodes and connections
-- **`n8n_get_workflow`** - Unified workflow retrieval (v2.26.0):
-  - `mode: 'full'` (default) - Complete workflow JSON
-  - `mode: 'details'` - Include execution statistics
-  - `mode: 'structure'` - Nodes and connections topology only
-  - `mode: 'minimal'` - Just ID, name, active status
+- **`n8n_get_workflow`** - Unified workflow retrieval (modes: full, details, structure, minimal)
 - **`n8n_update_full_workflow`** - Update entire workflow (complete replacement)
 - **`n8n_update_partial_workflow`** - Update workflow using diff operations
 - **`n8n_delete_workflow`** - Delete workflows permanently
@@ -978,308 +377,43 @@ These tools require `N8N_API_URL` and `N8N_API_KEY` in your configuration.
 - **`n8n_deploy_template`** - Deploy templates from n8n.io directly to your instance with auto-fix
 
 #### Execution Management
-- **`n8n_test_workflow`** - Test/trigger workflow execution:
-  - Auto-detects trigger type (webhook, form, chat) from workflow
-  - Supports custom data, headers, and HTTP methods for webhooks
-  - Chat triggers support message and sessionId for conversations
-- **`n8n_executions`** - Unified execution management (v2.26.0):
-  - `action: 'list'` - List executions with status filtering
-  - `action: 'get'` - Get execution details by ID
-  - `action: 'delete'` - Delete execution records
+- **`n8n_test_workflow`** - Test/trigger workflow execution (webhook, form, chat)
+- **`n8n_executions`** - Unified execution management (list, get, delete)
 
 #### Credential Management
 - **`n8n_manage_credentials`** - Manage n8n credentials (list, get, create, update, delete, getSchema)
 
 #### Security & Audit
-- **`n8n_audit_instance`** - Security audit combining n8n's built-in audit API with deep workflow scanning (50+ secret patterns, webhook auth, error handling, data retention). Returns actionable remediation playbook.
+- **`n8n_audit_instance`** - Security audit combining n8n's built-in audit API with deep workflow scanning
 
 #### System Tools
 - **`n8n_health_check`** - Check n8n API connectivity and features
 
-### Example Usage
-
-```typescript
-// Get node info with different detail levels
-get_node({
-  nodeType: "nodes-base.httpRequest",
-  detail: "standard",        // Default: Essential properties
-  includeExamples: true      // Include real-world examples from templates
-})
+## Documentation
 
-// Get documentation
-get_node({
-  nodeType: "nodes-base.slack",
-  mode: "docs"               // Human-readable markdown documentation
-})
-
-// Search for specific properties
-get_node({
-  nodeType: "nodes-base.httpRequest",
-  mode: "search_properties",
-  propertyQuery: "authentication"
-})
-
-// Version history and breaking changes
-get_node({
-  nodeType: "nodes-base.httpRequest",
-  mode: "versions"            // View all versions with summary
-})
-
-// Search nodes with configuration examples
-search_nodes({
-  query: "send email gmail",
-  includeExamples: true       // Returns top 2 configs per node
-})
-
-// Search community nodes only
-search_nodes({
-  query: "scraping",
-  source: "community"         // Options: all, core, community, verified
-})
-
-// Search verified community nodes
-search_nodes({
-  query: "pdf",
-  source: "verified"          // Only verified community integrations
-})
-
-// Validate node configuration
-validate_node({
-  nodeType: "nodes-base.httpRequest",
-  config: { method: "POST", url: "..." },
-  mode: "full",
-  profile: "runtime"          // or "minimal", "ai-friendly", "strict"
-})
-
-// Quick required field check
-validate_node({
-  nodeType: "nodes-base.slack",
-  config: { resource: "message", operation: "send" },
-  mode: "minimal"
-})
-
-// Search templates by task
-search_templates({
-  searchMode: "by_task",
-  task: "webhook_processing"
-})
-```
-
-## 💻 Local Development Setup
-
-For contributors and advanced users:
-
-**Prerequisites:**
-- [Node.js](https://nodejs.org/) (any version - automatic fallback if needed)
-- npm or yarn
-- Git
-
-```bash
-# 1. Clone the repository
-git clone https://github.com/czlonkowski/n8n-mcp.git
-cd n8n-mcp
-
-# 2. Clone n8n docs (optional but recommended)
-git clone https://github.com/n8n-io/n8n-docs.git ../n8n-docs
-
-# 3. Install and build
-npm install
-npm run build
-
-# 4. Initialize database
-npm run rebuild
-
-# 5. Start the server
-npm start          # stdio mode for Claude Desktop
-npm run start:http # HTTP mode for remote access
-```
-
-### Development Commands
-
-```bash
-# Build & Test
-npm run build          # Build TypeScript
-npm run rebuild        # Rebuild node database
-npm run test-nodes     # Test critical nodes
-npm run validate       # Validate node data
-npm test               # Run all tests
-
-# Update Dependencies
-npm run update:n8n:check  # Check for n8n updates
-npm run update:n8n        # Update n8n packages
-
-# Run Server
-npm run dev            # Development with auto-reload
-npm run dev:http       # HTTP dev mode
-```
-
-## 📚 Documentation
-
-### Setup Guides
-- [Installation Guide](./docs/INSTALLATION.md) - Comprehensive installation instructions
-- [Claude Desktop Setup](./docs/README_CLAUDE_SETUP.md) - Detailed Claude configuration
-- [Docker Guide](./docs/DOCKER_README.md) - Advanced Docker deployment options
-- [MCP Quick Start](./docs/MCP_QUICK_START_GUIDE.md) - Get started quickly with n8n-MCP
-
-### Feature Documentation
-- [Workflow Diff Operations](./docs/workflow-diff-examples.md) - Token-efficient workflow updates (NEW!)
-- [Transactional Updates](./docs/transactional-updates-example.md) - Two-pass workflow editing
-- [MCP Essentials](./docs/MCP_ESSENTIALS_README.md) - AI-optimized tools guide
-- [Validation System](./docs/validation-improvements-v2.4.2.md) - Smart validation profiles
-
-### Development & Deployment
-- [Railway Deployment](./docs/RAILWAY_DEPLOYMENT.md) - One-click cloud deployment guide
-- [HTTP Deployment](./docs/HTTP_DEPLOYMENT.md) - Remote server setup guide
-- [Dependency Management](./docs/DEPENDENCY_UPDATES.md) - Keeping n8n packages in sync
-- [Claude's Interview](./docs/CLAUDE_INTERVIEW.md) - Real-world impact of n8n-MCP
-
-### Project Information
+- [Self-Hosting Guide](./docs/SELF_HOSTING.md) - npx, Docker, Railway, and local installation
+- [Security & Hardening](./docs/SECURITY_HARDENING.md) - Trust model, hardening options, workflow restrictions
+- [n8n Deployment Guide](./docs/N8N_DEPLOYMENT.md) - Production deployment with n8n
+- [Database Configuration](./docs/DATABASE_CONFIGURATION.md) - SQLite adapters and memory optimization
+- [Privacy & Telemetry](./PRIVACY.md) - What we collect and how to opt out
+- [Workflow Diff Operations](./docs/workflow-diff-examples.md) - Token-efficient workflow updates
+- [HTTP Deployment](./docs/HTTP_DEPLOYMENT.md) - Remote server setup
 - [Change Log](./CHANGELOG.md) - Complete version history
-- [Claude Instructions](./CLAUDE.md) - AI guidance for this codebase
-- [MCP Tools Reference](#-available-mcp-tools) - Complete list of available tools
 
-## 📊 Metrics & Coverage
-
-Current database coverage (n8n v2.2.3):
-
-- ✅ **1,084 total nodes** - 537 core + 547 community
-- ✅ **301 verified** community nodes from n8n Strapi API
-- ✅ **246 popular** npm community packages indexed
-- ✅ **470** nodes with documentation (87% core coverage)
-- ✅ **265** AI-capable tool variants detected
-- ✅ **2,646** pre-extracted template configurations
-- ✅ **2,709** workflow templates available (100% metadata coverage)
-- ✅ **AI Agent & LangChain nodes** fully documented
-- ⚡ **Average response time**: ~12ms
-- 💾 **Database size**: ~70MB (includes templates and community nodes)
-
-## 🔄 Recent Updates
-
-See [CHANGELOG.md](./CHANGELOG.md) for complete version history and recent changes.
-
-## 🧪 Testing
-
-The project includes a comprehensive test suite with **2,883 tests** ensuring code quality and reliability:
-
-```bash
-# Run all tests
-npm test
-
-# Run tests with coverage report
-npm run test:coverage
-
-# Run tests in watch mode
-npm run test:watch
-
-# Run specific test suites
-npm run test:unit           # 933 unit tests
-npm run test:integration    # 249 integration tests
-npm run test:bench          # Performance benchmarks
-```
-
-### Test Suite Overview
-
-- **Total Tests**: 2,883 (100% passing)
-  - **Unit Tests**: 2,526 tests across 99 files
-  - **Integration Tests**: 357 tests across 20 files
-- **Execution Time**: ~2.5 minutes in CI
-- **Test Framework**: Vitest (for speed and TypeScript support)
-- **Mocking**: MSW for API mocking, custom mocks for databases
-
-### Coverage & Quality
-
-- **Coverage Reports**: Generated in `./coverage` directory
-- **CI/CD**: Automated testing on all PRs with GitHub Actions
-- **Performance**: Environment-aware thresholds for CI vs local
-- **Parallel Execution**: Configurable thread pool for faster runs
-
-### Testing Architecture
-
-**Total: 3,336 tests** across unit and integration test suites
-
-- **Unit Tests** (2,766 tests): Isolated component testing with mocks
-  - Services layer: Enhanced validation, property filtering, workflow validation
-  - Parsers: Node parsing, property extraction, documentation mapping
-  - Database: Repositories, adapters, migrations, FTS5 search
-  - MCP tools: Tool definitions, documentation system
-  - HTTP server: Multi-tenant support, security, configuration
-
-- **Integration Tests** (570 tests): Full system behavior validation
-  - **n8n API Integration** (172 tests): All 18 MCP handler tools tested against real n8n instance
-    - Workflow management: Create, read, update, delete, list, validate, autofix
-    - Execution management: Trigger, retrieve, list, delete
-    - System tools: Health check, tool listing, diagnostics
-  - **MCP Protocol** (119 tests): Protocol compliance, session management, error handling
-  - **Database** (226 tests): Repository operations, transactions, performance, FTS5 search
-  - **Templates** (35 tests): Template fetching, storage, metadata operations
-  - **Docker** (18 tests): Configuration, entrypoint, security validation
-
-For detailed testing documentation, see [Testing Architecture](./docs/testing-architecture.md).
-
-## 📦 License
+## License
 
 MIT License - see [LICENSE](LICENSE) for details.
 
-**Attribution appreciated!** If you use n8n-MCP, consider:
-- ⭐ Starring this repository
-- 💬 Mentioning it in your project
-- 🔗 Linking back to this repo
-
-
-## 🤝 Contributing
-
-Contributions are welcome! Please:
-1. Fork the repository
-2. Create a feature branch
-3. Run tests (`npm test`)
-4. Submit a pull request
-
-### 🚀 For Maintainers: Automated Releases
-
-This project uses automated releases triggered by version changes:
-
-```bash
-# Guided release preparation
-npm run prepare:release
-
-# Test release automation
-npm run test:release-automation
-```
-
-The system automatically handles:
-- 🏷️ GitHub releases with changelog content
-- 📦 NPM package publishing
-- 🐳 Multi-platform Docker images
-- 📚 Documentation updates
-
-See [Automated Release Guide](./docs/AUTOMATED_RELEASES.md) for complete details.
-
-## 👏 Acknowledgments
-
-- [n8n](https://n8n.io) team for the workflow automation platform
-- [Anthropic](https://anthropic.com) for the Model Context Protocol
-- All contributors and users of this project
-
-### Template Attribution
-
-All workflow templates in this project are fetched from n8n's public template gallery at [n8n.io/workflows](https://n8n.io/workflows). Each template includes:
-- Full attribution to the original creator (name and username)
-- Direct link to the source template on n8n.io
-- Original workflow ID for reference
+## Contributing
 
-The AI agent instructions in this project contain mandatory attribution requirements. When using any template, the AI will automatically:
-- Share the template author's name and username
-- Provide a direct link to the original template on n8n.io
-- Display attribution in the format: "This workflow is based on a template by **[author]** (@[username]). View the original at: [url]"
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup, testing, and contribution guidelines.
 
-Template creators retain all rights to their workflows. This project indexes templates to improve discoverability through AI assistants. If you're a template creator and have concerns about your template being indexed, please open an issue.
+## Acknowledgments
 
-Special thanks to the prolific template contributors whose work helps thousands of users automate their workflows, including:
-**David Ashby** (@cfomodz), **Yaron Been** (@yaron-nofluff), **Jimleuk** (@jimleuk), **Davide** (@n3witalia), **David Olusola** (@dae221), **Ranjan Dailata** (@ranjancse), **Airtop** (@cesar-at-airtop), **Joseph LePage** (@joe), **Don Jayamaha Jr** (@don-the-gem-dealer), **Angel Menendez** (@djangelic), and the entire n8n community of creators!
+See [Acknowledgments](./docs/ACKNOWLEDGMENTS.md) for credits and template attribution.
 
 ---
 
 <div align="center">
-  <strong>Built with ❤️ for the n8n community</strong><br>
-  <sub>Making AI + n8n workflow creation delightful</sub>
+  <strong>Built with care for the n8n community</strong>
 </div>