API Reference

Endpoints, transports, and tools.

OpenAPI specs ship with each service in the repository. This page summarizes the public surface.

Ingest (otel-ingest)

https://otlp.signalcortex.ai X-API-Key
  • POST /v1/logs OTLP HTTP logs (JSON or protobuf).
  • POST /v1/traces OTLP HTTP traces (JSON or protobuf).
  • POST /v1/metrics OTLP HTTP metrics (JSON or protobuf).
  • gRPC :4317 OTLP gRPC for logs, traces, and metrics with concurrent streams.

Query API

https://api.signalcortex.ai X-API-Key
  • GET /api/v1/logs/search Search logs by service, severity, and free-text body.
  • GET /api/v1/spans/search Search spans by service, name, and attributes.
  • GET /api/v1/traces/{id} Fetch a full nested-span tree by trace ID.
  • GET /api/v1/metrics/series Time-series metric points by name and label filters.
  • GET /healthz Unauthenticated health check.

MCP server (clickhouse-mcp)

https://mcp.signalcortex.ai X-API-Key (Streamable HTTP transport)
  • TOOL search_logs · search_spans · search_traces · get_trace Core observability search tools.
  • TOOL list_anomalies · get_anomaly_baseline · search_anomaly_correlation Anomaly detection tools.
  • TOOL search_evaluation_results · evaluation_summary · evaluation_regression · evaluation_comparison Quality and release tools.
  • TOOL search_reasoning_steps · reasoning_token_usage · reasoning_quality_analysis Reasoning trace tools.
  • TOOL get_agent_map · search_agent_edges · fleet_health_summary · fleet_top_failing · fleet_activity_feed Agent topology and fleet overview.

Persona router

https://api.signalcortex.ai JWT bearer (Keycloak / Entra ID)
  • GET /personas List personas the caller is entitled to.
  • POST /sessions Create a persona-bound chat session.
  • GET /sessions/{id}/stream SSE stream for chat tokens, tool calls, and approvals.
  • POST /sessions/{id}/messages Send a user message into the active session.
  • GET /anomalies/stream Persona-filtered anomaly event stream (SSE).