diff --git a/README.md b/README.md
index 6df40d7..000f611 100644
--- a/README.md
+++ b/README.md
@@ -135,6 +135,13 @@ claude mcp add --transport stdio xcode -- uvx --from mcpbridge-wrapper mcpbridge
 codex mcp add xcode -- uvx --from mcpbridge-wrapper mcpbridge-wrapper --broker
 ```
 
+After upgrading, stop the old singleton daemon once so the next `--broker` client
+starts the new package version:
+
+```bash
+uvx --from mcpbridge-wrapper mcpbridge-wrapper --broker-stop
+```
+
 For full start/stop/status commands, Cursor JSON snippets, troubleshooting, and
 rollback to direct mode, see [Broker Mode Guide](docs/broker-mode.md).
 
diff --git a/Sources/XcodeMCPWrapper/Documentation.docc/XcodeMCPWrapper.md b/Sources/XcodeMCPWrapper/Documentation.docc/XcodeMCPWrapper.md
index 6e53d15..c9c5031 100644
--- a/Sources/XcodeMCPWrapper/Documentation.docc/XcodeMCPWrapper.md
+++ b/Sources/XcodeMCPWrapper/Documentation.docc/XcodeMCPWrapper.md
@@ -127,6 +127,13 @@ claude mcp add --transport stdio xcode -- uvx --from mcpbridge-wrapper mcpbridge
 codex mcp add xcode -- uvx --from mcpbridge-wrapper mcpbridge-wrapper --broker
 ```
 
+After upgrading, stop the old singleton daemon once so the next `--broker` client
+starts the new package version:
+
+```bash
+uvx --from mcpbridge-wrapper mcpbridge-wrapper --broker-stop
+```
+
 For troubleshooting and rollback details, see <doc:CursorSetup>,
 <doc:ClaudeCodeSetup>, <doc:CodexCLISetup>, and <doc:Troubleshooting>.