`ClientConfig` has inconsistent naming: `message_handler` should be `message_callback`

Initial Checks

• I confirm that I'm using the latest version of MCP Python SDK
• I confirm that I searched for my issue in https://github.com/modelcontextprotocol/python-sdk/issues before opening this issue

Description

ClientConfig exposes five user-facing callback fields, but four of them use the *_callback suffix while one uses *_handler:

# src/mcp/client/client.py
sampling_callback: SamplingFnT | None = None
list_roots_callback: ListRootsFnT | None = None
logging_callback: LoggingFnT | None = None
elicitation_callback: ElicitationFnT | None = None
message_handler: MessageHandlerFnT | None = None  # ← inconsistent

The same inconsistency is present in ClientSession.__init__ and ServerConnectionParams:

# src/mcp/client/session.py
def __init__(self, ..., message_handler: MessageHandlerFnT | None = None, ...)

# src/mcp/client/session_group.py
class ServerConnectionParams:
    message_handler: MessageHandlerFnT | None = None

A TODO comment in the codebase already flags this:

# TODO(Marcelo): Why do we have both "callback" and "handler"?
message_handler: MessageHandlerFnT | None = None

Proposed Fix

Rename message_handler → message_callback consistently across all three sites:

Since this is the v2 rewrite on main, a breaking rename is appropriate and there is no need for a deprecation shim.

I'd like to take this on if you're open to a fix.

Python & MCP Python SDK

Python 3.13
Reproduced on: main @ 161834d (2026-05-13)

Beginne mit den Callback-Definitionen und den Weiterleitungsaufrufen in src/mcp/client/client.py und verfolge dann den zugehörigen Parameter und das interne Attribut in src/mcp/client/session.py. Überprüfe ServerConnectionParams in src/mcp/client/session_group.py sowie die lokale Variable und das Schlüsselwortargument in src/mcp/client/main.py. Als abgeschlossen gilt die Aufgabe, wenn alle vier Stellen konsistent message_callback verwenden und in diesem Ablauf keine Benennung message_handler mehr vorhanden ist.