Funcionalidades descontinuadas

A especificação 2026-07-28 aposenta cinco coisas. O SDK ainda implementa cada uma delas, e cada uma agora carrega um aviso de descontinuação. Um helper do SDK está descontinuado por conta própria e aparece listado no final.

A tabela abaixo nomeia cada funcionalidade descontinuada, o motivo de ela estar saindo e o substituto sobre o qual construir.

O que está descontinuado

Três coisas saem dessa tabela:

• Roots, amostragem e logging andam juntos. Uma única proposta, a SEP-2577, descontinua as três capacidades de uma vez.
• Amostragem e roots compartilham um problema mais profundo: são pontos em que um servidor envia uma requisição ao cliente. Essa direção inteira é o que a 2026-07-28 substitui por Requisições de múltiplas idas e voltas. O que desaparece são os métodos RPC independentes (sampling/createMessage, roots/list e o elicitation/create no estilo push); os tipos de payload CreateMessageRequest / ListRootsRequest / ElicitRequest sobrevivem, embutidos em InputRequiredResult.input_requests, e no cliente chegam aos mesmos callbacks.
• ping é o diferente do grupo. O protocolo não o descontinua, ele o remove. O método do SDK ainda emite o aviso (a mensagem diz removed, não deprecated) e chamá-lo em uma conexão moderna responde com "Method not found".

Descontinuado é consultivo

Nada quebra hoje.

Cada método acima continua funcionando em qualquer sessão que tenha negociado 2025-11-25 ou anterior. Fixe mode="legacy" no cliente e você obtém exatamente o comportamento pré-2026. Não há mudanças no protocolo de transmissão e a negociação de capacidades segue igual.

O que muda é que você recebe um aviso visível na primeira vez que cada um é executado:

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

MCPDeprecationWarning é subclasse de UserWarning, não de DeprecationWarning. Isso é proposital: o filtro padrão do Python só mostra DeprecationWarning em código executado diretamente como __main__, e é assim que bibliotecas descontinuam coisas sem ninguém perceber por dois anos. Este aparece em todo lugar, sem nenhuma flag -W.

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

ping em uma sessão legacy

Um ping é uma requisição vazia que qualquer um dos lados pode enviar para conferir se o outro ainda está respondendo. A especificação 2026-07-28 o remove (SEP-2575): toda requisição que um cliente moderno envia já prova que o servidor está lá, e um servidor moderno não tem canal para enviar um. Os dois métodos do SDK ainda funcionam em uma sessão da era do handshake. Do cliente:

async def main() -> None:
    async with Client("http://localhost:8000/mcp", mode="legacy") as client:
        await client.send_ping()  # warns; returns an EmptyResult

E do servidor, dentro de qualquer handler:

@mcp.tool()
async def check_client(ctx: Context) -> str:
    """A tool that still pings the client mid-call."""
    await ctx.session.send_ping()  # no warning; an EmptyResult while the client is connected
    return "client answered"

• client.send_ping() avisa com MCPDeprecationWarning a cada chamada. Em uma conexão padrão (2026-07-28), o servidor responde MCPError: Method not found em vez disso.
• ctx.session.send_ping() não carrega aviso nenhum. Em uma conexão moderna, lança o mesmo erro de ausência de canal de retorno (back-channel) que qualquer outra requisição iniciada pelo servidor.
• Nenhum dos lados registra nada para responder a um ping.

Notificações de mudança de roots

Um cliente da era 2025 que declarou a capacidade roots pode contar ao servidor que as pastas do seu workspace mudaram enviando notifications/roots/list_changed; o servidor responde requisitando roots/list de novo. A especificação 2026-07-28 remove a notificação junto com o resto do fluxo de roots no estilo push. No cliente, passar list_roots_callback= (Callbacks do cliente) é o que declara "roots": {"listChanged": true}, e uma chamada cumpre essa promessa:

async def open_folder(client: Client, uri: str, name: str) -> None:
    """The user opened another folder: expose it through the roots callback, then tell the server."""
    workspace.append(Root(uri=FileUrl(uri), name=name))
    await client.send_roots_list_changed()

No servidor, é o Server de baixo nível que aceita o handler do lado receptor:

async def roots_changed(ctx: ServerRequestContext, params: NotificationParams | None) -> None:
    """The client's roots changed: ask for the new list."""
    roots = (await ctx.session.list_roots()).roots


server = Server("Bookshop", on_roots_list_changed=roots_changed)

• workspace é a lista que o seu list_roots_callback retorna. client.send_roots_list_changed() avisa, e precisa de um cliente mode="legacy": em uma conexão moderna a notificação é descartada silenciosamente. Mantenha a sessão aberta depois, porque o roots/list de acompanhamento do servidor chega por ela.
• MCPServer não tem hook para a notificação. No Server de baixo nível, on_roots_list_changed= registra o handler (descontinuado também, e avisa na construção). A notificação não carrega payload, então o handler chama ctx.session.list_roots() para obter a nova lista.

Silenciando o aviso

Não faça isso, em código novo.

Mas um servidor que você mantém e que de fato atende clientes pré-2026 tem todo o direito a um log silencioso. Filtre a categoria antes que a primeira chamada descontinuada seja executada:

import warnings

from mcp import MCPDeprecationWarning

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

A API inteira é essa. Não há uma chave por método, e você não quer uma: o sentido de ter uma única categoria é que uma linha a silencia e uma linha a traz de volta.

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

Helpers descontinuados do SDK

Estas não são mudanças de especificação, apenas detalhes internos do SDK com um substituto melhor. Avisam com o mesmo MCPDeprecationWarning e serão removidos na 3.0.

Recapitulando

• A especificação 2026-07-28 descontinua roots, a amostragem iniciada pelo servidor e o logging de protocolo (todos pela SEP-2577), restringe o progresso ao sentido servidor para cliente e remove o ping.
• A coluna de substitutos indica o próximo passo: Requisições de múltiplas idas e voltas para amostragem e roots, Logging para logging, Progresso para progresso. ping não precisa de nada.
• Descontinuado é consultivo: sem mudanças no protocolo de transmissão, tudo continua funcionando em sessões pré-2026, e você recebe um MCPDeprecationWarning visível (um UserWarning, então está ligado por padrão).
• Amostragem e roots precisam, além disso, de um canal de retorno que uma sessão 2026-07-28 não tem. Em uma conexão moderna elas avisam e depois lançam uma exceção.
• warnings.filterwarnings("ignore", category=MCPDeprecationWarning) silencia a categoria inteira; "error::mcp.MCPDeprecationWarning" no pytest a transforma em falha de teste.
• Um helper do SDK, FuncMetadata.call_fn_with_arg_validation(), está descontinuado separadamente para remoção na 3.0.
• Código novo não deve ser construído sobre nenhuma delas.

Todas as outras páginas desta documentação ensinam a API atual.