Struct ListToolsResult 

pub struct ListToolsResult {
    pub cache_scope: ListToolsResultCacheScope,
    pub meta: Option<ResultMetaObject>,
    pub next_cursor: Option<String>,
    pub result_type: String,
    pub tools: Vec<Tool>,
    pub ttl_ms: u64,
}

Latest MCP Protocol 2026_07_28 The result returned by the server for a {@link ListToolsRequesttools/list} request.

JSON schema

{
 "description": "The result returned by the server for a {@link ListToolsRequesttools/list} request.",
 "type": "object",
 "required": [
   "cacheScope",
   "resultType",
   "tools",
   "ttlMs"
 ],
 "properties": {
   "_meta": {
     "$ref": "#/$defs/ResultMetaObject"
   },
   "cacheScope": {
     "description": "Indicates the intended scope of the cached response, analogous to HTTP\nCache-Control: public vs Cache-Control: private.\n\n- \"public\": The response does not contain user-specific data. Any\n  client or intermediary (e.g., shared gateway, caching proxy) MAY cache\n  the response and serve it across authorization contexts.\n- \"private\": The response MAY be cached and reused only within the\n  same authorization context. Caches MUST NOT be shared across\n  authorization contexts (e.g., a different access token requires a\n  different cache).",
     "type": "string",
     "enum": [
       "private",
       "public"
     ]
   },
   "nextCursor": {
     "description": "An opaque token representing the pagination position after the last returned result.\nIf present, there may be more results available.",
     "type": "string"
   },
   "resultType": {
     "description": "Indicates the type of the result, which allows the client to determine\nhow to parse the result object.\n\nServers implementing this protocol version MUST include this field.\nFor backward compatibility, when a client receives a result from a\nserver implementing an earlier protocol version (which does not include\nresultType), the client MUST treat the absent field as \"complete\".",
     "type": "string"
   },
   "tools": {
     "type": "array",
     "items": {
       "$ref": "#/$defs/Tool"
     }
   },
   "ttlMs": {
     "description": "A hint from the server indicating how long (in milliseconds) the\nclient MAY cache this response before re-fetching. Semantics are\nanalogous to HTTP Cache-Control max-age.\n\n- If 0, The response SHOULD be considered immediately stale,\n  The client MAY re-fetch every time the result is needed.\n- If positive, the client SHOULD consider the result fresh for this many\n  milliseconds after receiving the response.",
     "type": "integer",
     "minimum": 0.0
   }
 }
}

Fields

cache_scope: ListToolsResultCacheScope

Indicates the intended scope of the cached response, analogous to HTTP Cache-Control: public vs Cache-Control: private. - “public”: The response does not contain user-specific data. Any client or intermediary (e.g., shared gateway, caching proxy) MAY cache the response and serve it across authorization contexts. - “private”: The response MAY be cached and reused only within the same authorization context. Caches MUST NOT be shared across authorization contexts (e.g., a different access token requires a different cache).

meta: Option<ResultMetaObject>

next_cursor: Option<String>

An opaque token representing the pagination position after the last returned result. If present, there may be more results available.

result_type: String

Indicates the type of the result, which allows the client to determine how to parse the result object. Servers implementing this protocol version MUST include this field. For backward compatibility, when a client receives a result from a server implementing an earlier protocol version (which does not include resultType), the client MUST treat the absent field as “complete”.

tools: Vec<Tool>

ttl_ms: u64

A hint from the server indicating how long (in milliseconds) the client MAY cache this response before re-fetching. Semantics are analogous to HTTP Cache-Control max-age. - If 0, The response SHOULD be considered immediately stale, The client MAY re-fetch every time the result is needed. - If positive, the client SHOULD consider the result fresh for this many milliseconds after receiving the response.

Trait Implementations

impl Clone for ListToolsResult

fn clone(&self) -> ListToolsResult

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ListToolsResult

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ListToolsResult

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<ListToolsResult> for ServerResult

fn from(value: ListToolsResult) -> Self

Converts to this type from the input type.

impl From<ListToolsResult> for GenericResult

fn from(value: ListToolsResult) -> Self

Converts to this type from the input type.

impl From<ListToolsResult> for MessageFromServer

fn from(value: ListToolsResult) -> Self

Converts to this type from the input type.

impl Serialize for ListToolsResult

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<ServerResult> for ListToolsResult

type Error = RpcError

The type returned in the event of a conversion error.

fn try_from(value: ServerResult) -> Result<Self, Self::Error>

Performs the conversion.