Enum McpInvocationError 

pub enum McpInvocationError {
    UrlElicitation {
        message: String,
        data: Option<UrlElicitationData>,
        raw_data: Option<Value>,
    },
    InvalidRequest {
        message: String,
        data: Option<Value>,
    },
    MethodNotFound {
        message: String,
        data: Option<Value>,
    },
    InvalidParams {
        message: String,
        data: Option<Value>,
    },
    InternalError {
        message: String,
        data: Option<Value>,
    },
    ParseError {
        message: String,
        data: Option<Value>,
    },
    ResourceNotFound {
        message: String,
        data: Option<Value>,
    },
    Other {
        code: i32,
        message: String,
        data: Option<Value>,
    },
}

Typed view of a JSON-RPC error returned by an MCP server for an invoked method.

Surfaced by McpError::Invocation so callers can branch on the underlying error code without re-parsing strings. The variants cover every rmcp rmcp::model::ErrorCode constant defined at the time of writing; anything else (custom server codes, future protocol additions) lands in Self::Other with the original code preserved.

For the URL elicitation case (rmcp::model::ErrorCode::URL_ELICITATION_REQUIRED) the data payload is best-effort parsed into UrlElicitationData. When the server’s payload does not match the documented shape the typed data slot is None but raw_data always preserves the original serde_json::Value so callers can fall back to ad-hoc inspection.

Variants

UrlElicitation

JSON-RPC error -32042 (URL elicitation required).

Fields

message: String

Human-readable message from the server.

data: Option<UrlElicitationData>

Typed view of the server’s data payload, when it matched the documented URL elicitation shape.

raw_data: Option<Value>

The original data value, preserved verbatim.

InvalidRequest

JSON-RPC error -32600 (invalid request).

Fields

message: String

data: Option<Value>

MethodNotFound

JSON-RPC error -32601 (method not found).

Fields

message: String

data: Option<Value>

InvalidParams

JSON-RPC error -32602 (invalid params).

Fields

message: String

data: Option<Value>

InternalError

JSON-RPC error -32603 (internal error).

Fields

message: String

data: Option<Value>

ParseError

JSON-RPC error -32700 (parse error).

Fields

message: String

data: Option<Value>

ResourceNotFound

JSON-RPC error -32002 (resource not found).

Fields

message: String

data: Option<Value>

Other

Forward-compat for custom server codes and any future rmcp additions not yet recognized by this crate.

Fields

code: i32

message: String

data: Option<Value>

Implementations

impl McpInvocationError

pub fn from_error_data(err: ErrorData) -> Self

Lifts an rmcp wire error into the typed enum. Infallible: well-known codes attempt a typed data parse and degrade to a raw-only view when parsing fails; unrecognized codes land in Self::Other.

pub fn code(&self) -> i32

Returns the underlying JSON-RPC error code.

Trait Implementations

impl Clone for McpInvocationError

fn clone(&self) -> McpInvocationError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for McpInvocationError

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

Formats the value using the given formatter.

impl Display for McpInvocationError

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

Formats the value using the given formatter.

impl Error for McpInvocationError

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.