diff --git a/README.md b/README.md
index 00d047a..bcf2bf3 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,8 @@
[Zen in action](https://github.com/user-attachments/assets/0d26061e-5f21-4ab1-b7d0-f883ddc2c3da)
+👉 **[Watch more examples](#-watch-tools-in-action)**
+
### Your CLI + Multiple Models = Your AI Dev Team
**Use the 🤖 CLI you love:**
@@ -189,8 +191,9 @@ cd zen-mcp-server
"clink with cli_name=\"gemini\" role=\"planner\" to draft a phased rollout plan"
```
-👉 **[Complete Setup Guide](docs/getting-started.md)** with detailed installation, configuration for Gemini / Codex / Qwen, and troubleshooting
+👉 **[Complete Setup Guide](docs/getting-started.md)** with detailed installation, configuration for Gemini / Codex / Qwen, and troubleshooting
👉 **[Cursor & VS Code Setup](docs/getting-started.md#ide-clients)** for IDE integration instructions
+📺 **[Watch tools in action](#-watch-tools-in-action)** to see real-world examples
## Provider Configuration
@@ -298,13 +301,74 @@ DISABLED_TOOLS=
}
```
-**Note:**
+**Note:**
- Essential tools (`version`, `listmodels`) cannot be disabled
- After changing tool configuration, restart your Claude session for changes to take effect
- Each tool adds to context window usage, so only enable what you need
+## 📺 Watch Tools In Action
+
+
+Chat Tool - Collaborative decision making and multi-turn conversations
+
+**Picking Redis vs Memcached:**
+
+[Chat Redis or Memcached_web.webm](https://github.com/user-attachments/assets/41076cfe-dd49-4dfc-82f5-d7461b34705d)
+
+**Multi-turn conversation with continuation:**
+
+[Chat With Gemini_web.webm](https://github.com/user-attachments/assets/37bd57ca-e8a6-42f7-b5fb-11de271e95db)
+
+
+
+
+Consensus Tool - Multi-model debate and decision making
+
+**Multi-model consensus debate:**
+
+[Zen Consensus Debate](https://github.com/user-attachments/assets/76a23dd5-887a-4382-9cf0-642f5cf6219e)
+
+
+
+
+PreCommit Tool - Comprehensive change validation
+
+**Pre-commit validation workflow:**
+
+
+

+
+
+
+
+
+API Lookup Tool - Current vs outdated API documentation
+
+**Without Zen - outdated APIs:**
+
+[API without Zen](https://github.com/user-attachments/assets/01a79dc9-ad16-4264-9ce1-76a56c3580ee)
+
+**With Zen - current APIs:**
+
+[API with Zen](https://github.com/user-attachments/assets/5c847326-4b66-41f7-8f30-f380453dce22)
+
+
+
+
+Challenge Tool - Critical thinking vs reflexive agreement
+
+**Without Zen:**
+
+
+
+**With Zen:**
+
+
+
+
+
## Key Features
**AI Orchestration**