Serverdex error reference · read 21 November 2026

MCP error -32602: Invalid params: what it means and how to fix it

MCP error -32602: Invalid params

A 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.

Shown by: all clients · JSON-RPC code -32602

Causes, most likely first — and the fix for each

  1. 1The model called a tool with arguments that do not match the tool's input schema (missing required field, wrong type).

    Fix: Nothing to change in the config; retry the prompt. If it repeats, the tool's schema is ambiguous — the server page on Serverdex shows each tool's parameters so you can phrase the request to match.

  2. 2The client sent initialize with an unsupported protocol version or capability shape to a strict server.

    Fix: Update the server package; strict servers reject older initialize payloads with -32602.

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 -32603: Internal error · 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.