Enum McpError 

#[non_exhaustive]
pub enum McpError {
    Connection {
        server_id: String,
        message: String,
    },
    ToolCall {
        server_id: String,
        tool_name: ToolName,
        message: String,
        code: McpErrorCode,
    },
    ServerNotFound {
        server_id: String,
    },
    ServerAlreadyConnected {
        server_id: String,
    },
    ToolNotFound {
        server_id: String,
        tool_name: ToolName,
    },
    Timeout {
        server_id: String,
        tool_name: ToolName,
        timeout_secs: u64,
    },
    Qdrant(Box<QdrantError>),
    Json(Error),
    IntConversion(TryFromIntError),
    SsrfBlocked {
        url: String,
        addr: String,
    },
    InvalidUrl {
        url: String,
        message: String,
    },
    Embedding(String),
    CommandNotAllowed {
        command: String,
    },
    EnvVarBlocked {
        var_name: String,
    },
    PolicyViolation(String),
    OAuthError {
        server_id: String,
        message: String,
    },
    OAuthCallbackTimeout {
        server_id: String,
        timeout_secs: u64,
    },
    ToolListLocked {
        server_id: String,
    },
    ManagerShuttingDown {
        server_id: String,
    },
    HttpAuth {
        server_id: String,
        status: u16,
    },
}

Crate-wide error type for all MCP operations.

Variants cover connection failures, tool call errors, policy blocks, OAuth flows, and infrastructure errors (Qdrant, JSON serialization). Use McpError::code to obtain a typed McpErrorCode for retry/recovery decisions.

Examples

use zeph_mcp::error::{McpError, McpErrorCode};

let err = McpError::Timeout {
    server_id: "github".to_owned(),
    tool_name: "create_issue".into(),
    timeout_secs: 30,
};
assert_eq!(err.code(), Some(McpErrorCode::Transient));
assert!(err.code().unwrap().is_retryable());

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.

Connection

Fields

server_id: String

message: String

ToolCall

Fields

server_id: String

tool_name: ToolName

message: String

code: McpErrorCode

Typed error code for retry classification.

ServerNotFound

Fields

server_id: String

ServerAlreadyConnected

Fields

server_id: String

ToolNotFound

Fields

server_id: String

tool_name: ToolName

Timeout

Fields

server_id: String

tool_name: ToolName

timeout_secs: u64

Qdrant(Box<QdrantError>)

Json(Error)

IntConversion(TryFromIntError)

SsrfBlocked

Fields

url: String

addr: String

InvalidUrl

Fields

url: String

message: String

Embedding(String)

CommandNotAllowed

Fields

command: String

EnvVarBlocked

Fields

var_name: String

PolicyViolation(String)

OAuthError

Fields

server_id: String

message: String

OAuthCallbackTimeout

Fields

server_id: String

timeout_secs: u64

ToolListLocked

Fields

server_id: String

ManagerShuttingDown

The MCP manager is shutting down; the connection attempt was aborted.

This is a terminal lifecycle signal, not a transient error. Callers must not retry.

Fields

server_id: String

HttpAuth

HTTP 4xx response that indicates an authentication or authorization failure.

This error is non-retryable: the client must fix credentials or permissions before attempting to connect again. It maps to McpErrorCode::AuthFailure.

Fields

server_id: String

status: u16

HTTP status code (e.g. 401, 403, 404, 410, 422).

Implementations

impl McpError

pub fn code(&self) -> Option<McpErrorCode>

Return the typed error code for this error variant.

Trait Implementations

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.

impl From<Box<QdrantError>> for McpError

fn from(source: Box<QdrantError>) -> Self

Converts to this type from the input type.

impl From<Error> for McpError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<TryFromIntError> for McpError

fn from(source: TryFromIntError) -> Self

Converts to this type from the input type.