77require_relative "methods"
88require_relative "logging_message_notification"
99require_relative "progress"
10+ require_relative "protocol_deprecations"
1011require_relative "server_context"
1112require_relative "server/capabilities"
1213require_relative "server/pagination"
@@ -184,6 +185,7 @@ def initialize(
184185 self . cache_scope = cache_scope
185186 @configuration = MCP . configuration . merge ( configuration )
186187 @client = nil
188+ @client_protocol_version = nil
187189
188190 validate!
189191
@@ -354,6 +356,8 @@ def notify_resources_list_changed
354356 # is deprecated as of MCP protocol version 2026-07-28 (SEP-2577).
355357 # Use stderr or OpenTelemetry instead.
356358 def notify_log_message ( data :, level :, logger : nil )
359+ warn_if_deprecated_protocol_feature ( :logging , uplevel : 1 )
360+
357361 return unless @transport
358362 return unless logging_message_notification &.should_notify? ( level )
359363
@@ -374,6 +378,8 @@ def notify_log_message(data:, level:, logger: nil)
374378 # version 2026-07-28 (SEP-2577). Use tool parameters, resource URIs,
375379 # server configuration, or environment variables instead.
376380 def roots_list_changed_handler ( &block )
381+ warn_if_deprecated_protocol_feature ( :roots , uplevel : 1 )
382+
377383 @handlers [ Methods ::NOTIFICATIONS_ROOTS_LIST_CHANGED ] = block
378384 end
379385
@@ -538,6 +544,13 @@ def handle_request(request, method, session: nil, related_request_id: nil)
538544 return -> ( params ) { handle_cancelled_notification ( params , session : session ) }
539545 end
540546
547+ case method
548+ when Methods ::NOTIFICATIONS_ROOTS_LIST_CHANGED
549+ warn_if_deprecated_protocol_feature ( :roots , session : session , uplevel : 2 )
550+ when Methods ::LOGGING_SET_LEVEL
551+ warn_if_deprecated_protocol_feature ( :logging , session : session , uplevel : 2 )
552+ end
553+
541554 handler = @handlers [ method ]
542555 unless handler
543556 instrument_call ( "unsupported_method" , server_context : { request : request } ) do
@@ -706,7 +719,11 @@ def init(params, session: nil)
706719 response_instructions = nil
707720 end
708721
709- session &.mark_initialized!
722+ if session
723+ session . mark_initialized! ( protocol_version : negotiated_version )
724+ else
725+ @client_protocol_version = negotiated_version
726+ end
710727
711728 {
712729 protocolVersion : negotiated_version ,
@@ -773,6 +790,19 @@ def configure_logging_level(request, session: nil)
773790 { }
774791 end
775792
793+ def warn_if_deprecated_protocol_feature ( feature , session : nil , uplevel : 1 )
794+ protocol_version = effective_deprecation_protocol_version ( session )
795+ MCP ::ProtocolDeprecations . warn_for ( feature , protocol_version : protocol_version , uplevel : uplevel )
796+ end
797+
798+ def effective_deprecation_protocol_version ( session )
799+ session &.protocol_version || @client_protocol_version || explicit_protocol_version
800+ end
801+
802+ def explicit_protocol_version
803+ configuration . protocol_version if configuration . protocol_version?
804+ end
805+
776806 def list_tools ( request )
777807 page = paginate ( @tools . values , cursor : cursor_from ( request ) , page_size : @page_size , request : request , &:to_h )
778808
0 commit comments