Enum McpxError 

#[non_exhaustive]
pub enum McpxError {
    Config(String),
    Auth(String),
    Rbac(String),
    RateLimited(String),
    RateLimitedFor {
        message: String,
        retry_after: Duration,
    },
    Io(Error),
    Json(Error),
    Toml(Error),
    Tls(String),
    Startup(String),
    Metrics(String),
}

Generic MCP server error type.

Application crates should define their own error types and convert from/into McpxError where needed.

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.

Config(String)

Configuration parsing or validation failed.

Auth(String)

Authentication failed (bad/missing credential).

Rbac(String)

Authorization (RBAC) denied the request.

RateLimited(String)

Request was rejected by a rate limiter.

RateLimitedFor

Request was rejected by a rate limiter that knows the wait time.

Renders as HTTP 429 with a Retry-After header (RFC 9110 delta-seconds: the duration is rounded up to whole seconds, minimum 1) and the message as a plain-text body. The legacy RateLimited variant remains headerless.

Fields

message: String

Plain-text client-facing message (response body).

retry_after: Duration

Best-effort wait until the next request could be admitted.

Io(Error)

Underlying I/O error.

Json(Error)

JSON (de)serialization error.

Toml(Error)

TOML parse error (configuration loading).

Tls(String)

TLS configuration failure (certificate load, key parse, rustls config).

Startup(String)

Server startup failure (binding, listener, runtime initialization).

Metrics(String)

Metrics registration failure (e.g. Prometheus duplicate or invalid metric).

Trait Implementations

impl Debug for McpxError

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

Formats the value using the given formatter.

impl Display for McpxError

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

Formats the value using the given formatter.

impl Error for McpxError

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<Error> for McpxError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for McpxError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for McpxError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl IntoResponse for McpxError

fn into_response(self) -> Response

Create a response.