{"openapi":"3.1.1","info":{"title":"reopt design public API","version":"1.0.0","description":"Public discovery contract for the reopt design MCP server and service health endpoint."},"servers":[{"url":"https://design.reopt.ai","description":"Production"}],"paths":{"/mcp":{"get":{"operationId":"openMcpSession","summary":"Open or resume a streamable HTTP MCP session","description":"Connect using the Model Context Protocol streamable HTTP transport. Clients send MCP protocol headers and JSON-RPC requests as defined by the MCP specification.","responses":{"200":{"description":"MCP stream or protocol response"},"400":{"$ref":"#/components/responses/ProtocolError"},"401":{"$ref":"#/components/responses/ProtocolError"},"500":{"$ref":"#/components/responses/ProtocolError"}}},"post":{"operationId":"callMcp","summary":"Send an MCP JSON-RPC request","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcRequest"}}}},"responses":{"200":{"description":"MCP JSON-RPC response"},"400":{"$ref":"#/components/responses/ProtocolError"},"401":{"$ref":"#/components/responses/ProtocolError"},"500":{"$ref":"#/components/responses/ProtocolError"}}}},"/api/health":{"get":{"operationId":"getServiceHealth","summary":"Read the public service health status","responses":{"200":{"description":"Service is healthy","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}},"503":{"description":"Service is degraded","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}}},"components":{"responses":{"ProtocolError":{"description":"Machine-readable MCP protocol error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcError"}}}}},"schemas":{"JsonRpcRequest":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"type":"string","const":"2.0"},"id":{"type":["string","number","null"]},"method":{"type":"string","description":"MCP method name"},"params":{"type":"object","additionalProperties":true}}},"JsonRpcError":{"type":"object","required":["jsonrpc","error"],"properties":{"jsonrpc":{"type":"string","const":"2.0"},"id":{"type":["string","number","null"]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}},"HealthResponse":{"type":"object","required":["status","timestamp","checks"],"properties":{"status":{"type":"string","enum":["ok","degraded"]},"timestamp":{"type":"string","format":"date-time"},"version":{"type":"string"},"checks":{"type":"object","additionalProperties":true}}}}}}