Overview
Resource errors cover failures related to MCP resources — not found, read failures, and invalid URIs.ResourceNotFoundError includes a custom toJsonRpcError() method that returns an MCP-compliant JSON-RPC error with the resource URI.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Errors thrown during resource lookup, reading, and URI validation.
ResourceNotFoundError includes a custom toJsonRpcError() method that returns an MCP-compliant JSON-RPC error with the resource URI.
| Property | Type | Value |
|---|---|---|
code | string | RESOURCE_NOT_FOUND |
statusCode | number | 404 |
isPublic | boolean | true |
uri | string | The requested URI |
mcpErrorCode | number | -32002 |
new ResourceNotFoundError(uri: string)
error.toJsonRpcError();
// { code: -32002, message: "Resource not found: file:///missing.txt", data: { uri: "file:///missing.txt" } }
import { ResourceNotFoundError } from '@frontmcp/sdk';
throw new ResourceNotFoundError('file:///missing.txt');
| Property | Type | Value |
|---|---|---|
code | string | RESOURCE_READ_ERROR |
statusCode | number | 500 |
isPublic | boolean | false |
originalError | Error | undefined | The underlying cause |
new ResourceReadError(uri: string, originalError?: Error)
import { ResourceReadError } from '@frontmcp/sdk';
try {
const data = await fs.readFile(path);
} catch (error) {
throw new ResourceReadError('file:///data.json', error);
}
| Property | Type | Value |
|---|---|---|
code | string | INVALID_RESOURCE_URI |
statusCode | number | 400 |
isPublic | boolean | true |
new InvalidResourceUriError(uri: string, reason?: string)
import { InvalidResourceUriError } from '@frontmcp/sdk';
throw new InvalidResourceUriError('no-scheme', 'URI must have a valid scheme');