Class McpProtocolError

constructor

• new McpProtocolError(
      message: string,
      jsonRpcCode?: number,
      options?: Omit<BaseErrorOptions, "code">,
  ): McpProtocolError

  Parameters

  • message: string
  • OptionaljsonRpcCode: number
  • options: Omit<BaseErrorOptions, "code"> = {}

  Returns McpProtocolError

Optional Readonlycause

Readonlycode

Optional Readonlycontext

ReadonlyerrorId

ReadonlyjsonRpcCode

ReadonlymcpCode

message

name

Optional ReadonlyrecoveryHint

Optionalstack

ReadonlystatusCode

Readonlytimestamp

StaticstackTraceLimit

toDetailedString

• toDetailedString(): string

  Create a human-readable error message including cause chain.

  Returns string

  Detailed error string with cause chain

toJSON

• toJSON(): SerializedError

  Serialize error for logging or API response. Excludes stack trace in production for security.

  Returns SerializedError

  Serialized error object

StaticcaptureStackTrace

• captureStackTrace(targetObject: object, constructorOpt?: Function): void

  Creates a .stack property on targetObject, which when accessed returns a string representing the location in the code at which Error.captureStackTrace() was called.

  const myObject = {};
  Error.captureStackTrace(myObject);
  myObject.stack;  // Similar to `new Error().stack`
  Copy

  The first line of the trace will be prefixed with ${myObject.name}: ${myObject.message}.

  The optional constructorOpt argument accepts a function. If given, all frames above constructorOpt, including constructorOpt, will be omitted from the generated stack trace.

  The constructorOpt argument is useful for hiding implementation details of error generation from the user. For instance:

  function a() {
    b();
  }
  
  function b() {
    c();
  }
  
  function c() {
    // Create an error without stack trace to avoid calculating the stack trace twice.
    const { stackTraceLimit } = Error;
    Error.stackTraceLimit = 0;
    const error = new Error();
    Error.stackTraceLimit = stackTraceLimit;
  
    // Capture the stack trace above function b
    Error.captureStackTrace(error, b); // Neither function c, nor b is included in the stack trace
    throw error;
  }
  
  a();
  Copy

  Parameters

  • targetObject: object
  • OptionalconstructorOpt: Function

  Returns void

StaticinvalidBatch

• invalidBatch(): McpProtocolError

  Create an error for invalid batch request.

  Returns McpProtocolError

StaticinvalidContentType

• invalidContentType(): McpProtocolError

  Create an error for invalid content type.

  Returns McpProtocolError

StaticinvalidJson

• invalidJson(): McpProtocolError

  Create an error for invalid JSON.

  Returns McpProtocolError

StaticinvalidJsonRpc

• invalidJsonRpc(): McpProtocolError

  Create an error for invalid JSON-RPC version.

  Returns McpProtocolError

StaticinvalidParams

• invalidParams(reason: string): McpProtocolError

  Create an invalid params error.

  Parameters

  • reason: string

  Returns McpProtocolError

StaticinvalidRequest

• invalidRequest(reason: string): McpProtocolError

  Create a generic invalid request error.

  Parameters

  • reason: string

  Returns McpProtocolError

StaticisAppError

• isAppError(error: unknown): error is AppError

  Type guard to check if an error is a AppError instance.

  Parameters

  • error: unknown

    The error to check

  Returns error is AppError

  True if error is a AppError

StaticisCancellation

• isCancellation(error: unknown): boolean

  Check if an error is a cancellation error. Handles both OperationCancelledError and native AbortError.

  Parameters

  • error: unknown

    The error to check

  Returns boolean

  True if error represents a cancellation

StaticmethodNotFound

• methodNotFound(method: string): McpProtocolError

  Create a method not found error.

  Parameters

  • method: string

  Returns McpProtocolError

StaticmissingAccept

• missingAccept(): McpProtocolError

  Create an error for missing Accept header.

  Returns McpProtocolError

StaticmissingMethod

• missingMethod(): McpProtocolError

  Create an error for missing method field.

  Returns McpProtocolError

StaticparseError

• parseError(reason: string): McpProtocolError

  Create a parse error.

  Parameters

  • reason: string

  Returns McpProtocolError

StaticprepareStackTrace

• prepareStackTrace(err: Error, stackTraces: CallSite[]): any

  Parameters

  • err: Error
  • stackTraces: CallSite[]

  Returns any

  See

  https://v8.dev/docs/stack-trace-api#customizing-stack-traces

StaticrequestCancelled

• requestCancelled(): McpProtocolError

  Create an error for cancelled request.

  Returns McpProtocolError

Staticwrap

• wrap(error: unknown, defaultMessage?: string): AppError

  Wrap any error as a AppError. If already a AppError, returns it unchanged.

  Parameters

  • error: unknown

    The error to wrap

  • defaultMessage: string = "An unexpected error occurred"

    Message to use if error has none

  Returns AppError

  A AppError instance

StaticwrapWithContext

• wrapWithContext(error: unknown, context: Record<string, unknown>): AppError

  Create a AppError from an unknown error, preserving type if already AppError. Useful for catch blocks where you want to re-throw with additional context.

  Parameters

  • error: unknown

    The error to wrap

  • context: Record<string, unknown>

    Additional context to add

  Returns AppError

  A AppError with merged context