yera.tools.mcp.exceptions

Exceptions raised by MCP-backed Yera tools.

Symbols

class MCPAuthenticationError — Base exception for MCP authentication failures.
class MCPAuthenticationRequiredError — Raised when an MCP resource requires authentication.
class MCPError — Base exception for MCP tool integration failures.
class MCPOAuthCallbackError — Raised when an OAuth callback reports failure.
class MCPOAuthCallbackTimeoutError — Raised when OAuth authorization does not return before its deadline.
class MCPOAuthCallbackUnavailableError — Raised when Yera cannot bind the configured OAuth callback endpoint.
class MCPOAuthCancelledError — Raised when the user cancels OAuth authorization.
class MCPOAuthDeviceDeniedError — Raised when the user denies device authorization.
class MCPOAuthDeviceError — Raised when device authorization reports a terminal OAuth error.
class MCPOAuthDeviceExpiredError — Raised when device authorization expires before approval.
class MCPTaskCancelledError — Raised when an MCP task reaches the cancelled state.
class MCPTaskError — Base exception for MCP task lifecycle failures.
class MCPTaskExecutionRequiredError — Raised when an MCP tool requires unsupported task execution.
class MCPTaskExpiredError — Raised when an MCP task has expired or is no longer available.
class MCPTaskFailedError — Raised when an MCP task reaches the failed state.
class MCPTaskInputRequiredError — Raised when an MCP task requires unsupported client input.
class MCPToolCallError — Raised when an MCP server reports that a tool call failed.

MCPAuthenticationRequiredError

Inherits: MCPAuthenticationError

Raised when an MCP resource requires authentication.

Attributes

server_url

MCP resource that rejected the request.

challenge

Complete WWW-Authenticate challenge, when supplied.

MCPError

Inherits: YeraError
Subclasses: MCPAuthenticationError, MCPTaskError, MCPTaskExecutionRequiredError, MCPToolCallError

Base exception for MCP tool integration failures.

MCPOAuthCallbackError

Inherits: MCPAuthenticationError

Raised when an OAuth callback reports failure.

Attributes

error

OAuth error code returned by the authorization server.

description

Optional human-readable provider detail.

MCPOAuthCallbackTimeoutError

Inherits: MCPAuthenticationError

Raised when OAuth authorization does not return before its deadline.

MCPOAuthCallbackUnavailableError

Inherits: MCPAuthenticationError

Raised when Yera cannot bind the configured OAuth callback endpoint.

MCPOAuthCancelledError

Inherits: MCPAuthenticationError

Raised when the user cancels OAuth authorization.

MCPOAuthDeviceDeniedError

Inherits: MCPAuthenticationError

Raised when the user denies device authorization.

MCPOAuthDeviceError

Inherits: MCPAuthenticationError

Raised when device authorization reports a terminal OAuth error.

Attributes

error

OAuth error code returned by the authorization server.

description

Optional human-readable provider detail.

MCPOAuthDeviceExpiredError

Inherits: MCPAuthenticationError

Raised when device authorization expires before approval.

MCPTaskCancelledError

Inherits: MCPTaskError

Raised when an MCP task reaches the cancelled state.

MCPTaskError

Inherits: MCPError
Subclasses: MCPTaskCancelledError, MCPTaskExpiredError, MCPTaskFailedError, MCPTaskInputRequiredError

Base exception for MCP task lifecycle failures.

MCPTaskExecutionRequiredError

Inherits: MCPError

Raised when an MCP tool requires unsupported task execution.

MCPTaskExpiredError

Inherits: MCPTaskError

Raised when an MCP task has expired or is no longer available.

MCPTaskFailedError

Inherits: MCPTaskError

Raised when an MCP task reaches the failed state.

MCPTaskInputRequiredError

Inherits: MCPTaskError

Raised when an MCP task requires unsupported client input.

MCPToolCallError

Inherits: MCPError

Raised when an MCP server reports that a tool call failed.