Deprecated API

Contents

• Terminally Deprecated
• Interfaces
• Classes
• Exceptions
• Record Classes
• Methods
• Constructors

Terminally Deprecated Elements

Element	Description
io.modelcontextprotocol.client.transport.customizer.McpHttpClientAuthorizationErrorHandler	in favor of McpHttpClientTransportAuthorizationErrorHandler
io.modelcontextprotocol.client.transport.customizer.McpHttpClientAuthorizationErrorHandler.handle(HttpResponse.ResponseInfo, McpTransportContext)	in favor of McpHttpClientTransportAuthorizationErrorHandler.handle(HttpRequestSnapshot, HttpResponse.ResponseInfo, McpTransportContext)
io.modelcontextprotocol.client.transport.customizer.McpHttpClientAuthorizationErrorHandler.Sync.handle(HttpResponse.ResponseInfo, McpTransportContext)	in favor of McpHttpClientTransportAuthorizationErrorHandler.Sync.handle(HttpRequestSnapshot, HttpResponse.ResponseInfo, McpTransportContext)
io.modelcontextprotocol.client.transport.HttpClientStreamableHttpTransport.Builder.authorizationErrorHandler(McpHttpClientAuthorizationErrorHandler)	in favor of HttpClientStreamableHttpTransport.Builder.authorizationErrorHandler(McpHttpClientTransportAuthorizationErrorHandler)
io.modelcontextprotocol.spec.McpTransportSessionClosedException(String)

Deprecated Interfaces

Interface	Description
io.modelcontextprotocol.client.transport.customizer.McpHttpClientAuthorizationErrorHandler	in favor of McpHttpClientTransportAuthorizationErrorHandler
io.modelcontextprotocol.client.transport.SseMessageEndpointValidator	This validator is part of the deprecated SSE transport.
io.modelcontextprotocol.spec.JsonSchemaValidator	Use JsonSchemaValidator

Deprecated Classes

Class	Description
io.modelcontextprotocol.client.transport.DefaultSseMessageEndpointValidator	This validator is part of the deprecated SSE transport.
io.modelcontextprotocol.client.transport.HttpClientSseClientTransport	This SSE transport is deprecated. Use Streamable HTTP instead, with HttpClientStreamableHttpTransport.
io.modelcontextprotocol.server.transport.HttpServletSseServerTransportProvider	This SSE transport is deprecated. Use Streamable HTTP instead, with HttpServletStreamableServerTransportProvider or HttpServletStatelessServerTransport.

Deprecated Exceptions

Exceptions	Description
io.modelcontextprotocol.client.transport.InvalidSseMessageEndpointException	This exception is part of the deprecated SSE transport.

Deprecated Record Classes

Record Class	Description
io.modelcontextprotocol.spec.McpSchema.JsonSchema	use Map instead.
io.modelcontextprotocol.spec.McpSchema.LegacyTitledEnumSchema	Use McpSchema.TitledSingleSelectEnumSchema instead

Deprecated Methods

