POST /mcp
Served by the dedicated mcp role. Stateless Streamable HTTP with one JSON-RPC 2.0 message per POST, JSON responses, and no SSE stream. Supports protocol versions 2025-06-18 and 2025-11-25. Initialize negotiates a supported version; subsequent requests must supply MCP-Protocol-Version. Restricted secret keys require mcp:use and each tool’s scope. Full-access keys are refused. Origin must be absent or match the configured allow-list; a refused Origin answers 403 with data.code mcp_origin_refused. Key revocation and scope changes apply within SNAPSHOT_MAX_STALENESS. Tool results return tenant-entered text (organization and connection names, attribute keys) only under an untrusted object, which clients must treat as data, never instructions. Request and response bounds are 256 KiB and 64 KiB respectively. GET returns 405.
- Scope
mcp:use- Auth
- Secret key (
sk_…) - Since
- 1.0
Request body
Section titled “Request body”jsonrpcstring Requiredone of
2.0
A string or integer request identifier; absent for notifications.idanymethodstring Requiredmin length 1 · max length 128
paramsobject
Responses
Section titled “Responses”- 200 Bounded JSON-RPC result or error with catalogue data.code. MCPResponse
- 202 Accepted notification; empty body.
- 400 Invalid JSON-RPC or protocol headers. MCPResponse
- 401 Native secret-key authentication refused. MCPResponse
- 403 Origin refused (mcp_origin_refused) or restricted-key authority refused. MCPResponse
- 413 Request exceeds the 256 KiB bound. MCPResponse
- 429 Per-key call quota exhausted. MCPResponse
- 503 A required tool, audit or quota dependency is unavailable. MCPResponse
- default JSON-RPC refusal. MCPResponse
Errors share one shape; see the error code catalogue.
curl -X POST \ "https://mcp.ohauthcat.com/mcp" \ -H "Authorization: Bearer $OHAUTHCAT_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "method": "example_method"}'const response = await fetch("https://mcp.ohauthcat.com/mcp", { method: "POST", headers: { Authorization: `Bearer ${process.env.OHAUTHCAT_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ "jsonrpc": "2.0", "method": "example_method" }),});const data = await response.json();import osimport requests
response = requests.post( "https://mcp.ohauthcat.com/mcp", headers={"Authorization": f"Bearer {os.environ['OHAUTHCAT_API_KEY']}"}, json={ "jsonrpc": "2.0", "method": "example_method", },)data = response.json(){}