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.