Reference

POST /public/v1/mcp

The MCP server's JSON-RPC 2.0 endpoint: one request in, one response out. Methods include initialize, tools/list, tools/call and ping. No token required.

2 min read

POSTHTTP method

NoneAuth

publicRing

Endpoint

Method	`POST`
Path	`/public/v1/mcp`
Ring	public (unauthenticated, rate-limited)

Parameters

A JSON-RPC 2.0 request body. Supported methods:

initialize — begin an MCP session; returns server capabilities.
notifications/initialized — client-ready notification.
ping — liveness.
tools/list — enumerate the available tools.
tools/call — invoke a tool by name with arguments.

Response

A single JSON-RPC 2.0 response (MCP Streamable HTTP). For tools/call, the result is the tool's structured output — for example a get_quote result. Invalid parameters surface as a JSON-RPC -32602 error carrying the underlying endpoint's detail; unknown methods as -32601.

Errors

JSON-RPC errors: -32700 parse error, -32600 invalid request, -32601 method not found, -32602 invalid params. Transport 429 on rate-limit (the handler carries its own per-IP limit).

Frequently asked questions

How do I list the available tools?

Send a tools/list JSON-RPC call to POST /public/v1/mcp. The result enumerates each tool with its name, description and input schema, which you can then invoke with tools/call.

What is the -32602 error?

The JSON-RPC invalid-params code. On get_quote it means your amount or term is out of range; the error detail carries the endpoint's own 422 explanation so you can clamp the input and retry.