MCP error codes and messages, explained
The message your client prints, what it means, the causes in order of likelihood and the fix for each. Where the Serverdex live check records the same failure on hosted servers, the page lists the servers failing that way today. Generic symptoms (server not showing, stuck on loading tools) are in MCP server not working: the causes, in order.
JSON-RPC and HTTP codes
MCP error -32000: Connection closedThe client opened the server process (stdio) or endpoint and the connection ended before, or right after, the MCP initialize handshake.Claude Desktop · Claude Code · Cursor · VS CodeMCP error -32001: Request timed outThe client sent a request (usually initialize, tools/list or a tools/call) and no response arrived within its timeout.Claude Code · Claude Desktop · CursorMCP error -32601: Method not foundA standard JSON-RPC code: the server received a request for a method it does not implement.Cursor · Claude Code · VS Code · custom clientsMCP error -32602: Invalid paramsA standard JSON-RPC code: the method exists but the parameters were wrong — a missing required argument, a wrong type, or a tool name that does not exist on that server..all clientsMCP error -32603: Internal errorA standard JSON-RPC code: the server hit an unhandled exception while processing the request.all clientsMCP error -32600: Invalid requestA standard JSON-RPC code: the message was valid JSON but not a valid JSON-RPC request — wrong envelope, missing `jsonrpc: "2.0"`, a notification where a request was expected, or an HTTP body the server could not parse as MCP..all clientsHTTP 406 Not AcceptableThe Streamable HTTP transport requires the client to accept both `application/json` and `text/event-stream`.Cursor · VS Code · custom clients · curl
Messages by client
spawn npx ENOENTThe client tried to start the server with `npx` and the operating system could not find an executable called `npx` in the PATH the client inherited.Cursor · Claude Desktop · Claude Code · VS Code · n8nspawn uvx ENOENT · spawn uv ENOENT · spawn docker ENOENTSame failure as `spawn npx ENOENT` for Python and Docker servers: the client cannot find `uvx`, `uv` or `docker` on its PATH.Cursor · Claude Desktop · Claude Code · VS CodeServer transport closed unexpectedly · Transport closedThe stdio or HTTP transport ended while the client still expected it to be open.Claude Desktop · Claude Code · Codex · custom clientsClient closedCursor's MCP panel shows "Client closed" next to a server when the process it started exited at once.CursorNo tools, prompts, or resourcesCursor connected to the server and completed the handshake, but the server's tools/list (and prompts/list, resources/list) answers were empty or never arrived.CursorUnexpected token … is not valid JSON · Unexpected end of JSON inputThe client read a line from the server's stdout that is not JSON-RPC.Claude Desktop · Claude Code · Cursor · VS CodeSSE error: Invalid content type, expected "text/event-stream"The client opened the server URL as a legacy SSE endpoint and the server answered with another content type — JSON (it is a Streamable HTTP server), HTML (a web page) or an error page..Cursor · VS Code · custom clientsCould not attach to MCP serverClaude Desktop started the configured command but did not get a valid MCP handshake back, so the server is shown as unavailable.Claude DesktopFailed to reconnect to <server>Claude Code had a working session with the server, lost it, and its automatic reconnection did not succeed.Claude CodeNeeds authentication · 401 Unauthorized · invalid_tokenThe remote server answered the initialize request with HTTP 401 (or 403): it wants an OAuth sign-in or an API key before it lists tools.Claude Code · Claude Desktop · Cursor · VS Code · Gemini CLIOAuth loop · browser keeps opening authorization tabsThe client starts the OAuth flow, the browser completes it, and the client immediately starts it again.Cursor · Claude Code · VS CodeTools limited to 40 total · Too many MCP tools are enabled for this modelCursor caps the number of MCP tools it sends to the model.Cursorexec: "npx": executable file not found in $PATHAntigravity's Go-based MCP launcher could not resolve the command (`npx`, `uvx`, `node`) because the macOS app, started from the Dock or Spotlight, inherits a minimal PATH without your shell's additions.Google Antigravity (macOS app)MODULE_NOT_FOUND · No module named mcp.server.fastmcpThe server process started but its own imports failed: a Node server cannot find a module it requires, or a Python server imports `mcp.server.fastmcp` from an SDK version where that path no longer exists.all clients (Node and Python servers)