Skip to content

Exceptions

exceptions

AuthenticationError

Bases: MCPStackError

Raised when authentication with a service fails.

Source code in src/MCPStack/core/utils/exceptions.py 
45
46
class AuthenticationError(MCPStackError):
    """Raised when authentication with a service fails."""

MCPStackBuildError

Bases: MCPStackError

Raised when pipeline build fails.

Source code in src/MCPStack/core/utils/exceptions.py 
25
26
class MCPStackBuildError(MCPStackError):
    """Raised when pipeline build fails."""

MCPStackConfigError

Bases: MCPStackError

Raised for invalid or conflicting configuration.

Source code in src/MCPStack/core/utils/exceptions.py 
29
30
class MCPStackConfigError(MCPStackError):
    """Raised for invalid or conflicting configuration."""

MCPStackError

Bases: Exception

Base class for all MCPStack-related errors.

Provides optional details to ease debugging.

Source code in src/MCPStack/core/utils/exceptions.py 
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
@beartype
class MCPStackError(Exception):
    """Base class for all MCPStack-related errors.

    Provides optional `details` to ease debugging.
    """

    ISSUE_REPORT_URL: str = "https://github.com/MCP-Pipeline/MCPStack/issues/"

    def __init__(self, message: str, details: str | None = None) -> None:
        self.message = message
        self.details = details
        super().__init__(message)

    def __str__(self) -> str:
        base_msg = f"MCPStack Error: {self.message}"
        if self.details:
            base_msg += f"\nDetails: {self.details}"
        return base_msg

MCPStackInitializationError

Bases: MCPStackError

Raised when MCPStack fails to initialize.

Source code in src/MCPStack/core/utils/exceptions.py 
33
34
class MCPStackInitializationError(MCPStackError):
    """Raised when MCPStack fails to initialize."""

MCPStackPresetError

Bases: MCPStackError

Raised when a preset is missing or invalid.

Source code in src/MCPStack/core/utils/exceptions.py 
37
38
class MCPStackPresetError(MCPStackError):
    """Raised when a preset is missing or invalid."""

MCPStackValidationError

Bases: MCPStackError

Raised when validation of tools, env, or pipeline fails.

Source code in src/MCPStack/core/utils/exceptions.py 
41
42
class MCPStackValidationError(MCPStackError):
    """Raised when validation of tools, env, or pipeline fails."""

TokenValidationError

Bases: MCPStackError

Raised when a token is missing, expired, or invalid.

Source code in src/MCPStack/core/utils/exceptions.py 
49
50
class TokenValidationError(MCPStackError):
    """Raised when a token is missing, expired, or invalid."""