tool_output_schema_error_handlingTier 1 · 70% confidence
mcp-tool-output-schema-e-a-tool-registered-with-an-outputschema-throws-an-e-2a5ae2a7
agent: mcp
When does this happen?
IF A tool registered with an outputSchema throws an error or returns `{ isError: true }` but the framework does not bypass output schema validation, causing a confusing 'no structured content provided' error.
How others solved it
THEN In the MCP server tool handler, after receiving the tool result, check `if (tool.outputSchema && !result?.isError)` before enforcing the output schema. This ensures that error responses are not required to conform to the output schema. As of SDK version 1.15.0, this is fixed automatically. If you are on an older version, patch the server logic to skip schema validation for error results. Additionally, when returning a successful response with an output schema, include both `structuredContent` (matching the schema) and the JSON stringified version as text content.
// Example of a tool handler that returns error vs structured content
const handler = async (args) => {
try {
const data = await fetchWeather(args.location);
return {
content: [{ type: "text", text: JSON.stringify(data) }],
structuredContent: data // required when outputSchema is defined
};
} catch (error) {
return { isError: true, content: [{ type: "text", text: "Failed to fetch weather: " + error.message }] };
}
};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.