Struct CallToolResult 

pub struct CallToolResult {
    pub content: Vec<Content>,
    pub is_error: Option<bool>,
    pub structured_content: Option<Value>,
    pub meta: Option<HashMap<String, Value>>,
}

Re-exports of the canonical tool types from turbomcp_types. The result of a CallToolRequest.

Fields

content: Vec<Content>

The output of the tool as a series of content blocks. Required.

is_error: Option<bool>

Whether the tool execution resulted in an error.

When true, all content blocks should be treated as error information; the message may span multiple text blocks for structured error reporting.

structured_content: Option<Value>

Optional structured output conforming to the tool’s output_schema.

Tools that emit structured content SHOULD also include the serialized JSON in a TextContent block for clients that don’t support structured output.

meta: Option<HashMap<String, Value>>

Optional metadata for the result.

For client applications and tools to pass context that should NOT be exposed to LLMs (tracking IDs, metrics, cache status, etc.).

Implementations

impl CallToolResult

pub fn text(text: impl Into<String>) -> CallToolResult

Create a successful result with a single text content block.

pub fn error(message: impl Into<String>) -> CallToolResult

Create an error result with a single text content block and is_error = true.

pub fn json<T>(value: &T) -> Result<CallToolResult, Error>

where T: Serialize,

Create a successful JSON result (pretty-printed text content).

pub fn contents(contents: Vec<Content>) -> CallToolResult

Create a result with multiple content items.

pub fn image( data: impl Into<String>, mime_type: impl Into<String>, ) -> CallToolResult

Create an image result (base64-encoded).

pub fn all_text(&self) -> String

Extracts and concatenates all text content (newline-joined).

Returns an empty string if no text blocks are present.

pub fn first_text(&self) -> Option<&str>

Returns the text of the first text block, if any.

pub fn has_error(&self) -> bool

Whether is_error is explicitly true.

Trait Implementations

impl Clone for CallToolResult

fn clone(&self) -> CallToolResult

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CallToolResult

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

Formats the value using the given formatter.

impl Default for CallToolResult

fn default() -> CallToolResult

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for CallToolResult

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl IntoToolResponse for CallToolResult

fn into_tool_response(self) -> CallToolResult

Convert this type into a CallToolResult

impl Serialize for CallToolResult

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.