diff --git a/mcp_server.py b/mcp_server.py
index e63c37a..3964f76 100644
--- a/mcp_server.py
+++ b/mcp_server.py
@@ -56,7 +56,11 @@ def _reveal_endpoints() -> bool:
 
 
 def _with_optional_url(result: dict, url: str | None) -> dict:
-    """Attach web links only under the explicit endpoint reveal opt-in."""
+    """Attach web links only under the explicit endpoint reveal opt-in.
+
+    Mutates *result* in place and returns it; pass a freshly-built dict,
+    never a shared/aliased one.
+    """
     if _reveal_endpoints() and url:
         result["url"] = url
     return result