> For the complete documentation index, see [llms.txt](https://docs.rootcause.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rootcause.ai/api-and-integrations/rest-api-reference/mcp.md).

# MCP

## MCP SSE stream (org-level)

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

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"MCP"}],"servers":[{"url":"https://sandbox.rootcause.ai","description":"Sandbox"},{"url":"https://platform.rootcause.ai","description":"Production"},{"url":"http://localhost:3000","description":"Local development"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"An API key (pk_...) created on the Organisation API page, or an OAuth access token. Every operation requires one."}},"responses":{"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"429":{"description":"Too Many Requests; the response carries Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}}}},"paths":{"/api/v1/mcp":{"get":{"operationId":"get-api-v1-mcp","summary":"MCP SSE stream (org-level)","description":"Server-sent events stream that delivers a single event with the POST endpoint URI so clients can discover where to send MCP requests.","tags":["MCP"],"parameters":[],"responses":{"200":{"description":"Successful response","content":{"text/event-stream":{}}},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"}}}}}}
```

## MCP Streamable HTTP endpoint (org-level)

> 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}).

```json
{"openapi":"3.1.0","info":{"title":"RootCause Public API","version":"1.0.0"},"tags":[{"name":"MCP"}],"servers":[{"url":"https://sandbox.rootcause.ai","description":"Sandbox"},{"url":"https://platform.rootcause.ai","description":"Production"},{"url":"http://localhost:3000","description":"Local development"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"An API key (pk_...) created on the Organisation API page, or an OAuth access token. Every operation requires one."}},"schemas":{"JsonRpcRequest":{"type":"object","properties":{"jsonrpc":{"type":"string","enum":["2.0"]},"method":{"type":"string"},"params":{"type":["object","null"],"additionalProperties":{}},"id":{"anyOf":[{"oneOf":[{"type":"string"},{"type":"number"}]},{"type":"null"}]}},"required":["jsonrpc","method"]},"UnspecifiedEnvelope":{"type":"object","properties":{"data":{"anyOf":[{"type":"string"},{"type":"number"},{"type":"boolean"},{"type":"null"},{"type":"object","additionalProperties":{}},{"type":"array","items":{}}],"description":"Payload not declared in this repo"}},"required":["data"]}},"responses":{"400":{"description":"Bad Request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"429":{"description":"Too Many Requests; the response carries Retry-After","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"instance":{"type":"string"}},"required":["type","title","status","detail"]}}}}}},"paths":{"/api/v1/mcp":{"post":{"operationId":"post-api-v1-mcp","summary":"MCP Streamable HTTP endpoint (org-level)","description":"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}).","tags":["MCP"],"parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcRequest"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnspecifiedEnvelope"}}}},"400":{"$ref":"#/components/responses/400"},"401":{"$ref":"#/components/responses/401"},"403":{"$ref":"#/components/responses/403"},"429":{"$ref":"#/components/responses/429"},"500":{"$ref":"#/components/responses/500"}}}}}}
```