Method	Description
io.modelcontextprotocol.client.transport.customizer.McpHttpClientAuthorizationErrorHandler.handle(HttpResponse.ResponseInfo, McpTransportContext)	in favor of McpHttpClientTransportAuthorizationErrorHandler.handle(HttpRequestSnapshot, HttpResponse.ResponseInfo, McpTransportContext)
io.modelcontextprotocol.client.transport.customizer.McpHttpClientAuthorizationErrorHandler.Sync.handle(HttpResponse.ResponseInfo, McpTransportContext)	in favor of McpHttpClientTransportAuthorizationErrorHandler.Sync.handle(HttpRequestSnapshot, HttpResponse.ResponseInfo, McpTransportContext)
io.modelcontextprotocol.client.transport.HttpClientStreamableHttpTransport.Builder.authorizationErrorHandler(McpHttpClientAuthorizationErrorHandler)	in favor of HttpClientStreamableHttpTransport.Builder.authorizationErrorHandler(McpHttpClientTransportAuthorizationErrorHandler)
io.modelcontextprotocol.spec.McpSchema.CallToolRequest.builder()	Use McpSchema.CallToolRequest.builder(String) instead.
io.modelcontextprotocol.spec.McpSchema.CompleteReference.identifier()
io.modelcontextprotocol.spec.McpSchema.CreateMessageRequest.builder()	Use McpSchema.CreateMessageRequest.builder(List, int) instead.
io.modelcontextprotocol.spec.McpSchema.CreateMessageResult.builder()
io.modelcontextprotocol.spec.McpSchema.CreateMessageResult.Builder.content(McpSchema.Content)
io.modelcontextprotocol.spec.McpSchema.CreateMessageResult.Builder.message(String)
io.modelcontextprotocol.spec.McpSchema.CreateMessageResult.Builder.model(String)
io.modelcontextprotocol.spec.McpSchema.CreateMessageResult.Builder.role(McpSchema.Role)
io.modelcontextprotocol.spec.McpSchema.ElicitFormRequest.Builder.message(String)	Use McpSchema.ElicitFormRequest.builder(String, Map) factory method instead.
io.modelcontextprotocol.spec.McpSchema.ElicitFormRequest.Builder.requestedSchema(Map<String, Object>)	Use McpSchema.ElicitFormRequest.builder(String, Map) factory method instead.
io.modelcontextprotocol.spec.McpSchema.ElicitRequest.builder()	Use McpSchema.ElicitFormRequest.builder(String, Map) instead.
io.modelcontextprotocol.spec.McpSchema.ElicitRequest.builder(String, Map<String, Object>)	Use McpSchema.ElicitFormRequest.builder(String, Map) instead.
io.modelcontextprotocol.spec.McpSchema.ElicitResult.builder()
io.modelcontextprotocol.spec.McpSchema.ElicitResult.Builder.message(McpSchema.ElicitResult.Action)
io.modelcontextprotocol.spec.McpSchema.LoggingMessageNotification.builder()	Use McpSchema.LoggingMessageNotification.builder(LoggingLevel, String) instead.
io.modelcontextprotocol.spec.McpSchema.LoggingMessageNotification.Builder.data(String)
io.modelcontextprotocol.spec.McpSchema.LoggingMessageNotification.Builder.level(McpSchema.LoggingLevel)
io.modelcontextprotocol.spec.McpSchema.ModelHint.of(String)	Use ModelHint(String)
io.modelcontextprotocol.spec.McpSchema.Resource.builder()
io.modelcontextprotocol.spec.McpSchema.Resource.Builder.name(String)
io.modelcontextprotocol.spec.McpSchema.Resource.Builder.uri(String)
io.modelcontextprotocol.spec.McpSchema.ResourceTemplate.builder()
io.modelcontextprotocol.spec.McpSchema.ResourceTemplate.Builder.name(String)
io.modelcontextprotocol.spec.McpSchema.ResourceTemplate.Builder.uriTemplate(String)
io.modelcontextprotocol.spec.McpSchema.Tool.builder()	Use McpSchema.Tool.builder(String, Map) instead.
io.modelcontextprotocol.spec.McpSchema.Tool.builder(String)
io.modelcontextprotocol.spec.McpSchema.Tool.Builder.inputSchema(McpSchema.JsonSchema)	use McpSchema.Tool.Builder.inputSchema(Map) instead.

Deprecated Constructors

