Use capability-level deprecation messages for roots and sampling

The logging deprecations name the feature ("The logging capability is
deprecated as of ..."); roots and sampling still named the individual method.
Switch `list_roots`, `send_roots_list_changed`, `sample`, and `create_message`
to the same capability-level wording so every SEP-2577 warning is consistent.

Author: Kludex

src/mcp/client/client.py

@@ -316,7 +316,7 @@ async def list_tools(self, *, cursor: str | None = None, meta: RequestParamsMeta
         """List available tools from the server."""
         return await self.session.list_tools(params=PaginatedRequestParams(cursor=cursor, _meta=meta))
 
-    @deprecated("`send_roots_list_changed` is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
+    @deprecated("The roots capability is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
     async def send_roots_list_changed(self) -> None:
         """Send a notification that the roots list has changed."""
         # TODO(Marcelo): Currently, there is no way for the server to handle this. We should add support.

src/mcp/client/session.py

@@ -551,7 +551,7 @@ async def list_tools(self, *, params: types.PaginatedRequestParams | None = None
 
         return result
 
-    @deprecated("`send_roots_list_changed` is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
+    @deprecated("The roots capability is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
     async def send_roots_list_changed(self) -> None:
         """Send a roots/list_changed notification."""
         await self.send_notification(types.RootsListChangedNotification())

src/mcp/server/session.py

@@ -156,7 +156,7 @@ async def send_resource_updated(self, uri: str | AnyUrl) -> None:
         )
 
     @overload
-    @deprecated("`create_message` is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
+    @deprecated("The sampling capability is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
     async def create_message(
         self,
         messages: list[types.SamplingMessage],
@@ -176,7 +176,7 @@ async def create_message(
         ...
 
     @overload
-    @deprecated("`create_message` is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
+    @deprecated("The sampling capability is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
     async def create_message(
         self,
         messages: list[types.SamplingMessage],
@@ -195,7 +195,7 @@ async def create_message(
         """Overload: With tools, returns array-capable content."""
         ...
 
-    @deprecated("`create_message` is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
+    @deprecated("The sampling capability is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
     async def create_message(
         self,
         messages: list[types.SamplingMessage],
@@ -272,7 +272,7 @@ async def create_message(
             metadata=metadata_obj,
         )
 
-    @deprecated("`list_roots` is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
+    @deprecated("The roots capability is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
     async def list_roots(self) -> types.ListRootsResult:
         """Send a roots/list request."""
         if self._stateless:

src/mcp/shared/peer.py

@@ -85,7 +85,7 @@ async def notify(self, method: str, params: Mapping[str, Any] | None) -> None:
         await self._outbound.notify(method, params)
 
     @overload
-    @deprecated("`sample` is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
+    @deprecated("The sampling capability is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
     async def sample(
         self,
         messages: list[SamplingMessage],
@@ -103,7 +103,7 @@ async def sample(
         opts: CallOptions | None = None,
     ) -> CreateMessageResult: ...
     @overload
-    @deprecated("`sample` is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
+    @deprecated("The sampling capability is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
     async def sample(
         self,
         messages: list[SamplingMessage],
@@ -120,7 +120,7 @@ async def sample(
         meta: Meta | None = None,
         opts: CallOptions | None = None,
     ) -> CreateMessageResultWithTools: ...
-    @deprecated("`sample` is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
+    @deprecated("The sampling capability is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
     async def sample(
         self,
         messages: list[SamplingMessage],
@@ -200,7 +200,7 @@ async def elicit_url(
         result = await self.send_raw_request("elicitation/create", dump_params(params, meta), opts)
         return ElicitResult.model_validate(result, by_name=False)
 
-    @deprecated("`list_roots` is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
+    @deprecated("The roots capability is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
     async def list_roots(self, *, meta: Meta | None = None, opts: CallOptions | None = None) -> ListRootsResult:
         """Send a `roots/list` request.
 

tests/shared/test_peer.py

@@ -152,7 +152,7 @@ async def test_peer_list_roots_is_deprecated_sep_2577():
         peer = ClientPeer(client)
         with anyio.fail_after(5):
             with pytest.warns(
-                MCPDeprecationWarning, match=r"`list_roots` is deprecated as of 2026-07-28 \(SEP-2577\)\."
+                MCPDeprecationWarning, match=r"The roots capability is deprecated as of 2026-07-28 \(SEP-2577\)\."
             ):
                 await peer.list_roots()  # pyright: ignore[reportDeprecated]
         assert rec.seen[0][0] == "roots/list"