Developers
MCP Errors
JSON-RPC error shape and what each code means.
json
{
"jsonrpc": "2.0",
"id": 1,
"error": {
"code": -32001,
"message": "Invalid or missing Canu token."
}
}- -32700 parse error — the request body was not valid JSON
- -32600 invalid request — not a valid JSON-RPC message
- -32601 method not found — unsupported MCP method
- -32602 invalid params — unknown tool or bad arguments
- -32001 unauthorized — missing, revoked or expired bearer token (HTTP 401)
Tool failures are not transport errors: they return a normal result with isError set to true and a text explanation, so the client model can react.