server_status

[debug]

Returns server running status, loaded-workspace state, cache metadata, and file-watcher stats. Optionally includes cached workspace load diagnostics.

Why this tool exists

Agents need to confirm that the MCP server is alive, pointed at the expected workspace, and reporting a fresh analysis state before trusting downstream results.

How it helps the agent

It turns setup and cache state into a cheap structured check instead of making the model infer readiness from failed tool calls or shell output.

Try it locally in the GliderMCP playground

Parameters

NameTypeRequiredDescription
includeProjectsbooleanNoInclude detailed project information in response. Default is false.
includeWorkspaceDiagnosticsbooleanNoWhen true, includes cached workspace MSBuild load diagnostics in the response. Default is false.
workspaceDiagnosticsViewstringNoWorkspace diagnostics shape: 'grouped' (default), 'raw', or 'both'.

Examples

Check if the server is running

Request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "server_status",
    "arguments": {}
  }
}
Response
{
  "success": true,
  "data": {
    "serverRunning": true,
    "solutionLoaded": true,
    "solutionPath": "/path/to/solution.sln",
    "cache": {
      "cacheStatus": "valid",
      "revision": 3,
      "lastRefreshUtc": "2026-01-12T21:06:33.123Z",
      "loadedKind": "solution",
      "loadedPath": "/path/to/solution.sln"
    },
    "projectCount": 2,
    "fileWatcher": {
      "enabled": true,
      "watchedDirectory": "/path/to/workspace",
      "pendingChanges": 0,
      "activeOperations": 0
    }
  },
  "error": null
}

Inspect grouped workspace load diagnostics

Request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "server_status",
    "arguments": {
      "includeWorkspaceDiagnostics": true
    }
  }
}
Response
{
  "success": true,
  "data": {
    "serverRunning": true,
    "solutionLoaded": true,
    "solutionPath": "/path/to/solution.sln",
    "cache": {
      "cacheStatus": "valid",
      "revision": 3,
      "lastRefreshUtc": "2026-01-12T21:06:33.123Z",
      "loadedKind": "solution",
      "loadedPath": "/path/to/solution.sln"
    },
    "projectCount": 2,
    "fileWatcher": {
      "enabled": true,
      "watchedDirectory": "/path/to/workspace",
      "pendingChanges": 0,
      "activeOperations": 0
    }
  },
  "error": null
}

Inspect raw workspace load diagnostics

Request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "server_status",
    "arguments": {
      "includeWorkspaceDiagnostics": true,
      "workspaceDiagnosticsView": "raw"
    }
  }
}
Response
{
  "success": true,
  "data": {
    "serverRunning": true,
    "solutionLoaded": true,
    "solutionPath": "/path/to/solution.sln",
    "cache": {
      "cacheStatus": "valid",
      "revision": 3,
      "lastRefreshUtc": "2026-01-12T21:06:33.123Z",
      "loadedKind": "solution",
      "loadedPath": "/path/to/solution.sln"
    },
    "projectCount": 2,
    "fileWatcher": {
      "enabled": true,
      "watchedDirectory": "/path/to/workspace",
      "pendingChanges": 0,
      "activeOperations": 0
    }
  },
  "error": null
}

Response Notes

Returns server/workspace status, cache metadata, and watcher stats. Workspace load diagnostics are included only when requested.

↑/↓ NavigateEnter OpenSpace Expand