Deprecate only Context.log for logging, with a capability-level message

Kludex · Kludex · commit a465678c42d7 · 2026-06-20T17:45:26.000+02:00
The `debug`/`info`/`warning`/`error` convenience helpers delegate to
`Context.log`, so deprecating `log` alone covers them - they warn through it
instead of each carrying their own marker. Drop their `@deprecated` decorators
and the now-stale `# pyright: ignore[reportDeprecated]` on their call sites.

Reword every logging deprecation ("The logging capability is deprecated as of
...") so the message names the feature rather than the individual method, and
widen the `filterwarnings` pattern to match the new wording.
diff --git a/README.v2.md b/README.v2.md
@@ -360,7 +360,7 @@ mcp = MCPServer(name="Progress Example")
 @mcp.tool()
 async def long_running_task(task_name: str, ctx: Context, steps: int = 5) -> str:
     """Execute a task with progress updates."""
-    await ctx.info(f"Starting: {task_name}")  # pyright: ignore[reportDeprecated]
+    await ctx.info(f"Starting: {task_name}")
 
     for i in range(steps):
         progress = (i + 1) / steps
@@ -369,7 +369,7 @@ async def long_running_task(task_name: str, ctx: Context, steps: int = 5) -> str
             total=1.0,
             message=f"Step {i + 1}/{steps}",
         )
-        await ctx.debug(f"Completed step {i + 1}")  # pyright: ignore[reportDeprecated]
+        await ctx.debug(f"Completed step {i + 1}")
 
     return f"Task '{task_name}' completed"
 ```
@@ -707,7 +707,7 @@ mcp = MCPServer(name="Progress Example")
 @mcp.tool()
 async def long_running_task(task_name: str, ctx: Context, steps: int = 5) -> str:
     """Execute a task with progress updates."""
-    await ctx.info(f"Starting: {task_name}")  # pyright: ignore[reportDeprecated]
+    await ctx.info(f"Starting: {task_name}")
 
     for i in range(steps):
         progress = (i + 1) / steps
@@ -716,7 +716,7 @@ async def long_running_task(task_name: str, ctx: Context, steps: int = 5) -> str
             total=1.0,
             message=f"Step {i + 1}/{steps}",
         )
-        await ctx.debug(f"Completed step {i + 1}")  # pyright: ignore[reportDeprecated]
+        await ctx.debug(f"Completed step {i + 1}")
 
     return f"Task '{task_name}' completed"
 ```
@@ -982,10 +982,10 @@ mcp = MCPServer(name="Notifications Example")
 async def process_data(data: str, ctx: Context) -> str:
     """Process data with logging."""
     # Different log levels
-    await ctx.debug(f"Debug: Processing '{data}'")  # pyright: ignore[reportDeprecated]
-    await ctx.info("Info: Starting processing")  # pyright: ignore[reportDeprecated]
-    await ctx.warning("Warning: This is experimental")  # pyright: ignore[reportDeprecated]
-    await ctx.error("Error: (This is just a demo)")  # pyright: ignore[reportDeprecated]
+    await ctx.debug(f"Debug: Processing '{data}'")
+    await ctx.info("Info: Starting processing")
+    await ctx.warning("Warning: This is experimental")
+    await ctx.error("Error: (This is just a demo)")
 
     # Notify about resource changes
     await ctx.session.send_resource_list_changed()
