Struct McpError 

pub struct McpError {
    pub kind: McpErrorKind,
    pub code: i32,
    pub message: String,
    pub data: Option<Value>,
}

Error returned by every tsafe-mcp code path that can fail.

code and message are emitted directly as the JSON-RPC error.code / error.message. data is the optional error.data object containing per-error diagnostics (key name, field name, etc).

Fields

kind: McpErrorKind

code: i32

message: String

data: Option<Value>

Implementations

impl McpError

pub fn new<S: Into<String>>(kind: McpErrorKind, detail: S) -> Self

Construct a fresh error using the kind’s default message with an additional human-readable detail appended.

pub fn kind_only(kind: McpErrorKind) -> Self

Convenience for “use the default message verbatim” — most kinds in §5.4 have a fixed phrasing.

pub fn with_data(self, data: Value) -> Self

Attach structured data (key name, field path, etc) for the JSON-RPC error object.

pub fn to_rpc_error_object(&self) -> Value

Build the JSON-RPC 2.0 error object for this error.

Trait Implementations

impl Clone for McpError

fn clone(&self) -> McpError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for McpError

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

Formats the value using the given formatter.

impl Display for McpError

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

Formats the value using the given formatter.

impl Error for McpError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.