MCP

MCP SSE stream (org-level)

get

/api/v1/mcp

Server-sent events stream that delivers a single event with the POST endpoint URI so clients can discover where to send MCP requests.

Authorizations

AuthorizationstringRequired

An API key (pk_...) created on the Organisation API page, or an OAuth access token. Every operation requires one.

Responses

200

Successful response

text/event-stream

401

Unauthorized

application/json

403

Forbidden

application/json

429

Too Many Requests; the response carries Retry-After

application/json

500

Internal Server Error

application/json

get/api/v1/mcp

GET /api/v1/mcp HTTP/1.1
Host: sandbox.rootcause.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

MCP Streamable HTTP endpoint (org-level)

post

/api/v1/mcp

Org-level Model Context Protocol endpoint. Accepts a JSON-RPC 2.0 request body and negotiates protocol version from the client's initialize params or the MCP-Protocol-Version header; supported revisions are 2025-11-25, 2025-06-18 and 2025-03-26 (JSON-RPC batching is honoured only on 2025-03-26, which is the one revision that permitted it). A request carrying modern per-request _meta (2026-07-28 and later) is answered with UnsupportedProtocolVersion (-32022) listing what is supported. Capabilities: tools, resources, prompts. Prompts are the platform skills, so they surface as slash commands in MCP clients. tools/list is filtered to the tools the presented credential's scopes permit, and destructive or long-running tools require an explicit confirm: true argument before they run. Session scoped to the organisation (Mcp-Session-Id: org-{orgId}).

Authorizations

AuthorizationstringRequired

An API key (pk_...) created on the Organisation API page, or an OAuth access token. Every operation requires one.

Body

jsonrpcstring · enumRequiredPossible values:

methodstringRequired

paramsobject · nullableOptional

idone of · nullableOptional

stringOptional

or

numberOptional

Responses

200

Successful response

application/json

dataany of · nullableRequired

Payload not declared in this repo

stringOptional

or

numberOptional

or

booleanOptional

or

or

400

Bad Request

application/json

401

Unauthorized

application/json

403

Forbidden

application/json

429

Too Many Requests; the response carries Retry-After

application/json

500

Internal Server Error

application/json

post/api/v1/mcp

POST /api/v1/mcp HTTP/1.1
Host: sandbox.rootcause.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 59

{
  "jsonrpc": "2.0",
  "method": "text",
  "params": null,
  "id": "text"
}

{
  "data": "text"
}