Funcionalidades obsoletas

Traducción automática

Esta página se tradujo automáticamente a partir de la documentación en inglés, y la página en inglés es la versión de referencia. Si algo no se lee bien, Traducciones explica cómo avisarnos.

La especificación 2026-07-28 retira cinco cosas. El SDK sigue implementando todas y cada una, y todas llevan ahora un aviso de obsolescencia.

La tabla siguiente nombra cada funcionalidad obsoleta, explica por qué desaparece e indica el reemplazo sobre el que construir.

Qué queda obsoleto

Obsoleto	Por qué	Qué hacer en su lugar
Roots (directorios raíz): `ctx.session.list_roots()`, `client.send_roots_list_changed()`, el `list_roots_callback=` que pasas a `Client(...)`	SEP-2577 retira la capacidad.	Recibe las rutas como argumentos de herramienta normales o URI de recurso, o incrusta una `ListRootsRequest` en un `InputRequiredResult` (consulta Solicitudes de varias idas y vueltas (multi-round-trip)).
Muestreo (sampling) iniciado por el servidor: `ctx.session.create_message()`, el `sampling_callback=` que pasas a `Client(...)`	SEP-2577 retira la capacidad.	Devuelve `InputRequiredResult` y deja que el cliente reintente la llamada (consulta Solicitudes de varias idas y vueltas).
Registro de logs del protocolo: `ctx.log()`, `ctx.debug()`, `ctx.info()`, `ctx.warning()`, `ctx.error()`, `ctx.session.send_log_message()`, `client.set_logging_level()`	SEP-2577 retira la capacidad. Nada dentro del protocolo la reemplaza.	El `import logging` de siempre hacia stderr (consulta Registro de logs).
`ping`: `client.send_ping()`	Eliminado del protocolo, no solo obsoleto. No hay método `ping` en 2026-07-28.	Nada. Solo funciona contra una conexión `mode="legacy"`.
Progreso de cliente a servidor: `client.send_progress_notification()`	2026-07-28 hace que el progreso sea solo de servidor a cliente.	Nada que enviar. Tu servidor informa del progreso con `ctx.report_progress()` (consulta Progreso).

De esa tabla se desprenden tres cosas:

Roots, muestreo y registro de logs van juntos. Una sola propuesta, SEP-2577, deja obsoletas las tres capacidades a la vez.
El muestreo y los roots comparten un problema más profundo: son lugares donde un servidor envía una solicitud al cliente. Esa dirección entera es lo que 2026-07-28 reemplaza con las Solicitudes de varias idas y vueltas. Lo que desaparece son los métodos RPC independientes (sampling/createMessage, roots/list y el elicitation/create de estilo push); los tipos de payload CreateMessageRequest / ListRootsRequest / ElicitRequest sobreviven, incrustados en InputRequiredResult.input_requests, y en el cliente llegan a los mismos callbacks.
ping es la excepción. El protocolo no lo deja obsoleto: lo elimina. El método del SDK sigue avisando (su mensaje dice removed, no deprecated) y llamarlo en una conexión moderna responde con "Method not found".

Obsoleto es solo un aviso

Hoy no se rompe nada.

Todos los métodos anteriores siguen funcionando contra cualquier sesión que haya negociado 2025-11-25 o anterior. Fija mode="legacy" en el cliente y obtienes exactamente el comportamiento anterior a 2026. No hay cambios en lo que se transmite y la negociación de capacidades no cambia.

Lo que cambia es que recibes un aviso visible la primera vez que se ejecuta cada uno:

MCPDeprecationWarning: The logging capability is deprecated as of 2026-07-28 (SEP-2577).

MCPDeprecationWarning hereda de UserWarning, no de DeprecationWarning. Es deliberado: el filtro por defecto de Python solo muestra DeprecationWarning en código que se ejecuta directamente como __main__, y así es como las bibliotecas dejan cosas obsoletas sin que nadie se entere durante dos años. Este aparece en todas partes, sin ninguna opción -W.

Warning

"Solo un aviso" deja de ser cierto en el canal. El muestreo y los roots son solicitudes de servidor a cliente, y una sesión 2026-07-28 no tiene ningún canal que las transporte. Llama a ctx.session.create_message() dentro de una herramienta en una conexión moderna y el aviso se dispara igual, y después el envío falla con un error:

Cannot send 'sampling/createMessage': this transport context has no back-channel
for server-initiated requests.

Dos señales, en ese orden. El MCPDeprecationWarning se dispara en el momento en que llamas al método, en cualquier conexión. El error es lo que vuelve cuando a continuación el SDK intenta enviar. Estas dos funcionalidades solo funcionan de extremo a extremo en una conexión mode="legacy" cuyo cliente registró el callback correspondiente.

Silenciar el aviso

No lo hagas en código nuevo.

Pero un servidor que mantienes y que de verdad atiende a clientes anteriores a 2026 tiene todo el derecho a un log tranquilo. Filtra la categoría antes de que se ejecute la primera llamada obsoleta:

import warnings

from mcp import MCPDeprecationWarning

warnings.filterwarnings("ignore", category=MCPDeprecationWarning)

Esa es toda la API. No hay un interruptor por método, y tampoco lo quieres: la gracia de tener una sola categoría es que una línea la silencia y una línea la trae de vuelta.

Check

Aplica el filtro al revés y obtienes una prueba de regresión gratis. Añade "error::mcp.MCPDeprecationWarning" al ajuste filterwarnings de tu configuración de pytest y la llamada obsoleta lanza una excepción en lugar de avisar. Una herramienta llamada old_log que todavía llama a ctx.info() deja de pasar y empieza a informar:

Error executing tool old_log: The logging capability is deprecated as of 2026-07-28 (SEP-2577).

Una línea de configuración de pytest, y una llamada obsoleta nunca podrá volver a colarse en tu código sin que falle una prueba.

Resumen

La especificación 2026-07-28 deja obsoletos los roots, el muestreo iniciado por el servidor y el registro de logs del protocolo (todo en SEP-2577), restringe el progreso a la dirección servidor a cliente y elimina ping.
La columna de reemplazos te indica el camino: Solicitudes de varias idas y vueltas para el muestreo y los roots, Registro de logs para los logs, Progreso para el progreso. ping no necesita nada en absoluto.
Obsoleto es solo un aviso: no hay cambios en lo que se transmite, todo sigue funcionando contra sesiones anteriores a 2026 y recibes un MCPDeprecationWarning visible (un UserWarning, así que está activo por defecto).
El muestreo y los roots necesitan además un canal de retorno (back-channel) que una sesión 2026-07-28 no tiene. En una conexión moderna avisan y después lanzan una excepción.
warnings.filterwarnings("ignore", category=MCPDeprecationWarning) silencia toda la categoría; "error::mcp.MCPDeprecationWarning" en pytest la convierte en un fallo de prueba.
El código nuevo no debería construirse sobre nada de esto.

Todas las demás páginas de esta documentación enseñan la API actual.