Constructor	Description
io.modelcontextprotocol.spec.DefaultMcpStreamableServerSessionFactory(Duration, McpStreamableServerSession.InitRequestHandler, Map<String, McpRequestHandler<?>>, Map<String, McpNotificationHandler>)	Use DefaultMcpStreamableServerSessionFactory(Duration, McpStreamableServerSession.InitRequestHandler, Map, Map, Function) instead
io.modelcontextprotocol.spec.McpSchema.Annotations(List<McpSchema.Role>, Double)	Use McpSchema.Annotations.builder() instead.
io.modelcontextprotocol.spec.McpSchema.AudioContent(McpSchema.Annotations, String, String)
io.modelcontextprotocol.spec.McpSchema.BlobResourceContents(String, String, String)
io.modelcontextprotocol.spec.McpSchema.CallToolRequest(McpJsonMapper, String, String)
io.modelcontextprotocol.spec.McpSchema.CallToolRequest(String, Map<String, Object>)
io.modelcontextprotocol.spec.McpSchema.CallToolRequest.Builder()	Use McpSchema.CallToolRequest.builder(String) instead.
io.modelcontextprotocol.spec.McpSchema.CallToolResult.Builder()	Use McpSchema.CallToolResult.builder() factory method instead of instantiating the builder directly.
io.modelcontextprotocol.spec.McpSchema.ClientCapabilities.Elicitation()	Use McpSchema.ClientCapabilities.Elicitation.builder() instead.
io.modelcontextprotocol.spec.McpSchema.CompleteRequest(McpSchema.CompleteReference, McpSchema.CompleteRequest.CompleteArgument)
io.modelcontextprotocol.spec.McpSchema.CompleteRequest(McpSchema.CompleteReference, McpSchema.CompleteRequest.CompleteArgument, McpSchema.CompleteRequest.CompleteContext)
io.modelcontextprotocol.spec.McpSchema.CompleteRequest(McpSchema.CompleteReference, McpSchema.CompleteRequest.CompleteArgument, Map<String, Object>)
io.modelcontextprotocol.spec.McpSchema.CreateMessageRequest.Builder()	Use McpSchema.CreateMessageRequest.builder(List, int) factory method instead.
io.modelcontextprotocol.spec.McpSchema.EmbeddedResource(McpSchema.Annotations, McpSchema.ResourceContents)
io.modelcontextprotocol.spec.McpSchema.GetPromptRequest(String, Map<String, Object>)
io.modelcontextprotocol.spec.McpSchema.GetPromptResult(String, List<McpSchema.PromptMessage>)
io.modelcontextprotocol.spec.McpSchema.ImageContent(McpSchema.Annotations, String, String)
io.modelcontextprotocol.spec.McpSchema.Implementation(String, String)	Use McpSchema.Implementation.builder(String, String)
io.modelcontextprotocol.spec.McpSchema.Implementation(String, String, String)	Use McpSchema.Implementation.builder(String, String)
io.modelcontextprotocol.spec.McpSchema.InitializeRequest(String, McpSchema.ClientCapabilities, McpSchema.Implementation)	Use McpSchema.InitializeRequest.builder(String, ClientCapabilities, Implementation) instead.
io.modelcontextprotocol.spec.McpSchema.InitializeResult(String, McpSchema.ServerCapabilities, McpSchema.Implementation, String)	Use McpSchema.InitializeResult.builder(String, ServerCapabilities, Implementation) instead.
io.modelcontextprotocol.spec.McpSchema.ListPromptsResult(List<McpSchema.Prompt>, String)
io.modelcontextprotocol.spec.McpSchema.ListResourcesResult(List<McpSchema.Resource>, String)
io.modelcontextprotocol.spec.McpSchema.ListResourceTemplatesResult(List<McpSchema.ResourceTemplate>, String)
io.modelcontextprotocol.spec.McpSchema.ListRootsResult(List<McpSchema.Root>)
io.modelcontextprotocol.spec.McpSchema.ListRootsResult(List<McpSchema.Root>, String)
io.modelcontextprotocol.spec.McpSchema.ListToolsResult(List<McpSchema.Tool>, String)
io.modelcontextprotocol.spec.McpSchema.LoggingMessageNotification.Builder()	Use McpSchema.LoggingMessageNotification.builder(LoggingLevel, String) factory method instead.
io.modelcontextprotocol.spec.McpSchema.ProgressNotification(Object, double, Double, String)
io.modelcontextprotocol.spec.McpSchema.Prompt(String, String, String, List<McpSchema.PromptArgument>)
io.modelcontextprotocol.spec.McpSchema.Prompt(String, String, String, List<McpSchema.PromptArgument>, Map<String, Object>)
io.modelcontextprotocol.spec.McpSchema.Prompt(String, String, List<McpSchema.PromptArgument>)
io.modelcontextprotocol.spec.McpSchema.PromptArgument(String, String, Boolean)
io.modelcontextprotocol.spec.McpSchema.PromptReference(String, String)	The type argument is ignored — the type discriminator is always "ref/prompt". Use PromptReference(String) or the McpSchema.PromptReference.builder(String) instead.
io.modelcontextprotocol.spec.McpSchema.ReadResourceRequest(String)
io.modelcontextprotocol.spec.McpSchema.ReadResourceResult(List<McpSchema.ResourceContents>)
io.modelcontextprotocol.spec.McpSchema.Resource(String, String, String, String, String, Long, McpSchema.Annotations, Map<String, Object>)	Use McpSchema.Resource.builder(String, String)
io.modelcontextprotocol.spec.McpSchema.Resource.Builder()
io.modelcontextprotocol.spec.McpSchema.ResourceReference(String, String)
io.modelcontextprotocol.spec.McpSchema.ResourceTemplate(String, String, String, String, McpSchema.Annotations)	Use McpSchema.ResourceTemplate.builder(String, String).
io.modelcontextprotocol.spec.McpSchema.ResourceTemplate(String, String, String, String, String, McpSchema.Annotations)	Use McpSchema.ResourceTemplate.builder(String, String).
io.modelcontextprotocol.spec.McpSchema.ResourceTemplate(String, String, String, String, String, McpSchema.Annotations, Map<String, Object>)	Use McpSchema.ResourceTemplate.builder(String, String).
io.modelcontextprotocol.spec.McpSchema.SubscribeRequest(String)
io.modelcontextprotocol.spec.McpSchema.TextContent(McpSchema.Annotations, String)
io.modelcontextprotocol.spec.McpSchema.TextContent(String)
io.modelcontextprotocol.spec.McpSchema.TextResourceContents(String, String, String)
io.modelcontextprotocol.spec.McpSchema.Tool(String, String, String, Map<String, Object>, Map<String, Object>, McpSchema.ToolAnnotations, Map<String, Object>)	Use McpSchema.Tool.builder(String, Map)
io.modelcontextprotocol.spec.McpSchema.Tool.Builder()	Use McpSchema.Tool.builder(String, Map) instead.
io.modelcontextprotocol.spec.McpSchema.UnsubscribeRequest(String)
io.modelcontextprotocol.spec.McpTransportSessionClosedException(String)