#outputschema
outputSchema only landed in the 2025-06-18 spec revision; before that tools/list returned name, description, inputSchema, and output shape lived as prose in the description. Does that drift faster than a versioned schema?
November 9, 2026 at 11:18 PM
mcp tool tip: declare an outputSchema and the spec says servers MUST return results that conform to it, in structuredContent. put the same json, serialized, in a text block too, for clients that ignore structuredContent.
November 3, 2026 at 7:00 PM
Tip: MCP TypeScript SDK 2.4.0 changes a result shape in a minor. If a tool's outputSchema is z.object().meta({ id }), 2025-11-25 connections drop the { result } wrapper.

Read structuredContent, not .result, and parse it at runtime. A cast won't notice.

#TypeScript #MCP
October 25, 2026 at 9:35 AM
New story: My MCP server's output schemas accepted wrong answers: 7 of 8 tools, found with mcp-drill

MCP lets a tool declare an outputSchema, so a client can check a result before it acts on it.

#mcp #outputschema #jsonschema
https://worklore.dev/s/2026-10-15-my-mcp-server-s-output-schemas-accepted-wrong-answers-7-of-8?utm_source=bluesky&utm_medium=auto
worklore.dev
October 16, 2026 at 1:30 AM
Introducing mcp-tada: typed MCP tool calls for TypeScript.

Snapshot a server's tools/list and every call gets a narrowed tool name, args inferred from inputSchema, and structuredContent typed from outputSchema.

github.com/JoviDeCroock...
GitHub - JoviDeCroock/mcp-tada: Compile-time typed MCP tool calls for TypeScript
Compile-time typed MCP tool calls for TypeScript. Contribute to JoviDeCroock/mcp-tada development by creating an account on GitHub.
github.com
September 10, 2026 at 5:36 PM
3/ Measured from the contract, not behaviour: does a tool's outputSchema declare a boolean or a 2+ enum where that state can live? A spread sample of the 12,429; 18 spoke MCP, 335 tools. Two rulers, opposite errors, so I publish a band.
August 20, 2026 at 9:21 AM
If you're building #MCP developers in TS and are setting a `outputSchema` to your tools, then you MUST provide a `structuredContent` to your CallToolResult (unless it's an error).

You're Welcome!
September 10, 2025 at 1:54 PM
I'm not sure what you're getting at here - performance is from the end user's perspective, not the model's. The model doesn't see anything wrt MCP's outputSchema validation since it's just JSON schema validation in the tool's execution environment on an already-produced response.
September 12, 2025 at 10:07 PM
うーん、これのClientってoutputSchemaのバリデーションやってないのかな "modelcontextprotocol/typescript-sdk: The official Typescript SDK for Model Context Protocol servers and clients" https://github.com/modelcontextprotocol/typescript-sdk
July 3, 2025 at 2:27 PM
見てる: "`2025-06-18` Discrepancy: `structuredContent` does not support full `outputSchema` JSON Schema · Issue #834 · modelcontextprotocol/modelcontextprotocol" https://github.com/modelcontextprotocol/modelcontextprotocol/issues/834
June 29, 2025 at 3:38 PM
just submitted an MCP server as a ChatGPT plugin.

what they require:
→ Stripe identity verify (said 90 days, took 3)
→ OAuth 2.0 + PKCE
→ 3 annotations per tool
→ outputSchema on every tool
→ 5 positive + 3 negative test cases

already had MCP for Claude 80% was done.
July 13, 2026 at 3:57 AM
The schema is defined by the outputSchema property on your tool, which clients can use to validate your outputs. Clients are going to start keeping you honest! 🤯
June 20, 2025 at 5:56 PM
Connect any agent to gateway.pipeworx.io/mcp and it sees:

• 1,007 tools / 295 packs (SEC, FDA, FRED, Census, EPA, ATTOM, ClinicalTrials…)
• Every tool has inputSchema examples + outputSchema
• 15 Resource templates (citable URIs)
• 12 Prompt playbooks
• 5 meta-tools
gateway.pipeworx.io
May 8, 2026 at 8:51 PM
New guide: MCP Structured Output Deep Dive — how outputSchema and structuredContent give MCP tools real return types. Covers schema design, dual responses, validation, tool chaining, and migration. https://chatforest.com/guides/mcp-structured-output-deep-dive/
MCP Structured Output Deep Dive
How outputSchema and structuredContent turn MCP tools into typed functions — schema design, validation, tool chaining, and migration.
chatforest.com
March 27, 2026 at 10:49 PM
Designing MCP tools that agents actually use well — new guide covers outputSchema, structured content, agent-aware response patterns (summary-first, error recovery, confidence scoring), composability, and naming conventions. https://chatforest.com/guides/mcp-tool-design-patterns/
MCP Tool Design Patterns: Building Agent-Friendly, Composable Tools
How to design MCP tools that agents can discover, understand, compose, and recover from.
chatforest.com
March 27, 2026 at 9:58 PM
oh yeah also there's the GitHub MCP server which returns JSON in a text block (and not also in structuredContent) so it's not allowed to have an outputSchema, which I do attempt to handle but I think that should be a crime in some jurisdictions
December 20, 2025 at 6:26 PM