{"componentChunkName":"component---src-templates-redoc-operation-js","path":"/mcp-server-asset/api-reference/openapi/reference/operation/getMcpServerSseStream/","result":{"data":{"contentItem":{"type":"redoc-operation","link":"/mcp-server-asset/api-reference/openapi/reference/operation/getMcpServerSseStream/","data":{"redocStoreStr":"{\"menu\":{\"activeItemIdx\":-1},\"definition\":{\"data\":{\"openapi\":\"3.0.0\",\"info\":{\"title\":\"MCP Server Asset OpenAPI specification\",\"description\":\"Model Context Protocol (MCP) Server Asset API provides access to Celonis data and insights through \\nstandardized JSON-RPC 2.0 protocol endpoints. This API enables AI agents to interact with various \\nCelonis platform tools including data loading, insights generation, knowledge models, etc.\\n\\nThe API implements the MCP specification with support for:\\n- Tool discovery via `tools/list` method\\n- Tool execution via `tools/call` method\\n- Rate limiting per asset (500 calls/minute by default)\\n\",\"x-audience\":\"EX\",\"version\":\"1.0.0\"},\"security\":[{\"BearerAuth\":[]}],\"servers\":[{\"url\":\"https://{team_domain}.{realm}\",\"description\":\"MCP Server Wrapper\",\"variables\":{\"team_domain\":{\"default\":\"my_team\",\"description\":\"Team domain name in Celonis\"},\"realm\":{\"default\":\"eu-1.celonis.cloud\",\"description\":\"Celonis realm (e.g., eu-1.celonis.cloud)\"}}}],\"paths\":{\"/studio-copilot/api/v1/mcp-servers/mcp/{asset_id}\":{\"get\":{\"operationId\":\"getMcpServerSseStream\",\"summary\":\"Establish SSE connection for MCP Server\",\"description\":\"Establishes a Server-Sent Events (SSE) connection for real-time bidirectional communication \\nwith the MCP Server. The connection will automatically timeout after 60 seconds.\\n\",\"tags\":[\"MCP Server\"],\"parameters\":[{\"$ref\":\"#/components/parameters/AssetIdPath\"},{\"$ref\":\"#/components/parameters/DraftQuery\"}],\"responses\":{\"200\":{\"description\":\"SSE connection established successfully\",\"content\":{\"text/event-stream\":{\"schema\":{\"type\":\"string\",\"description\":\"Server-Sent Events stream\"}}}},\"404\":{\"$ref\":\"#/components/responses/NotFound\"},\"500\":{\"$ref\":\"#/components/responses/InternalError\"}}},\"post\":{\"operationId\":\"postMcpServerRequest\",\"summary\":\"Execute MCP protocol requests\",\"description\":\"Routes MCP protocol requests (JSON-RPC 2.0) to the specified MCP Server asset.\\n\\nSupported methods:\\n- `tools/list`: Retrieve available tools for the asset\\n- `tools/call`: Execute a specific tool with arguments\\n\\nRate Limiting: 500 calls per minute per asset. When exceeded, \\nthe response will contain an error with isError=true and retry guidance.\\n\",\"tags\":[\"MCP Server\"],\"parameters\":[{\"$ref\":\"#/components/parameters/AssetIdPath\"},{\"$ref\":\"#/components/parameters/DraftQuery\"}],\"requestBody\":{\"required\":true,\"description\":\"JSON-RPC 2.0 formatted MCP request\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/McpRequest\"},\"examples\":{\"toolsListRequest\":{\"summary\":\"List available tools\",\"value\":{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\",\"params\":{}}},\"toolsCallRequest\":{\"summary\":\"Call a tool (e.g. search_data)\",\"value\":{\"jsonrpc\":\"2.0\",\"id\":4,\"method\":\"tools/call\",\"params\":{\"name\":\"search_data\",\"arguments\":{\"search_terms\":[\"Document Type\"],\"user_query\":\"Document Type\"}}}}}}}},\"responses\":{\"200\":{\"description\":\"Successful MCP response\",\"content\":{\"application/json\":{\"schema\":{\"oneOf\":[{\"$ref\":\"#/components/schemas/McpSuccessResponse\"},{\"$ref\":\"#/components/schemas/McpErrorResponse\"}]}}}},\"404\":{\"$ref\":\"#/components/responses/NotFound\"},\"500\":{\"$ref\":\"#/components/responses/InternalError\"}}}}},\"components\":{\"securitySchemes\":{\"BearerAuth\":{\"type\":\"http\",\"scheme\":\"bearer\",\"bearerFormat\":\"JWT\",\"description\":\"JWT authentication token obtained from Celonis authentication service.\\nThe token must have permissions to USE_OR_EDIT the specified asset.\\n\"}},\"parameters\":{\"AssetIdPath\":{\"name\":\"asset_id\",\"in\":\"path\",\"required\":true,\"description\":\"The unique identifier (UUID) of the MCP Server asset\",\"schema\":{\"type\":\"string\",\"format\":\"uuid\",\"example\":\"56b10c32-97c5-4060-8e3d-12e040f889f2\"}},\"DraftQuery\":{\"name\":\"draft\",\"in\":\"query\",\"required\":false,\"description\":\"Optional flag to indicate draft mode access\",\"schema\":{\"type\":\"boolean\",\"default\":false}}},\"schemas\":{\"McpRequest\":{\"type\":\"object\",\"description\":\"JSON-RPC 2.0 formatted MCP protocol request\",\"required\":[\"jsonrpc\",\"id\",\"method\"],\"properties\":{\"jsonrpc\":{\"type\":\"string\",\"enum\":[\"2.0\"],\"description\":\"JSON-RPC protocol version\",\"example\":\"2.0\"},\"id\":{\"oneOf\":[{\"type\":\"string\"},{\"type\":\"integer\"}],\"description\":\"Unique identifier for the request (will be echoed in response)\",\"example\":1},\"method\":{\"type\":\"string\",\"description\":\"MCP method name\",\"enum\":[\"tools/list\",\"tools/call\"],\"example\":\"tools/list\"},\"params\":{\"type\":\"object\",\"description\":\"Method-specific parameters\",\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"Tool name (required for tools/call)\",\"example\":\"search_data\"},\"arguments\":{\"type\":\"object\",\"description\":\"Tool-specific arguments (required for tools/call)\",\"additionalProperties\":true,\"example\":{\"search_terms\":[\"John Doe\",\"Jane Smith\"],\"user_query\":\"John Doe\"}}}}}},\"McpSuccessResponse\":{\"type\":\"object\",\"description\":\"Successful MCP response (JSON-RPC 2.0 result)\",\"required\":[\"jsonrpc\",\"id\",\"result\"],\"properties\":{\"jsonrpc\":{\"type\":\"string\",\"enum\":[\"2.0\"],\"description\":\"JSON-RPC protocol version\"},\"id\":{\"oneOf\":[{\"type\":\"string\"},{\"type\":\"integer\"}],\"description\":\"Request identifier (matches the request id)\"},\"result\":{\"type\":\"object\",\"description\":\"Method result containing response data\",\"oneOf\":[{\"$ref\":\"#/components/schemas/ToolsListResult\"},{\"$ref\":\"#/components/schemas/ToolsCallResult\"}]}}},\"McpErrorResponse\":{\"type\":\"object\",\"description\":\"Error MCP response (JSON-RPC 2.0 error)\",\"required\":[\"jsonrpc\",\"id\",\"error\"],\"properties\":{\"jsonrpc\":{\"type\":\"string\",\"enum\":[\"2.0\"],\"description\":\"JSON-RPC protocol version\"},\"id\":{\"oneOf\":[{\"type\":\"string\"},{\"type\":\"integer\"}],\"description\":\"Request identifier (matches the request id)\"},\"error\":{\"type\":\"object\",\"required\":[\"code\",\"message\"],\"properties\":{\"code\":{\"type\":\"integer\",\"description\":\"JSON-RPC error code\",\"example\":-32603,\"enum\":[-32700,-32600,-32601,-32602,-32603]},\"message\":{\"type\":\"string\",\"description\":\"Human-readable error message\"},\"data\":{\"type\":\"object\",\"description\":\"Additional error information\",\"additionalProperties\":true}}}}},\"ToolsListResult\":{\"type\":\"object\",\"description\":\"Result for tools/list method\",\"required\":[\"tools\"],\"properties\":{\"tools\":{\"type\":\"array\",\"description\":\"List of available tools for this asset\",\"items\":{\"$ref\":\"#/components/schemas/ToolDefinition\"}}}},\"ToolDefinition\":{\"type\":\"object\",\"description\":\"Definition of an available tool\",\"required\":[\"name\",\"description\",\"inputSchema\"],\"properties\":{\"name\":{\"type\":\"string\",\"description\":\"Unique tool identifier\",\"example\":\"search_data\"},\"description\":{\"type\":\"string\",\"description\":\"Human-readable tool description\",\"example\":\"Retrieves data from the Celonis platform\"},\"inputSchema\":{\"type\":\"object\",\"description\":\"JSON Schema defining the tool's input parameters\",\"additionalProperties\":true},\"outputSchema\":{\"type\":\"object\",\"description\":\"JSON Schema defining the tool's output structure\",\"additionalProperties\":true},\"annotations\":{\"type\":\"object\",\"description\":\"Additional metadata about the tool\",\"additionalProperties\":true}}},\"ToolsCallResult\":{\"type\":\"object\",\"description\":\"Result for tools/call method\",\"required\":[\"content\",\"isError\"],\"properties\":{\"content\":{\"type\":\"array\",\"description\":\"Array of content items (typically text responses)\",\"items\":{\"type\":\"object\",\"required\":[\"type\",\"text\"],\"properties\":{\"type\":{\"type\":\"string\",\"enum\":[\"text\"],\"description\":\"Content type\"},\"text\":{\"type\":\"string\",\"description\":\"Text content (may be JSON string or error message)\"}}}},\"structuredContent\":{\"type\":\"object\",\"description\":\"Optional structured response data (tool-specific format)\",\"additionalProperties\":true,\"example\":{\"page\":0,\"page_size\":50,\"total\":100,\"data_frame_content\":{\"data\":[],\"schema_\":[]}}},\"isError\":{\"type\":\"boolean\",\"description\":\"Indicates if the tool call resulted in an error\",\"example\":false}}},\"ErrorDetail\":{\"type\":\"object\",\"description\":\"Simple error response with detail message\",\"required\":[\"detail\"],\"properties\":{\"detail\":{\"type\":\"string\",\"description\":\"Human-readable error message describing what went wrong\",\"example\":\"Asset not found or not accessible.\"}}}},\"responses\":{\"NotFound\":{\"description\":\"Not Found - The specified resource was not found.\\nThis may occur when:\\n- The asset_id doesn't exist\\n- The asset is not accessible to the authenticated user\\n- The MCP Server feature is not active for this team\\n\",\"content\":{\"application/json\":{\"schema\":{\"$ref\":\"#/components/schemas/ErrorDetail\"},\"examples\":{\"assetNotFound\":{\"summary\":\"Asset not found or not accessible\",\"value\":{\"detail\":\"Asset not found or not accessible.\"}},\"featureNotActive\":{\"summary\":\"MCP Server feature not active\",\"value\":{\"detail\":\"MCP Server Asset feature is not active\"}}}}}},\"InternalError\":{\"description\":\"Internal Server Error - An unexpected error occurred on the server.\\n\",\"content\":{\"text/plain\":{\"schema\":{\"type\":\"string\"},\"example\":\"Internal Server Error\"}}}}},\"tags\":[{\"name\":\"MCP Server\",\"description\":\"Model Context Protocol (MCP) Server endpoints for interacting with Celonis data and insights.\\n\\nAll operations are rate-limited to 500 calls per minute per asset (configurable).\\nRequests follow the JSON-RPC 2.0 protocol specification.\\n\"}]}},\"options\":{\"hideTryItPanel\":false,\"pagination\":\"item\",\"corsProxyUrl\":\"https://cors.redoc.ly\",\"generateCodeSamples\":{\"languages\":[{\"lang\":\"curl\"},{\"lang\":\"JavaScript\"},{\"lang\":\"Java\"},{\"lang\":\"Python\"},{\"lang\":\"PHP\"}]},\"disableSearch\":true,\"ctrlFHijack\":false,\"disableSidebar\":true,\"theme\":{\"overrides\":{\"DownloadButton\":{\"custom\":\"\"},\"NextSectionButton\":{\"custom\":\"\"}},\"codeBlock\":{\"tokens\":{}},\"schema\":{\"constraints\":{},\"examples\":{}},\"rightPanel\":{\"textColor\":\"#eeeeee\"},\"typography\":{\"heading1\":{},\"heading2\":{},\"heading3\":{},\"rightPanelHeading\":{}}}}}","redocHasSecurityDefinitions":false,"redocInfoPageLink":"/mcp-server-asset/api-reference/openapi/reference/overview/","redocItemId":"tag/MCP-Server/operation/getMcpServerSseStream","redocHasInfoPage":false,"settings":{"corsProxyUrl":"https://cors.redoc.ly","generateCodeSamples":{"languages":[{"lang":"curl"},{"lang":"JavaScript"},{"lang":"Java"},{"lang":"Python"},{"lang":"PHP"}]}},"requestLogin":false,"lastModified":"2025-11-03T21:37:26.000Z"},"seo":{"title":"Establish SSE connection for MCP Server"}}},"pageContext":{"id":"e388eb03-88f9-5549-92bd-87fe61d32f92operation/getMcpServerSseStream__redocly content/mcp-server-asset/api-reference/openapi/reference/operation/getMcpServerSseStream/","seo":{"title":"Establish SSE connection for MCP Server","description":"Establishes a Server-Sent Events (SSE) connection for real-time bidirectional communication \nwith the MCP Server. The connection will automatically timeout after 60 seconds.\n","image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"mcp-server-asset/api-reference/openapi/reference.page.yaml#operation/getMcpServerSseStream","pageBaseUrl":"/mcp-server-asset/api-reference/openapi/reference","type":"redoc-operation","toc":{"enable":true,"maxDepth":4,"headings":null},"data":{},"catalogInfo":null,"link":"/mcp-server-asset/api-reference/openapi/reference/operation/getMcpServerSseStream/","sidebarName":"celonis","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":[{"definitionId":"mcp-server-asset","id":"mcp-server-asset","title":"mcp-server-asset","isDefault":true,"apiId":null}],"apiVersionId":null,"isDefaultApiVersion":true}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}