ConduitMcp.Errors (ConduitMCP v0.9.0)

Standard error codes for MCP and JSON-RPC 2.0 responses.

These constants can be used with the error/2 response helper or when building error maps manually. All codes follow the JSON-RPC 2.0 specification and MCP protocol extensions.

Usage

With response helpers (DSL and Endpoint modes):

import ConduitMcp.Errors

error("User not found", method_not_found())
error("Bad input", invalid_params())

Building error maps manually:

alias ConduitMcp.Errors

{:error, %{"code" => Errors.invalid_params(), "message" => "Missing required field"}}

JSON-RPC 2.0 Error Codes

Code	Constant	Meaning
`-32700`	`parse_error/0`	Invalid JSON received by the server
`-32600`	`invalid_request/0`	The JSON sent is not a valid Request object
`-32601`	`method_not_found/0`	The method does not exist or is not available
`-32602`	`invalid_params/0`	Invalid method parameters
`-32603`	`internal_error/0`	Internal JSON-RPC error

MCP Error Codes

Code	Constant	Meaning
`-32000`	`server_error/0`	Generic tool/server error (default for `error/1`)
`-32002`	`resource_not_found/0`	The requested resource URI was not found

Summary

Functions

internal_error()

Internal error — unexpected server-side failure (-32603)

invalid_params()

Invalid params — parameter validation failed (-32602)

invalid_request()

Invalid request — not a valid JSON-RPC 2.0 request (-32600)

method_not_found()

Method not found — tool, prompt, or resource does not exist (-32601)

parse_error()

Parse error — invalid JSON received (-32700)

resource_not_found()

Resource not found — the requested URI did not match any resource (-32002)

server_error()

Server error — generic tool/server error, default for error/1 (-32000)