server_status

[debug]

Returns server running status, loaded-workspace state (including an in-progress load with elapsed time and an ETA from the previous load), background analysis warm-up progress, cache metadata, and file-watcher stats. Optionally includes cached workspace load diagnostics and compact project format counts.

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 Glider 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.
includeProjectFormatSummarybooleanNoWhen true, includes compact SDK-style/legacy format and project-kind counts. 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,
    "telemetryEnabled": false,
    "solutionLoaded": false,
    "solutionPath": null,
    "cache": {
      "cacheStatus": "empty",
      "revision": 0,
      "lastRefreshUtc": null,
      "loadedKind": "none",
      "loadedPath": null
    },
    "workspaceLoading": {
      "inProgress": true,
      "path": "/path/to/solution.sln",
      "kind": "solution",
      "startedUtc": "2026-01-12T21:06:03.123Z",
      "elapsedMs": 30000,
      "previousLoad": {
        "durationMs": 91000,
        "loadedUtc": "2026-01-11T09:14:02.000Z",
        "projectCount": 7
      },
      "estimatedRemainingMs": 61000,
      "advice": "Previous load of this workspace took ~91s; about 61s remaining. Re-check server_status in ~61s."
    },
    "workspaceWarmup": {
      "enabled": true,
      "inProgress": true,
      "path": "/path/to/solution.sln",
      "projectsWarmed": 42,
      "totalProjects": 117,
      "elapsedMs": 12000,
      "estimatedRemainingMs": 19000,
      "lastCompletedUtc": null,
      "lastDurationMs": null,
      "advice": "Compilation warm-up in progress (42/117 projects, ~19s remaining). Semantic tools work now, but first calls are slower until it completes."
    },
    "projectCount": 0,
    "fileWatcher": {
      "enabled": false,
      "watchedDirectory": null,
      "pendingChanges": 0,
      "activeOperations": 0
    }
  },
  "error": null
}

Inspect compact project format counts

Request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "server_status",
    "arguments": {
      "includeProjectFormatSummary": true
    }
  }
}
Response
{
  "success": true,
  "data": {
    "serverRunning": true,
    "telemetryEnabled": false,
    "solutionLoaded": false,
    "solutionPath": null,
    "cache": {
      "cacheStatus": "empty",
      "revision": 0,
      "lastRefreshUtc": null,
      "loadedKind": "none",
      "loadedPath": null
    },
    "workspaceLoading": {
      "inProgress": true,
      "path": "/path/to/solution.sln",
      "kind": "solution",
      "startedUtc": "2026-01-12T21:06:03.123Z",
      "elapsedMs": 30000,
      "previousLoad": {
        "durationMs": 91000,
        "loadedUtc": "2026-01-11T09:14:02.000Z",
        "projectCount": 7
      },
      "estimatedRemainingMs": 61000,
      "advice": "Previous load of this workspace took ~91s; about 61s remaining. Re-check server_status in ~61s."
    },
    "workspaceWarmup": {
      "enabled": true,
      "inProgress": true,
      "path": "/path/to/solution.sln",
      "projectsWarmed": 42,
      "totalProjects": 117,
      "elapsedMs": 12000,
      "estimatedRemainingMs": 19000,
      "lastCompletedUtc": null,
      "lastDurationMs": null,
      "advice": "Compilation warm-up in progress (42/117 projects, ~19s remaining). Semantic tools work now, but first calls are slower until it completes."
    },
    "projectCount": 0,
    "fileWatcher": {
      "enabled": false,
      "watchedDirectory": null,
      "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,
    "telemetryEnabled": false,
    "solutionLoaded": false,
    "solutionPath": null,
    "cache": {
      "cacheStatus": "empty",
      "revision": 0,
      "lastRefreshUtc": null,
      "loadedKind": "none",
      "loadedPath": null
    },
    "workspaceLoading": {
      "inProgress": true,
      "path": "/path/to/solution.sln",
      "kind": "solution",
      "startedUtc": "2026-01-12T21:06:03.123Z",
      "elapsedMs": 30000,
      "previousLoad": {
        "durationMs": 91000,
        "loadedUtc": "2026-01-11T09:14:02.000Z",
        "projectCount": 7
      },
      "estimatedRemainingMs": 61000,
      "advice": "Previous load of this workspace took ~91s; about 61s remaining. Re-check server_status in ~61s."
    },
    "workspaceWarmup": {
      "enabled": true,
      "inProgress": true,
      "path": "/path/to/solution.sln",
      "projectsWarmed": 42,
      "totalProjects": 117,
      "elapsedMs": 12000,
      "estimatedRemainingMs": 19000,
      "lastCompletedUtc": null,
      "lastDurationMs": null,
      "advice": "Compilation warm-up in progress (42/117 projects, ~19s remaining). Semantic tools work now, but first calls are slower until it completes."
    },
    "projectCount": 0,
    "fileWatcher": {
      "enabled": false,
      "watchedDirectory": null,
      "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,
    "telemetryEnabled": false,
    "solutionLoaded": false,
    "solutionPath": null,
    "cache": {
      "cacheStatus": "empty",
      "revision": 0,
      "lastRefreshUtc": null,
      "loadedKind": "none",
      "loadedPath": null
    },
    "workspaceLoading": {
      "inProgress": true,
      "path": "/path/to/solution.sln",
      "kind": "solution",
      "startedUtc": "2026-01-12T21:06:03.123Z",
      "elapsedMs": 30000,
      "previousLoad": {
        "durationMs": 91000,
        "loadedUtc": "2026-01-11T09:14:02.000Z",
        "projectCount": 7
      },
      "estimatedRemainingMs": 61000,
      "advice": "Previous load of this workspace took ~91s; about 61s remaining. Re-check server_status in ~61s."
    },
    "workspaceWarmup": {
      "enabled": true,
      "inProgress": true,
      "path": "/path/to/solution.sln",
      "projectsWarmed": 42,
      "totalProjects": 117,
      "elapsedMs": 12000,
      "estimatedRemainingMs": 19000,
      "lastCompletedUtc": null,
      "lastDurationMs": null,
      "advice": "Compilation warm-up in progress (42/117 projects, ~19s remaining). Semantic tools work now, but first calls are slower until it completes."
    },
    "projectCount": 0,
    "fileWatcher": {
      "enabled": false,
      "watchedDirectory": null,
      "pendingChanges": 0,
      "activeOperations": 0
    }
  },
  "error": null
}

Response Notes

Returns server/workspace status, cache metadata, watcher stats, an in-progress load summary under workspaceLoading (with an ETA when a previous load time is known), the background analysis warm-up state under workspaceWarmup (progress, ETA, and advice while the post-load warm-up runs; semantic tools work during it but first calls are slower), and whether anonymous telemetry is enabled. Workspace load diagnostics and project format counts are included only when requested.

↑/↓ NavigateEnter OpenSpace Expand