diff --git a/docs/guides/publishing/publish-server.md b/docs/guides/publishing/publish-server.md
index 4ad658c6..5f4a89af 100644
--- a/docs/guides/publishing/publish-server.md
+++ b/docs/guides/publishing/publish-server.md
@@ -17,23 +17,30 @@ By the end of this tutorial, you'll have:
 
 ## Step 1: Install the Publisher CLI
 
-**macOS/Linux/WSL:**
+<details>
+<summary><strong>🍺 macOS/Linux/WSL: With Homebrew (recommended)</strong></summary>
+
+Requires [Homebrew](https://brew.sh):
 
 ```bash
-curl -L "https://github.com/modelcontextprotocol/registry/releases/download/v1.0.0/mcp-publisher_1.0.0_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher && sudo mv mcp-publisher /usr/local/bin/
+brew install mcp-publisher
 ```
 
-**Windows (PowerShell):**
+</details>
 
-```powershell
-$arch = if ([System.Runtime.InteropServices.RuntimeInformation]::ProcessArchitecture -eq "Arm64") { "arm64" } else { "amd64" }; Invoke-WebRequest -Uri "https://github.com/modelcontextprotocol/registry/releases/download/v1.0.0/mcp-publisher_1.0.0_windows_$arch.tar.gz" -OutFile "mcp-publisher.tar.gz"; tar xf mcp-publisher.tar.gz mcp-publisher.exe; rm mcp-publisher.tar.gz
-# Move mcp-publisher.exe to a directory in your PATH
+<details>
+<summary><strong>⬇️ macOS/Linux/WSL: Pre-built binaries</strong></summary>
+
+```bash
+curl -L "https://github.com/modelcontextprotocol/registry/releases/download/v1.0.0/mcp-publisher_1.0.0_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/').tar.gz" | tar xz mcp-publisher && sudo mv mcp-publisher /usr/local/bin/
 ```
 
+</details>
+
 <details>
-<summary>Alternative: Build from Source</summary>
+<summary><strong>🏗️ macOS/Linux/WSL: From source</strong></summary>
 
-If you prefer to build from source (requires Git, Make and Go 1.24+):
+Requires Git, Make and Go 1.24+:
 
 ```bash
 # Clone the registry repository
@@ -47,6 +54,16 @@ export PATH=$PATH:$(pwd)/bin
 
 </details>
 
+<details>
+<summary><strong>🪟 Windows PowerShell: Pre-built binaries</strong></summary>
+
+```powershell
+$arch = if ([System.Runtime.InteropServices.RuntimeInformation]::ProcessArchitecture -eq "Arm64") { "arm64" } else { "amd64" }; Invoke-WebRequest -Uri "https://github.com/modelcontextprotocol/registry/releases/download/v1.0.0/mcp-publisher_1.0.0_windows_$arch.tar.gz" -OutFile "mcp-publisher.tar.gz"; tar xf mcp-publisher.tar.gz mcp-publisher.exe; rm mcp-publisher.tar.gz
+# Move mcp-publisher.exe to a directory in your PATH
+```
+
+</details>
+
 ## Step 2: Initialize Your server.json
 
 Navigate to your server's directory and create a template:
diff --git a/docs/reference/cli/commands.md b/docs/reference/cli/commands.md
index d07c1c07..a1830751 100644
--- a/docs/reference/cli/commands.md
+++ b/docs/reference/cli/commands.md
@@ -6,15 +6,10 @@ See the [publishing guide](../../guides/publishing/publish-server.md) for a walk
 
 ## Installation
 
-<!-- TODO: update once #358 solved -->
+Install via Homebrew (macOS/Linux):
 
 ```bash
-# Build from source (from repository root)
-make publisher
-# Binary created at ./cmd/publisher/bin/mcp-publisher
-
-# Install globally (optional)
-cp ./cmd/publisher/bin/mcp-publisher /usr/local/bin/
+$ brew install mcp-publisher
 ```
 
 ## Global Options