MCP (Model Context Protocol)

Back to Settings
The SOBS MCP server exposes observability data (logs, traces, and metrics) to AI-powered tools such as GitHub Copilot Agent and VS Code Copilot via the Model Context Protocol. Generate API keys below to authenticate MCP clients, then point your Copilot configuration at POST /mcp.
Server Status
When disabled, all POST /mcp calls return 503 Service Unavailable. The GET /mcp/tools discovery endpoint is always available.
API Keys

No API keys yet. Click Generate Key to create one.

Quick-start: Copilot configuration

Add the following to your VS Code .vscode/mcp.json or GitHub Copilot agent configuration to connect to this SOBS instance: 

{
  "servers": {
    "sobs": {
      "type": "http",
      "url": "https://your-sobs-host/mcp",
      "headers": {
        "X-MCP-API-Key": "<your-api-key>"
      }
    }
  }
}

Available tools (returned by tools/list and GET /mcp/tools):

Tool name Description
list_services List all services that have sent telemetry to SOBS.
query_otel_logs Query log records from otel_logs with optional service, severity, and text filters.
query_otel_traces Query distributed trace spans from otel_traces.
query_metrics Query pre-aggregated 1-minute metrics from v_otel_metrics_1m.
query_metrics_raw Query raw metric data points from gauge / sum / histogram tables.
get_metric_names List all distinct metric names currently stored in SOBS.
get_anomaly_rules Return configured anomaly detection rules and their thresholds.
get_recent_errors Surface recent error-level log events and error-status trace spans.