diff --git a/CHANGELOG.md b/CHANGELOG.md
index f071d58..792dfa8 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -55,3 +55,9 @@
 
 - **Backward Compatibility Syntax** - `mcp-cli server/tool [args]` now errors with helpful message
 - **`--json` and `--raw` options** - Output format now automatic based on command
+
+## [0.3.1] - 2026-03-05
+
+### Fixed
+
+- Documentation improvements
diff --git a/README.md b/README.md
index 4d1c6a3..9aa3022 100644
--- a/README.md
+++ b/README.md
@@ -10,9 +10,9 @@ A lightweight, Bun-based CLI for interacting with [MCP (Model Context Protocol)]
 - 🤖 **Agent-Optimized** - Designed for AI coding agents (Gemini CLI, Claude Code, etc.)
 - 🔌 **Universal** - Supports both stdio and HTTP MCP servers
 - ⚡ **Connection Pooling** - Lazy-spawn daemon keeps connections warm (60s idle timeout)
-- � **Tool Filtering** - Allow/disable specific tools per server via config
+- 🧰 **Tool Filtering** - Allow/disable specific tools per server via config
 - 📋 **Server Instructions** - Display MCP server instructions in output
-- �💡 **Actionable Errors** - Structured error messages with available servers and recovery suggestions
+- 💡 **Actionable Errors** - Structured error messages with available servers and recovery suggestions
 
 ![mcp-cli](./comparison.jpeg)
 
@@ -24,10 +24,10 @@ A lightweight, Bun-based CLI for interacting with [MCP (Model Context Protocol)]
 curl -fsSL https://raw.githubusercontent.com/philschmid/mcp-cli/main/install.sh | bash
 ```
 
-or 
+or
 
 ```bash
-# requires bun install
+# requires Bun to be installed
 bun install -g https://github.com/philschmid/mcp-cli
 ```
 
@@ -276,7 +276,7 @@ fi
 
 ### Config File Format
 
-The CLI uses `mcp_servers.json`, compatible with Claude Desktop, Gemini or VS Code:
+The CLI uses `mcp_servers.json`, compatible with Claude Desktop, Gemini, or VS Code:
 
 ```json
 {