ErrorKind

turbomcp_protocol::error

Enum ErrorKind

pub enum ErrorKind {
Show 26 variants    ToolNotFound,
    ToolExecutionFailed,
    PromptNotFound,
    ResourceNotFound,
    ResourceAccessDenied,
    CapabilityNotSupported,
    ProtocolVersionMismatch,
    UserRejected,
    Validation,
    BadRequest,
    Internal,
    Serialization,
    Protocol,
    Authentication,
    PermissionDenied,
    Transport,
    Timeout,
    Unavailable,
    RateLimited,
    ServerOverloaded,
    Configuration,
    ExternalService,
    Cancelled,
    Security,
    Handler,
    NotFound,
}

Expand description

Error classification for programmatic handling

Variants§

ToolNotFound

Tool not found (MCP error code -32001)

ToolExecutionFailed

Tool execution failed (MCP error code -32002)

PromptNotFound

Prompt not found (MCP error code -32003)

ResourceNotFound

Resource not found (MCP error code -32004)

ResourceAccessDenied

Resource access denied (MCP error code -32005)

CapabilityNotSupported

Capability not supported (MCP error code -32006)

ProtocolVersionMismatch

Protocol version mismatch (MCP error code -32007)

UserRejected

User rejected the request (MCP error code -1)

Per MCP 2025-06-18 specification, this indicates a user explicitly rejected a sampling request or similar operation. This is a permanent failure that should not be retried.

Validation

Input validation failed (JSON-RPC -32602)

BadRequest

Request was malformed or invalid (JSON-RPC -32600)

Internal

Server internal error (JSON-RPC -32603)

Serialization

Serialization/deserialization error (JSON-RPC -32602)

Protocol

Protocol violation or incompatibility (JSON-RPC -32601)

Authentication

Authentication or authorization failed

PermissionDenied

Operation is not permitted

Transport

Network or transport error

Timeout

Operation timed out

Unavailable

Resource is temporarily unavailable

RateLimited

Rate limit exceeded (MCP error code -32009)

ServerOverloaded

Server overloaded (MCP error code -32010)

Configuration

Configuration error

ExternalService

External dependency failed

Cancelled

Operation was cancelled

Security

Security violation or constraint failure

Handler

👎Deprecated since 2.1.0: Use specific error kinds: ToolExecutionFailed, PromptNotFound, ResourceNotFound, etc.

Generic handler execution error (deprecated - use specific error kinds)

Replaced by:

ToolExecutionFailed for tool errors
PromptNotFound for prompt errors
ResourceNotFound or ResourceAccessDenied for resource errors

NotFound

👎Deprecated since 2.1.0: Use specific error kinds: ToolNotFound, PromptNotFound, ResourceNotFound

Generic not found error (deprecated - use specific error kinds)

Replaced by:

ToolNotFound for tools
PromptNotFound for prompts
ResourceNotFound for resources

Implementations§

impl ErrorKind

pub const fn description(self) -> &'static str

Get a human-readable description of this error kind

Trait Implementations§

impl Clone for ErrorKind

fn clone(&self) -> ErrorKind

Returns a duplicate of the value. Read more

1.0.0 · Source§

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

Performs copy-assignment from source. Read more

impl Debug for ErrorKind

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

Formats the value using the given formatter. Read more

impl<'de> Deserialize<'de> for ErrorKind

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more

impl Display for ErrorKind

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

Formats the value using the given formatter. Read more

impl Hash for ErrorKind

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher. Read more

1.3.0 · Source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more

impl PartialEq for ErrorKind

fn eq(&self, other: &ErrorKind) -> bool

Tests for self and other values to be equal, and is used by ==.

1.0.0 · Source§

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ErrorKind

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
where S: Serializer,

Serialize this value into the given Serde serializer. Read more

impl Copy for ErrorKind

impl Eq for ErrorKind

impl StructuralPartialEq for ErrorKind

Auto Trait Implementations§

impl Freeze for ErrorKind

impl RefUnwindSafe for ErrorKind

impl Send for ErrorKind

impl Sync for ErrorKind

impl Unpin for ErrorKind

impl UnwindSafe for ErrorKind

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> CloneToUninit for T
where T: Clone,

unsafe fn clone_to_uninit(&self, dest: *mut u8)

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

Performs copy-assignment from self to dest. Read more

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> Pointable for T

const ALIGN: usize

The alignment of pointer.

type Init = T

The type for initializers.

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more

impl<T> ToOwned for T
where T: Clone,

type Owned = T

The resulting type after obtaining ownership.

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more

impl<T> ToString for T
where T: Display + ?Sized,

fn to_string(&self) -> String

Converts the given value to a String. Read more

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

fn vzip(self) -> V

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,