René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Schema docs: JSONRPCResponse and SamplingMessageContentBlock missing from documentation","articleBody":"## Summary\n\nTwo type aliases are referenced in the schema reference page but not documented:\n1. `JSONRPCResponse`\n2. `SamplingMessageContentBlock`\n\nClicking these links leads to broken anchors.\n\n## 1. JSONRPCResponse\n\n**In the rendered docs** (e.g., [2025-11-25 schema reference](https://modelcontextprotocol.io/specification/2025-11-25/schema)):\n\n```\nJSONRPCMessage: JSONRPCRequest | JSONRPCNotification | JSONRPCResponse\n```\n\n**Root cause:** Missing `@category JSON-RPC` tag in `schema/2025-11-25/schema.ts`:\n\n```typescript\n/**\n * A response to a request, containing either the result or error.\n */  // \u003c-- Missing @category tag\nexport type JSONRPCResponse = JSONRPCResultResponse | JSONRPCErrorResponse;\n```\n\n## 2. SamplingMessageContentBlock\n\nReferenced in `SamplingMessage` and `CreateMessageResult`:\n```\ncontent: SamplingMessageContentBlock | SamplingMessageContentBlock[]\n```\n\n**Root cause:** No JSDoc comment at all in `schema/2025-11-25/schema.ts`:\n\n```typescript\n}\nexport type SamplingMessageContentBlock =   // \u003c-- No JSDoc comment\n  | TextContent\n  | ImageContent\n  | AudioContent\n  | ToolUseContent\n  | ToolResultContent;\n```\n\n## Fix\n\n**For JSONRPCResponse**, add `@category JSON-RPC`:\n\n```typescript\n/**\n * A response to a request, containing either the result or error.\n *\n * @category JSON-RPC\n */\nexport type JSONRPCResponse = JSONRPCResultResponse | JSONRPCErrorResponse;\n```\n\n**For SamplingMessageContentBlock**, add a JSDoc with `@category`:\n\n```typescript\n/**\n * Content block types that can appear in sampling messages.\n *\n * @category `sampling/createMessage`\n */\nexport type SamplingMessageContentBlock =\n  | TextContent\n  | ImageContent\n  | AudioContent\n  | ToolUseContent\n  | ToolResultContent;\n```\n\nBoth need to be fixed in:\n- `schema/2025-11-25/schema.ts`\n- `schema/draft/schema.ts`\n\nThen regenerate docs with `npm run generate:schema:md`.\n\n\u003csub\u003e[AI Disclaimer](https://gist.github.com/maxisbey/6123d132484e4c533eab519a2800693d)\u003c/sub\u003e","author":{"url":"https://github.com/maxisbey","@type":"Person","name":"maxisbey"},"datePublished":"2025-12-15T13:59:24.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":0},"url":"https://github.com/1982/modelcontextprotocol/issues/1982"}