MCP overview

Endpoint

The MCP server lives at https://api.onlucra.com/mcp and speaks JSON-RPC 2.0 over streamable HTTP. Every request requires a bearer token minted for the MCP audience with at least mcp:tools:read; calling tools additionally requires mcp:tools:call.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": { "protocolVersion": "2025-06-18" }
}

Supported methods are initialize (returns server info and capabilities), tools/list (the tools your token can execute), tools/call, and notifications/initialized. Unknown methods return JSON-RPC error -32601.

Discovery

GET /mcp returns the protocol version, transport, and tool catalog for quick inspection, and the full catalog with input schemas is public at GET /v1/mcp/tools.