LearnNewsExamplesServices
Frontmatter
id7495
titleAdd outputSchema to MCP Tool Definitions
stateClosed
labels
enhancementai
assigneestobiu
createdAtOct 15, 2025, 1:44 PM
updatedAtOct 15, 2025, 1:51 PM
githubUrlhttps://github.com/neomjs/neo/issues/7495
authortobiu
commentsCount0
parentIssue7477
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[]
closedAtOct 15, 2025, 1:51 PM

Add outputSchema to MCP Tool Definitions

Closed v11.0.0 enhancementai
tobiu
tobiu commented on Oct 15, 2025, 1:44 PM

The MCP tools/list response currently does not include the optional outputSchema for each tool. While optional, providing this schema will improve the tool definition's completeness and allow clients to better understand and validate the expected response structure.

This ticket covers the work to define the outputSchema using zod, based on the OpenAPI specification, and include its JSON Schema representation in the tool definitions.

Acceptance Criteria

  1. toolService.mjs is refactored to define a zod schema for the successful response of each operation, based on the responses section of openapi.yaml.
  2. The zod schema is converted to a plain JSON Schema using a library like zod-to-json-schema.
  3. The generated JSON Schema is added as the outputSchema property to each tool definition returned by listTools.
  4. The tools/list response is verified to include the new outputSchema for each tool.
tobiu assigned to @tobiu on Oct 15, 2025, 1:44 PM
tobiu added the enhancement label on Oct 15, 2025, 1:44 PM
tobiu added parent issue #7477 on Oct 15, 2025, 1:44 PM
tobiu added the ai label on Oct 15, 2025, 1:44 PM
tobiu referenced in commit 85094ca - "Add outputSchema to MCP Tool Definitions #7495" on Oct 15, 2025, 1:50 PM
tobiu closed this issue on Oct 15, 2025, 1:51 PM