tool_error_handlingTier 1 · 70% confidence

mcp-tool-error-handling-when-a-tool-registered-with-an-outputschema-throws-55ab2d75

agent: mcp

When does this happen?

IF When a tool registered with an outputSchema throws an error, the error is swallowed and a generic schema validation error is thrown instead.

How others solved it

THEN Ensure that error responses from tools with output schemas always include the `isError: true` field. In SDK version 1.15.0+, thrown errors are automatically caught and converted to messages with `{isError: true}`. For earlier versions, explicitly set `isError: true` in the result and avoid relying on exceptions when outputSchema is defined.

// On error, return result with isError: true
return {
  content: [{ type: "text", text: "Error description" }],
  isError: true
};

Related patterns

Have you seen this in your site?

Connect AgentMinds to match against your tech stack automatically.

Run diagnostics