diff --git a/docs/migration.md b/docs/migration.md
@@ -1224,7 +1224,7 @@ The user-facing methods for these features now carry `typing_extensions.deprecat
 
 - Sampling: `ServerSession.create_message()`, `ClientPeer.sample()`
 - Roots: `ServerSession.list_roots()`, `ClientPeer.list_roots()`, `ClientSession.send_roots_list_changed()`, `Client.send_roots_list_changed()`
-- Logging: `ServerSession.send_log_message()`, `ClientSession.set_logging_level()`, `Client.set_logging_level()`, and the `MCPServer` `Context` helpers `log()`, `debug()`, `info()`, `warning()`, `error()`
+- Logging: `ServerSession.send_log_message()`, `ClientSession.set_logging_level()`, `Client.set_logging_level()`, and `MCPServer` `Context.log()`. The `Context.debug()` / `info()` / `warning()` / `error()` helpers delegate to `log()`, so they warn through it rather than carrying their own marker.
 
 The runtime warning is emitted as `mcp.MCPDeprecationWarning`, which subclasses `UserWarning` (not `DeprecationWarning`) so it is visible by default. To silence it, filter that category:
 
diff --git a/examples/servers/everything-server/mcp_everything_server/server.py b/examples/servers/everything-server/mcp_everything_server/server.py
@@ -143,13 +143,13 @@ def test_multiple_content_types() -> list[TextContent | ImageContent | EmbeddedR
 @mcp.tool()
 async def test_tool_with_logging(ctx: Context) -> str:
     """Tests tool that emits log messages during execution"""
-    await ctx.info("Tool execution started")  # pyright: ignore[reportDeprecated]
+    await ctx.info("Tool execution started")
     await asyncio.sleep(0.05)
 
-    await ctx.info("Tool processing data")  # pyright: ignore[reportDeprecated]
+    await ctx.info("Tool processing data")
     await asyncio.sleep(0.05)
 
-    await ctx.info("Tool execution completed")  # pyright: ignore[reportDeprecated]
+    await ctx.info("Tool execution completed")
     return "Tool with logging executed successfully"
 
 
@@ -314,13 +314,13 @@ def test_error_handling() -> str:
 @mcp.tool()
 async def test_reconnection(ctx: Context) -> str:
     """Tests SSE polling by closing stream mid-call (SEP-1699)"""
-    await ctx.info("Before disconnect")  # pyright: ignore[reportDeprecated]
+    await ctx.info("Before disconnect")
 
     await ctx.close_sse_stream()
 
     await asyncio.sleep(0.2)  # Wait for client to reconnect
 
-    await ctx.info("After reconnect")  # pyright: ignore[reportDeprecated]
+    await ctx.info("After reconnect")
     return "Reconnection test completed"
 
 
diff --git a/examples/snippets/servers/notifications.py b/examples/snippets/servers/notifications.py
@@ -7,10 +7,10 @@
 async def process_data(data: str, ctx: Context) -> str:
     """Process data with logging."""
     # Different log levels
-    await ctx.debug(f"Debug: Processing '{data}'")  # pyright: ignore[reportDeprecated]
-    await ctx.info("Info: Starting processing")  # pyright: ignore[reportDeprecated]
-    await ctx.warning("Warning: This is experimental")  # pyright: ignore[reportDeprecated]
-    await ctx.error("Error: (This is just a demo)")  # pyright: ignore[reportDeprecated]
+    await ctx.debug(f"Debug: Processing '{data}'")
+    await ctx.info("Info: Starting processing")
+    await ctx.warning("Warning: This is experimental")
+    await ctx.error("Error: (This is just a demo)")
 
     # Notify about resource changes
     await ctx.session.send_resource_list_changed()
diff --git a/examples/snippets/servers/tool_progress.py b/examples/snippets/servers/tool_progress.py
@@ -6,7 +6,7 @@
 @mcp.tool()
 async def long_running_task(task_name: str, ctx: Context, steps: int = 5) -> str:
     """Execute a task with progress updates."""
-    await ctx.info(f"Starting: {task_name}")  # pyright: ignore[reportDeprecated]
+    await ctx.info(f"Starting: {task_name}")
 
     for i in range(steps):
         progress = (i + 1) / steps
@@ -15,6 +15,6 @@ async def long_running_task(task_name: str, ctx: Context, steps: int = 5) -> str
             total=1.0,
             message=f"Step {i + 1}/{steps}",
         )
-        await ctx.debug(f"Completed step {i + 1}")  # pyright: ignore[reportDeprecated]
+        await ctx.debug(f"Completed step {i + 1}")
 
     return f"Task '{task_name}' completed"
diff --git a/pyproject.toml b/pyproject.toml
@@ -216,7 +216,7 @@ filterwarnings = [
     # SEP-2577 deprecates the roots/sampling/logging methods; the SDK still calls
     # them internally (e.g. `ctx.debug` -> `log` -> `send_log_message`), so the
     # advisory warning is silenced. Tests asserting it opt back in with pytest.warns.
-    "ignore:`.*` is deprecated as of 2026-07-28 \\(SEP-2577\\).:mcp.MCPDeprecationWarning",
+    "ignore:.*is deprecated as of 2026-07-28 \\(SEP-2577\\).:mcp.MCPDeprecationWarning",
 ]
 
 [tool.markdown.lint]
diff --git a/src/mcp/client/client.py b/src/mcp/client/client.py
@@ -198,7 +198,7 @@ async def send_progress_notification(
             message=message,
         )
 
-    @deprecated("`set_logging_level` is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
+    @deprecated("The logging capability is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
     async def set_logging_level(self, level: LoggingLevel, *, meta: RequestParamsMeta | None = None) -> EmptyResult:
         """Set the logging level on the server."""
         return await self.session.set_logging_level(level=level, meta=meta)  # pyright: ignore[reportDeprecated]
diff --git a/src/mcp/client/session.py b/src/mcp/client/session.py
@@ -386,7 +386,7 @@ async def send_progress_notification(
             )
         )
 
-    @deprecated("`set_logging_level` is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
+    @deprecated("The logging capability is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
     async def set_logging_level(
         self,
         level: types.LoggingLevel,
diff --git a/src/mcp/server/context.py b/src/mcp/server/context.py
@@ -93,7 +93,7 @@ def headers(self) -> Mapping[str, str] | None:
         """
         return self.transport.headers
 
-    @deprecated("`log` is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
+    @deprecated("The logging capability is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
     async def log(self, level: LoggingLevel, data: Any, logger: str | None = None, *, meta: Meta | None = None) -> None:
         """Send a request-scoped `notifications/message` log entry.
 
diff --git a/src/mcp/server/mcpserver/context.py b/src/mcp/server/mcpserver/context.py
@@ -191,7 +191,7 @@ async def elicit_url(
             related_request_id=self.request_id,
         )
 
-    @deprecated("`log` is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
+    @deprecated("The logging capability is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
     async def log(
         self,
         level: LoggingLevel,
@@ -268,22 +268,18 @@ async def close_standalone_sse_stream(self) -> None:
             await self._request_context.close_standalone_sse_stream()
 
     # Convenience methods for common log levels
-    @deprecated("`debug` is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
     async def debug(self, data: Any, *, logger_name: str | None = None) -> None:
         """Send a debug log message."""
         await self.log("debug", data, logger_name=logger_name)  # pyright: ignore[reportDeprecated]
 
-    @deprecated("`info` is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
     async def info(self, data: Any, *, logger_name: str | None = None) -> None:
         """Send an info log message."""
         await self.log("info", data, logger_name=logger_name)  # pyright: ignore[reportDeprecated]
 
-    @deprecated("`warning` is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
     async def warning(self, data: Any, *, logger_name: str | None = None) -> None:
         """Send a warning log message."""
         await self.log("warning", data, logger_name=logger_name)  # pyright: ignore[reportDeprecated]
 
-    @deprecated("`error` is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
     async def error(self, data: Any, *, logger_name: str | None = None) -> None:
         """Send an error log message."""
         await self.log("error", data, logger_name=logger_name)  # pyright: ignore[reportDeprecated]
diff --git a/src/mcp/server/session.py b/src/mcp/server/session.py
@@ -127,7 +127,7 @@ def check_client_capability(self, capability: types.ClientCapabilities) -> bool:
         """Check if the client supports a specific capability."""
         return self._connection.check_capability(capability)
 
-    @deprecated("`send_log_message` is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
+    @deprecated("The logging capability is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
     async def send_log_message(
         self,
         level: types.LoggingLevel,
diff --git a/tests/interaction/mcpserver/test_context.py b/tests/interaction/mcpserver/test_context.py
@@ -41,10 +41,10 @@ async def test_context_logging_helpers_send_log_notifications(connect: Connect)
 
     @mcp.tool()
     async def narrate(ctx: Context) -> str:
-        await ctx.debug("d")  # pyright: ignore[reportDeprecated]
-        await ctx.info("i")  # pyright: ignore[reportDeprecated]
-        await ctx.warning("w")  # pyright: ignore[reportDeprecated]
-        await ctx.error("e")  # pyright: ignore[reportDeprecated]
+        await ctx.debug("d")
+        await ctx.info("i")
+        await ctx.warning("w")
+        await ctx.error("e")
         return "done"
 
     async def collect(params: LoggingMessageNotificationParams) -> None:
@@ -136,7 +136,7 @@ async def test_report_progress_without_a_progress_token_sends_nothing(connect: C
     @mcp.tool()
     async def mill(ctx: Context) -> str:
         await ctx.report_progress(1, 3)
-        await ctx.info("milling done")  # pyright: ignore[reportDeprecated]
+        await ctx.info("milling done")
         return "milled"
 
     async def collect(message: IncomingMessage) -> None:
@@ -250,8 +250,8 @@ async def test_set_logging_level_is_rejected_and_messages_are_never_filtered(con
 
     @mcp.tool()
     async def chatter(ctx: Context) -> str:
-        await ctx.debug("noise")  # pyright: ignore[reportDeprecated]
-        await ctx.error("signal")  # pyright: ignore[reportDeprecated]
+        await ctx.debug("noise")
+        await ctx.error("signal")
         return "done"
 
     async def collect(params: LoggingMessageNotificationParams) -> None:
diff --git a/tests/interaction/mcpserver/test_tools.py b/tests/interaction/mcpserver/test_tools.py
@@ -414,7 +414,7 @@ def doomed() -> str:
     async def grow(ctx: Context) -> str:
         mcp.add_tool(extra, name="extra")
         mcp.remove_tool("doomed")
-        await ctx.info("tool set changed")  # pyright: ignore[reportDeprecated]
+        await ctx.info("tool set changed")
         return "mutated"
 
     async def collect(message: IncomingMessage) -> None:
diff --git a/tests/interaction/transports/test_flows.py b/tests/interaction/transports/test_flows.py
@@ -32,7 +32,7 @@ async def test_concurrent_clients_on_one_stateful_server_receive_only_their_own_
     @mcp.tool()
     async def announce(label: str, ctx: Context) -> str:
         """Emit one info-level log carrying the caller's label, then return it."""
-        await ctx.info(label)  # pyright: ignore[reportDeprecated]
+        await ctx.info(label)
         return label
 
     received_a: list[object] = []
diff --git a/tests/interaction/transports/test_hosting_resume.py b/tests/interaction/transports/test_hosting_resume.py
@@ -55,7 +55,7 @@ def _counting_server() -> MCPServer:
     async def count(ctx: Context, n: int) -> str:
         """Emit n log notifications related to this call, plus one unrelated resource update."""
         for i in range(1, n + 1):
-            await ctx.info(f"tick {i}")  # pyright: ignore[reportDeprecated]
+            await ctx.info(f"tick {i}")
         await ctx.session.send_resource_updated("file:///elsewhere.txt")
         return f"counted to {n}"
 
@@ -138,10 +138,10 @@ async def test_get_with_last_event_id_replays_only_that_streams_missed_events()
     @mcp.tool()
     async def count(ctx: Context) -> str:
         """Emit one related notification, wait for the test, then emit two more plus an unrelated one."""
-        await ctx.info("tick 1")  # pyright: ignore[reportDeprecated]
+        await ctx.info("tick 1")
         await release.wait()
-        await ctx.info("tick 2")  # pyright: ignore[reportDeprecated]
-        await ctx.info("tick 3")  # pyright: ignore[reportDeprecated]
+        await ctx.info("tick 2")
+        await ctx.info("tick 3")
         await ctx.session.send_resource_updated("file:///elsewhere.txt")
         return "counted"
 
@@ -219,7 +219,7 @@ async def hold(ctx: Context) -> str:
         """Signal start, wait for the test, signal completion."""
         started.set()
         await release.wait()
-        await ctx.info("released")  # pyright: ignore[reportDeprecated]
+        await ctx.info("released")
         finished.set()
         return "held"
 
@@ -263,10 +263,10 @@ async def test_a_call_whose_stream_the_server_closes_is_resumed_by_the_client()
     @mcp.tool()
     async def interrupt(ctx: Context) -> str:
         """Emit, close this call's SSE stream, then emit again after the test releases the gate."""
-        await ctx.info("before close")  # pyright: ignore[reportDeprecated]
+        await ctx.info("before close")
         await ctx.close_sse_stream()
         await gate.wait()
-        await ctx.info("after close")  # pyright: ignore[reportDeprecated]
+        await ctx.info("after close")
         done.set()
         return "resumed"
 
@@ -321,9 +321,9 @@ async def test_a_captured_resumption_token_replays_missed_messages_on_a_new_conn
     @mcp.tool()
     async def hold(ctx: Context) -> str:
         """Emit one notification, wait for the test, emit another, return."""
-        await ctx.info("first")  # pyright: ignore[reportDeprecated]
+        await ctx.info("first")
         await release.wait()
-        await ctx.info("second")  # pyright: ignore[reportDeprecated]
+        await ctx.info("second")
         return "done"
 
     async def on_token(token: str) -> None:
diff --git a/tests/interaction/transports/test_streamable_http.py b/tests/interaction/transports/test_streamable_http.py
@@ -55,7 +55,7 @@ async def ask(ctx: Context) -> str:
     @mcp.tool()
     async def announce(ctx: Context) -> str:
         """Send one notification related to this request and one that is not."""
-        await ctx.info("about to announce")  # pyright: ignore[reportDeprecated]
+        await ctx.info("about to announce")
         await ctx.session.send_resource_updated("file:///watched.txt")
         return "announced"
 
diff --git a/tests/server/mcpserver/test_server.py b/tests/server/mcpserver/test_server.py
@@ -1110,10 +1110,10 @@ async def test_context_logging(self):
         mcp = MCPServer()
 
         async def logging_tool(msg: str, ctx: Context) -> str:
-            await ctx.debug("Debug message")  # pyright: ignore[reportDeprecated]
-            await ctx.info("Info message")  # pyright: ignore[reportDeprecated]
-            await ctx.warning("Warning message")  # pyright: ignore[reportDeprecated]
-            await ctx.error("Error message")  # pyright: ignore[reportDeprecated]
+            await ctx.debug("Debug message")
+            await ctx.info("Info message")
+            await ctx.warning("Warning message")
+            await ctx.error("Error message")
             return f"Logged messages for {msg}"
 
         mcp.add_tool(logging_tool)

Original file line number	Diff line number	Diff line change
`@@ -216,7 +216,7 @@ filterwarnings = [`
`216`	`216`	`# SEP-2577 deprecates the roots/sampling/logging methods; the SDK still calls`
`217`	`217`	# them internally (e.g. `ctx.debug` -> `log` -> `send_log_message`), so the
`218`	`218`	`# advisory warning is silenced. Tests asserting it opt back in with pytest.warns.`
`219`		- "ignore:`.*` is deprecated as of 2026-07-28 \\(SEP-2577\\).:mcp.MCPDeprecationWarning",
	`219`	`+ "ignore:.*is deprecated as of 2026-07-28 \\(SEP-2577\\).:mcp.MCPDeprecationWarning",`
`220`	`220`	`]`
`221`	`221`
`222`	`222`	`[tool.markdown.lint]`
Original file line number	Diff line number	Diff line change
`@@ -198,7 +198,7 @@ async def send_progress_notification(`
`198`	`198`	`message=message,`
`199`	`199`	`)`
`200`	`200`
`201`		- @deprecated("`set_logging_level` is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
	`201`	`+ @deprecated("The logging capability is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)`
`202`	`202`	`async def set_logging_level(self, level: LoggingLevel, *, meta: RequestParamsMeta \| None = None) -> EmptyResult:`
`203`	`203`	`"""Set the logging level on the server."""`
`204`	`204`	`return await self.session.set_logging_level(level=level, meta=meta) # pyright: ignore[reportDeprecated]`
Original file line number	Diff line number	Diff line change
`@@ -386,7 +386,7 @@ async def send_progress_notification(`
`386`	`386`	`)`
`387`	`387`	`)`
`388`	`388`
`389`		- @deprecated("`set_logging_level` is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)
	`389`	`+ @deprecated("The logging capability is deprecated as of 2026-07-28 (SEP-2577).", category=MCPDeprecationWarning)`
`390`	`390`	`async def set_logging_level(`
`391`	`391`	`self,`
`392`	`392`	`level: types.LoggingLevel,`