Struct McpExecuteError 

pub struct McpExecuteError {
    pub code: McpErrorCode,
    pub message: String,
    pub category: McpErrorCategory,
    pub retryable: bool,
    pub retry_after_seconds: Option<u32>,
    pub hint: Option<String>,
    pub cause_chain: Vec<String>,
}

Typed structured-error envelope returned by Everruns’ MCP tools/call execute path. Serialized into the MCP structuredContent field on error responses so the legacy content[0].text channel stays backward-compatible; new SDKs prefer the typed envelope.

See specs/mcp.md for the error contract.

Fields

code: McpErrorCode

Machine-readable error code. Closed vocabulary; SDKs that see an unrecognised value should map it to unknown.

message: String

Human-readable error message. Mirrors the legacy content[0].text string for backward compat.

category: McpErrorCategory

Broad-strokes recovery category.

retryable: bool

true when the same call is worth retrying. Distinct from category == "transient" because a server may know about a non-transient retry path (e.g. a transient Internal).

retry_after_seconds: Option<u32>

Seconds the caller should wait before retrying. Set on tool_timeout, quota_exceeded, and upstream-unreachable cases when the server has a concrete back-off hint.

hint: Option<String>

Short, agent-readable recovery hint. Free-form; one or two sentences.

cause_chain: Vec<String>

Chain of upstream error messages, oldest cause first. Useful for debugging; SDKs should not treat this as machine-readable.

Implementations

impl McpExecuteError

pub fn new(code: McpErrorCode, message: impl Into<String>) -> Self

Construct an error using the code’s default category and retryability. Callers can chain .with_* to override.

pub fn with_category(self, category: McpErrorCategory) -> Self

pub fn with_retryable(self, retryable: bool) -> Self

pub fn with_retry_after_seconds(self, seconds: u32) -> Self

pub fn with_hint(self, hint: impl Into<String>) -> Self

pub fn with_cause(self, cause: impl Into<String>) -> Self

Trait Implementations

impl Clone for McpExecuteError

fn clone(&self) -> McpExecuteError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for McpExecuteError

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for McpExecuteError

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for McpExecuteError

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.