Serverdex error reference · read 21 November 2026
MCP error -32603: Internal error: what it means and how to fix it
MCP error -32603: Internal errorA standard JSON-RPC code: the server hit an unhandled exception while processing the request. The real cause is in the server's own logs, not in the client.
Shown by: all clients · JSON-RPC code -32603
Causes, most likely first — and the fix for each
1A tool implementation threw (bad credentials for the upstream API, a null value, a network error inside the tool).
Fix: Run the server in a terminal and reproduce the call; the stack trace names the failing tool. Most often an API key or token for the upstream service is missing or expired.
2The server's upstream dependency (database, API) is down.
Fix: Check the upstream service; retry later. For hosted servers the Serverdex live check shows whether the endpoint itself still answers.
Still failing?
Work through the twelve general causes in order in MCP server not working: the causes, in order, check the exact config file path and shape for your client in the client setup guides, or generate a known-good config with the config generator.
Sources (read 21 November 2026)
Other MCP errors: MCP error -32000: Connection closed · MCP error -32001: Request timed out · MCP error -32601: Method not found · MCP error -32602: Invalid params · MCP error -32600: Invalid request · HTTP 406 Not Acceptable from an MCP server · spawn npx ENOENT · spawn uvx ENOENT (and uv, docker) · Server transport closed unexpectedly · Client closed (Cursor) · No tools, prompts, or resources (Cursor) · Unexpected token … is not valid JSON · SSE error: Invalid content type, expected text/event-stream · Could not attach to MCP server (Claude Desktop) · Failed to reconnect to an MCP server (Claude Code) · MCP server needs authentication (401 Unauthorized) · MCP OAuth loop (infinite sign-in tabs) · Tools limited to 40 total (Cursor) · executable file not found in $PATH (Antigravity) · MODULE_NOT_FOUND / No module named mcp.server.fastmcp.