Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.langsight.dev/llms.txt

Use this file to discover all available pages before exploring further.

​
GET /api/health/servers

Returns the most recent health check result for each configured server. 
curl http://localhost:8000/api/health/servers

[
  {
    "server_name": "postgres-mcp",
    "status": "up",
    "latency_ms": 42.0,
    "tools_count": 5,
    "schema_hash": "bcf0ec26dff44929",
    "error": null,
    "checked_at": "2026-03-17T12:00:00Z"
  }
]

​
GET /api/health/servers/

Returns the most recent result for one server. Returns 404 if no data exists. 
curl http://localhost:8000/api/health/servers/postgres-mcp

​
GET /api/health/servers//history

Returns health history, newest first. limit parameter: 1–100 (default 10). 
curl "http://localhost:8000/api/health/servers/postgres-mcp/history?limit=20"

​
POST /api/health/check

Triggers an immediate health check against all configured servers. Results are persisted and returned. 
curl -X POST http://localhost:8000/api/health/check

​
GET /api/health/servers//drift-history

Returns recent schema drift events for a server, newest first. limit parameter: 1–100 (default 10). 
curl "http://localhost:8000/api/health/servers/search-mcp/drift-history?limit=10"

[
  {
    "id": "drift-a1b2c3",
    "server_name": "search-mcp",
    "detected_at": "2026-03-26T08:15:42Z",
    "previous_hash": "a9e31f77",
    "current_hash": "c4b7d91e",
    "changes": [
      {
        "change_type": "required_param_added",
        "classification": "BREAKING",
        "tool_name": "search_web",
        "param_name": "filters",
        "param_type": "object"
      }
    ]
  }
]

​
GET /api/health/servers//drift-impact

Returns which agents/sessions called a specific tool within a time window. Used to assess blast radius after a BREAKING drift event. Query parameters: tool_name (required), hours (default 24, max 168). 
curl "http://localhost:8000/api/health/servers/search-mcp/drift-impact?tool_name=search_web&hours=24"

{
  "server_name": "search-mcp",
  "tool_name": "search_web",
  "window_hours": 24,
  "consumers": [
    {
      "agent_name": "research-agent",
      "session_count": 42,
      "last_called_at": "2026-03-26T08:14:00Z"
    }
  ],
  "total_sessions": 42
}

​
GET /api/health/servers//scorecard

Returns the A-F composite grade and dimension breakdown for a server. 
curl http://localhost:8000/api/health/servers/postgres-mcp/scorecard

{
  "server_name": "postgres-mcp",
  "grade": "A+",
  "score": 97.2,
  "dimensions": [
    { "name": "availability",      "weight": 0.30, "raw_score": 100.0, "weighted_score": 30.0 },
    { "name": "security",          "weight": 0.25, "raw_score": 100.0, "weighted_score": 25.0 },
    { "name": "reliability",       "weight": 0.20, "raw_score": 100.0, "weighted_score": 20.0 },
    { "name": "schema_stability",  "weight": 0.15, "raw_score": 100.0, "weighted_score": 15.0 },
    { "name": "performance",       "weight": 0.10, "raw_score":  95.0, "weighted_score":  9.5 }
  ],
  "cap_applied": null,
  "computed_at": "2026-03-26T08:00:00Z"
}
See Server Scorecard for grade thresholds and hard veto caps.

​
Status values

StatusMeaning
upServer responding normally
degradedSchema drift detected — investigate
downServer unreachable
staleNo check in last N minutes
unknownNever checked