Enum ServerResult 

#[non_exhaustive]
pub enum ServerResult {
    DiscoverResult(DiscoverResult),
    InitializeResult(InitializeResult),
    CompleteResult(CompleteResult),
    GetPromptResult(GetPromptResult),
    ListPromptsResult(ListPromptsResult),
    ListResourcesResult(ListResourcesResult),
    ListResourceTemplatesResult(ListResourceTemplatesResult),
    ReadResourceResult(ReadResourceResult),
    SubscriptionsListenResult(SubscriptionsListenResult),
    ListToolsResult(ListToolsResult),
    ElicitResult(ElicitResult),
    CreateTaskResult(CreateTaskResult),
    GetTaskResult(GetTaskResult),
    CallToolResult(CallToolResult),
    InputRequiredResult(InputRequiredResult),
    TaskAckResult(TaskAckResult),
    EmptyResult(EmptyObject),
    CustomResult(CustomResult),
}

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

DiscoverResult(DiscoverResult)

InitializeResult(InitializeResult)

CompleteResult(CompleteResult)

GetPromptResult(GetPromptResult)

ListPromptsResult(ListPromptsResult)

ListResourcesResult(ListResourcesResult)

ListResourceTemplatesResult(ListResourceTemplatesResult)

ReadResourceResult(ReadResourceResult)

SubscriptionsListenResult(SubscriptionsListenResult)

ListToolsResult(ListToolsResult)

ElicitResult(ElicitResult)

CreateTaskResult(CreateTaskResult)

GetTaskResult(GetTaskResult)

CallToolResult(CallToolResult)

InputRequiredResult(InputRequiredResult)

TaskAckResult(TaskAckResult)

EmptyResult(EmptyObject)

CustomResult(CustomResult)

Implementations

impl ServerResult

pub fn empty(_: ()) -> ServerResult

pub fn task_ack(_: ()) -> ServerResult

Empty tasks/update / tasks/cancel acknowledgement carrying the SEP-2322 resultType: "complete" discriminator (SEP-2663).

pub fn strip_result_type_for_legacy_peer(&mut self)

Strip the SEP-2322 resultType: "complete" discriminator so the result keeps the wire shape that predates protocol version 2026-07-28.

The server handler calls this before responding to a peer that negotiated an older protocol version, where the field did not exist and strict peers may reject it. Only the "complete" value is stripped: results whose discriminator carries meaning ("input_required", "task") are already gated to 2026-07-28+ sessions, and custom extension values are preserved.

Examples

use rmcp::model::{CallToolResult, ServerResult};

let mut result = ServerResult::CallToolResult(CallToolResult::success(vec![]));
result.strip_result_type_for_legacy_peer();

let json = serde_json::to_value(&result).unwrap();
assert!(json.get("resultType").is_none());

pub fn fill_missing_cache_hints(&mut self)

Fill in the SEP-2549 caching hints a cacheable result is missing.

Protocol version 2026-07-28 requires ttlMs and cacheScope on every complete tools/list, prompts/list, resources/list, resources/templates/list, and resources/read result. The server handler calls this before responding to a peer on that version, so a handler that builds its result with Default::default() still sends a conformant result.

Missing hints get the most conservative values, ttlMs: 0 (immediately stale) and cacheScope: "private", the same values DiscoverResult::new uses. Hints the handler set are kept.

Examples

use rmcp::model::{CacheScope, ListResourcesResult, ServerResult};

let mut result = ServerResult::ListResourcesResult(ListResourcesResult::default());
result.fill_missing_cache_hints();

let ServerResult::ListResourcesResult(result) = result else {
    unreachable!()
};
assert_eq!(result.ttl_ms, Some(0));
assert_eq!(result.cache_scope, Some(CacheScope::Private));

Trait Implementations

impl Clone for ServerResult

fn clone(&self) -> ServerResult

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ServerResult

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ServerResult

fn deserialize<__D>( __deserializer: __D, ) -> Result<ServerResult, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<CallToolResponse> for ServerResult

fn from(response: CallToolResponse) -> ServerResult

Converts to this type from the input type.

impl From<CallToolResult> for ServerResult

fn from(value: CallToolResult) -> ServerResult

Converts to this type from the input type.

impl From<CompleteResult> for ServerResult

fn from(value: CompleteResult) -> ServerResult

Converts to this type from the input type.

impl From<CreateTaskResult> for ServerResult

fn from(value: CreateTaskResult) -> ServerResult

Converts to this type from the input type.

impl From<CustomResult> for ServerResult

fn from(value: CustomResult) -> ServerResult

Converts to this type from the input type.

impl From<DiscoverResult> for ServerResult

fn from(value: DiscoverResult) -> ServerResult

Converts to this type from the input type.

impl From<ElicitResult> for ServerResult

fn from(value: ElicitResult) -> ServerResult

Converts to this type from the input type.

impl From<EmptyObject> for ServerResult

fn from(value: EmptyObject) -> ServerResult

Converts to this type from the input type.

impl From<GetPromptResponse> for ServerResult

fn from(response: GetPromptResponse) -> ServerResult

Converts to this type from the input type.

impl From<GetPromptResult> for ServerResult

fn from(value: GetPromptResult) -> ServerResult

Converts to this type from the input type.

impl From<GetTaskResult> for ServerResult

fn from(value: GetTaskResult) -> ServerResult

Converts to this type from the input type.

impl From<InitializeResult> for ServerResult

fn from(value: InitializeResult) -> ServerResult

Converts to this type from the input type.

impl From<InputRequiredResult> for ServerResult

fn from(value: InputRequiredResult) -> ServerResult

Converts to this type from the input type.

impl From<ListPromptsResult> for ServerResult

fn from(value: ListPromptsResult) -> ServerResult

Converts to this type from the input type.

impl From<ListResourceTemplatesResult> for ServerResult

fn from(value: ListResourceTemplatesResult) -> ServerResult

Converts to this type from the input type.

impl From<ListResourcesResult> for ServerResult

fn from(value: ListResourcesResult) -> ServerResult

Converts to this type from the input type.

impl From<ListToolsResult> for ServerResult

fn from(value: ListToolsResult) -> ServerResult

Converts to this type from the input type.

impl From<ReadResourceResponse> for ServerResult

fn from(response: ReadResourceResponse) -> ServerResult

Converts to this type from the input type.

impl From<ReadResourceResult> for ServerResult

fn from(value: ReadResourceResult) -> ServerResult

Converts to this type from the input type.

impl From<SubscriptionsListenResult> for ServerResult

fn from(value: SubscriptionsListenResult) -> ServerResult

Converts to this type from the input type.

impl From<TaskAckResult> for ServerResult

fn from(value: TaskAckResult) -> ServerResult

Converts to this type from the input type.

impl JsonSchema for ServerResult

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for ServerResult

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.