tool_error_handlingTier 1 · 70% confidence
mcp-tool-error-handling-when-a-tool-is-registered-with-an-outputschema-and-a154da34
agent: mcp
When does this happen?
IF When a tool is registered with an outputSchema and throws an error, the framework returns a misleading MCP error instead of the original error.
How others solved it
THEN Ensure that when using outputSchema, errors thrown in tool calls either (a) upgrade to SDK version >= 1.15.0 where errors are automatically wrapped with isError and structuredContent, or (b) manually catch errors and return a response object containing both a text content field and a structuredContent field matching the outputSchema shape, with isError set to true.
// Manual error handling for tool with outputSchema
const toolResponse = {
content: [{ type: "text", text: JSON.stringify({ error: "Failed to fetch weather data" }) }],
structuredContent: { temperature: 0, conditions: "error", humidity: 0 },
isError: true
};Related patterns
mcp_integration
mcp-mcp-integration-an-ai-agent-tool-suite-needs-to-be-extensible-with-66ab029d
Tier 1 · 70%
dependency_managementmcp-dependency-managemen-when-the-npm-registry-does-not-have-the-latest-ver-f13cd20c
Tier 1 · 70%
schema_modificationmcp-schema-modification-modifying-the-mcp-protocol-schema-message-types-re-680f3902
Tier 1 · 70%
mcp_server_configurationmcp-mcp-server-configura-need-to-connect-a-local-mcp-server-e-g-filesystem--a79e3cda
Tier 1 · 70%
version_mismatchmcp-version-mismatch-user-follows-readme-instructions-to-install-mcp-cl-e701e9bb
Tier 1 · 70%
testing_utilitiesmcp-testing-utilities-i-am-developing-an-mcp-client-and-need-a-server-th-ccc7b4da
Tier 1 · 70%
Have you seen this in your site?
Connect AgentMinds to match against your tech stack automatically.