You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Methods of undeclared capabilities return -32603 instead of -32601 #602
On a server that only declares the tools capability, prompts/list (and the other prompt and resource methods) comes back as an Internal error instead of Method not found:
server=MCP::Server.new(name: "repro",version: "1.0.0",tools: [],capabilities: {tools: {}})server.handle_json('{"jsonrpc":"2.0","id":1,"method":"prompts/list"}')# => {"jsonrpc":"2.0","id":1,"error":{"code":-32603,"message":"Internal error","data":"Server does not support prompts (required for prompts/list)"}}server.handle_json('{"jsonrpc":"2.0","id":2,"method":"unknown/x"}')# => {"jsonrpc":"2.0","id":2,"error":{"code":-32601,"message":"Method not found","data":"unknown/x"}}
Over Streamable HTTP on the 2026-07-28 path, the first one ends up as HTTP 200 with -32603, the second as 404 with -32601. The transport spec asks for the 404 in both cases:
If the server does not implement the requested RPC method, it MUST respond with 404 Not Found and a JSON-RPC error with code -32601 (Method not found).
For a client, "the server didn't declare prompts" and "the server has no prompts/list" mean the same thing, and -32603 reads as if the server crashed. I ran into it with the conformance suite (0.2.0-alpha.12, caching scenario against a tools-only server): prompts/list returned JSON-RPC error -32603: Internal error.
The mapping is in Server#handle_request: Methods::MissingRequiredCapabilityError is re-raised with error_type: :internal_error. Raising it with error_code: JsonRpcHandler::ErrorCode::METHOD_NOT_FOUND instead looks like it would fix both protocol eras.
Seen with 1.7.0; main at 9d12f51 has the same code.
Activity
Answer a method of an undeclared capability with Method not found