Struct McpError 

pub struct McpError {
    pub id: Uuid,
    pub kind: ErrorKind,
    pub message: String,
    pub source_location: Option<String>,
    pub context: Option<Box<ErrorContext>>,
    pub timestamp: DateTime<Utc>,
}

Unified MCP error type

This is the single error type used across all TurboMCP crates in v3. It is no_std compatible and maps to JSON-RPC error codes per MCP spec.

With rich-errors feature enabled, includes UUID tracking and timestamps.

The context field is boxed to keep error size small for efficient Result<T, McpError> usage.

Fields

id: Uuid

Available on crate feature rich-errors only.

Unique error ID for tracing (only with rich-errors feature)

kind: ErrorKind

Error classification

message: String

Human-readable error message

source_location: Option<String>

Source location (file:line for debugging) Note: Never serialized to clients to prevent information leakage

context: Option<Box<ErrorContext>>

Additional context (boxed to keep McpError small)

timestamp: DateTime<Utc>

Available on crate feature rich-errors only.

Timestamp when error occurred (only with rich-errors feature)

Implementations

impl McpError

pub fn new(kind: ErrorKind, message: impl Into<String>) -> McpError

Create a new error with kind and message

pub const fn id(&self) -> Uuid

Available on crate feature rich-errors only.

Get the error ID (only available with rich-errors feature)

pub const fn timestamp(&self) -> DateTime<Utc>

Available on crate feature rich-errors only.

Get the error timestamp (only available with rich-errors feature)

pub fn invalid_params(message: impl Into<String>) -> McpError

Create a validation/invalid params error

pub fn internal(message: impl Into<String>) -> McpError

Create an internal error

pub fn safe_internal(message: impl Into<String>) -> McpError

Create a safe internal error with sanitized message.

Use this for errors that may contain sensitive information (file paths, IP addresses, connection strings, etc.). The message is automatically sanitized to prevent information leakage per OWASP guidelines.

Example

use turbomcp_core::error::McpError;

let err = McpError::safe_internal("Failed: postgres://admin:secret@192.168.1.1/db");
assert!(!err.message.contains("secret"));
assert!(!err.message.contains("192.168.1.1"));

pub fn safe_tool_execution_failed( tool_name: impl Into<String>, reason: impl Into<String>, ) -> McpError

Create a safe tool execution error with sanitized message.

Like safe_internal, but specifically for tool execution failures.

pub fn sanitized(self) -> McpError

Sanitize this error’s message in-place.

Call this before returning errors to clients in production to ensure no sensitive information is leaked.

pub fn parse_error(message: impl Into<String>) -> McpError

Create a parse error

pub fn invalid_request(message: impl Into<String>) -> McpError

Create an invalid request error

pub fn method_not_found(method: impl Into<String>) -> McpError

Create a method not found error

pub fn tool_not_found(tool_name: impl Into<String>) -> McpError

Create a tool not found error

pub fn tool_execution_failed( tool_name: impl Into<String>, reason: impl Into<String>, ) -> McpError

Create a tool execution failed error

pub fn prompt_not_found(prompt_name: impl Into<String>) -> McpError

Create a prompt not found error

pub fn resource_not_found(uri: impl Into<String>) -> McpError

Create a resource not found error

pub fn resource_access_denied( uri: impl Into<String>, reason: impl Into<String>, ) -> McpError

Create a resource access denied error

pub fn capability_not_supported(capability: impl Into<String>) -> McpError

Create a capability not supported error

pub fn protocol_version_mismatch( client_version: impl Into<String>, server_version: impl Into<String>, ) -> McpError

Create a protocol version mismatch error

pub fn timeout(message: impl Into<String>) -> McpError

Create a timeout error

pub fn transport(message: impl Into<String>) -> McpError

Create a transport error

pub fn authentication(message: impl Into<String>) -> McpError

Create an authentication error

pub fn permission_denied(message: impl Into<String>) -> McpError

Create a permission denied error

pub fn rate_limited(message: impl Into<String>) -> McpError

Create a rate limited error

pub fn cancelled(message: impl Into<String>) -> McpError

Create a cancelled error

pub fn user_rejected(message: impl Into<String>) -> McpError

Create a user rejected error

pub fn serialization(message: impl Into<String>) -> McpError

Create a serialization error

pub fn security(message: impl Into<String>) -> McpError

Create a security error

pub fn unavailable(message: impl Into<String>) -> McpError

Create an unavailable error

pub fn configuration(message: impl Into<String>) -> McpError

Create a configuration error

pub fn external_service(message: impl Into<String>) -> McpError

Create an external service error

pub fn server_overloaded() -> McpError

Create a server overloaded error

pub fn from_rpc_code(code: i32, message: impl Into<String>) -> McpError

Create an error from a JSON-RPC error code

pub fn with_operation(self, operation: impl Into<String>) -> McpError

Set the operation context

pub fn with_component(self, component: impl Into<String>) -> McpError

Set the component context

pub fn with_request_id(self, request_id: impl Into<String>) -> McpError

Set the request ID context

pub fn with_source_location(self, location: impl Into<String>) -> McpError

Set the source location (typically file:line)

pub const fn is_retryable(&self) -> bool

Check if this error is retryable

pub const fn is_temporary(&self) -> bool

Check if this error is temporary

pub const fn jsonrpc_code(&self) -> i32

Get the JSON-RPC error code for this error

pub const fn jsonrpc_error_code(&self) -> i32

Get the JSON-RPC error code (canonical name)

pub const fn http_status(&self) -> u16

Get the HTTP status code equivalent

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<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for McpError

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for McpError

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

Formats the value using the given formatter.

impl Error for McpError

Available on crate feature std only.

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<McpError>> for McpError

fn from(boxed: Box<McpError>) -> McpError

Converts to this type from the input type.

impl From<Error> for McpError

fn from(err: Error) -> McpError

Converts to this type from the input type.

impl From<Error> for McpError

Available on crate feature std only.

fn from(err: Error) -> McpError

Converts to this type from the input type.

impl From<McpError> for ToolError

fn from(e: McpError) -> ToolError

Converts to this type from the input type.

impl From<RegistryError> for McpError

fn from(err: RegistryError) -> Self

Converts to this type from the input type.

impl From<SharedError> for McpError

fn from(err: SharedError) -> Self

Converts to this type from the input type.

impl Serialize for McpError

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.