1212require_relative "server/capabilities"
1313require_relative "server/input_required_result"
1414require_relative "server/pagination"
15+ require_relative "server/request_state_security"
1516require_relative "server/transports"
1617
1718module MCP
@@ -145,7 +146,7 @@ class ValidationError < StandardError; end
145146 CACHE_SCOPES = [ "public" , "private" ] . freeze
146147
147148 attr_accessor :description , :icons , :name , :title , :version , :website_url , :instructions , :tools , :prompts , :resource_templates , :server_context , :configuration , :capabilities , :transport , :logging_message_notification
148- attr_reader :resources , :page_size , :client_capabilities , :ttl_ms , :cache_scope
149+ attr_reader :resources , :page_size , :client_capabilities , :ttl_ms , :cache_scope , :request_state_security
149150
150151 def initialize (
151152 description : nil ,
@@ -165,6 +166,7 @@ def initialize(
165166 page_size : nil ,
166167 ttl_ms : nil ,
167168 cache_scope : nil ,
169+ request_state_security : nil ,
168170 transport : nil
169171 )
170172 @description = description
@@ -184,6 +186,7 @@ def initialize(
184186 self . page_size = page_size
185187 self . ttl_ms = ttl_ms
186188 self . cache_scope = cache_scope
189+ @request_state_security = request_state_security
187190 @configuration = MCP . configuration . merge ( configuration )
188191 @client = nil
189192 @client_protocol_version = nil
@@ -606,6 +609,8 @@ def handle_request(request, method, session: nil, related_request_id: nil)
606609 session . configure_logging ( request_logging ) if request_logging . valid_level?
607610 end
608611
612+ params = unseal_request_state ( params , method : method ) if @request_state_security
613+
609614 result = case method
610615 when Methods ::INITIALIZE
611616 init ( params , session : session )
@@ -640,7 +645,7 @@ def handle_request(request, method, session: nil, related_request_id: nil)
640645 # Runs after the cancellation check so a cancelled request stays suppressed
641646 # instead of turning into a gate error response.
642647 if result . is_a? ( InputRequiredResult )
643- result = serialize_input_required_result ( result , envelope : envelope , request : params )
648+ result = serialize_input_required_result ( result , envelope : envelope , request : params , method : method )
644649 end
645650
646651 # SEP-2322 makes `resultType` REQUIRED on every result a 2026-07-28 server returns;
@@ -718,7 +723,7 @@ def lift_request_envelope(params, method:, session:)
718723 # a final result. The capability gate enforces the SEP-2575 rule that servers MUST NOT rely on
719724 # (or embed requests for) capabilities the client did not declare, and reports every missing capability at
720725 # once so the client sees the full set.
721- def serialize_input_required_result ( result , envelope :, request :)
726+ def serialize_input_required_result ( result , envelope :, request :, method : )
722727 if envelope . nil?
723728 raise RequestHandlerError . new (
724729 "input_required results require the 2026-07-28 stateless lifecycle (SEP-2322)" ,
@@ -731,7 +736,76 @@ def serialize_input_required_result(result, envelope:, request:)
731736 raise MissingRequiredClientCapabilityError . new ( missing , request ) unless missing . empty?
732737
733738 add_instrumentation_data ( input_required : true )
734- result . to_h
739+ serialized = result . to_h
740+
741+ if @request_state_security && serialized [ :requestState ]
742+ serialized = serialized . merge ( requestState : @request_state_security . seal (
743+ serialized [ :requestState ] ,
744+ method : method ,
745+ target : mrtr_target ( request ) ,
746+ arguments_digest : mrtr_arguments_digest ( request ) ,
747+ ) )
748+ end
749+
750+ serialized
751+ end
752+
753+ # Methods whose results may be `input_required` and whose retried requests carry
754+ # `inputResponses`/`requestState` (SEP-2322).
755+ MRTR_METHODS = [ Methods ::TOOLS_CALL , Methods ::PROMPTS_GET , Methods ::RESOURCES_READ ] . freeze
756+
757+ # Replaces a sealed client-echoed `requestState` with its verified plaintext before dispatch,
758+ # so handlers always read the state they wrote. A tampered, expired, or cross-request token is
759+ # rejected as invalid params, matching the Python SDK's "Invalid or expired requestState" behavior.
760+ def unseal_request_state ( params , method :)
761+ return params unless MRTR_METHODS . include? ( method )
762+ return params unless params . is_a? ( Hash )
763+
764+ sealed = params [ :requestState ] || params [ "requestState" ]
765+ return params unless sealed
766+
767+ plaintext = @request_state_security . unseal (
768+ sealed ,
769+ method : method ,
770+ target : mrtr_target ( params ) ,
771+ arguments_digest : mrtr_arguments_digest ( params ) ,
772+ )
773+ key = params . key? ( "requestState" ) ? "requestState" : :requestState
774+ params . merge ( key => plaintext )
775+ rescue RequestStateSecurity ::InvalidStateError => e
776+ raise RequestHandlerError . new (
777+ "Invalid or expired requestState" ,
778+ params ,
779+ error_type : :invalid_params ,
780+ error_code : JsonRpcHandler ::ErrorCode ::INVALID_PARAMS ,
781+ original_error : e ,
782+ )
783+ end
784+
785+ def mrtr_target ( params )
786+ return "" unless params . is_a? ( Hash )
787+
788+ params [ :name ] || params [ "name" ] || params [ :uri ] || params [ "uri" ] || ""
789+ end
790+
791+ # Digest of the originating arguments, binding a sealed state to retries of
792+ # the same call with the same inputs. Keys are stringified and sorted recursively
793+ # so symbol/string parses of identical JSON digest identically.
794+ def mrtr_arguments_digest ( params )
795+ arguments = params . is_a? ( Hash ) ? params [ :arguments ] || params [ "arguments" ] : nil
796+ OpenSSL ::Digest ::SHA256 . hexdigest ( canonical_json ( arguments || { } ) )
797+ end
798+
799+ def canonical_json ( value )
800+ case value
801+ when Hash
802+ pairs = value . map { |key , nested | [ key . to_s , nested ] } . sort_by ( &:first )
803+ "{#{ pairs . map { |key , nested | "#{ key . to_json } :#{ canonical_json ( nested ) } " } . join ( "," ) } }"
804+ when Array
805+ "[#{ value . map { |element | canonical_json ( element ) } . join ( "," ) } ]"
806+ else
807+ value . to_json
808+ end
735809 end
736810
737811 # Extracts the SEP-2322 retry fields a client sends when re-issuing a request:
0 commit comments