[solution]
Loads a C# solution (.sln/.slnx) or project (.csproj) for analysis. Optionally enables automatic file watching when workingDirectory is provided. Workspace MSBuild load diagnostics are hidden by default; inspect them with server_status or set includeWorkspaceDiagnostics=true to include them inline.
Try this tool in Playground.
| Name | Type | Required | Description |
|---|---|---|---|
| filePath | string | Yes | Absolute path to .sln, .slnx, or .csproj file to load. |
| workingDirectory | string | No | Optional working directory to watch for file changes. When provided, enables automatic sync of changed files. |
| includeProjects | boolean | No | Include detailed project information in response. Default is false. |
| includeWorkspaceDiagnostics | boolean | No | When true, includes cached workspace MSBuild load diagnostics in the response. Default is false. |
Load a solution
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "load",
"arguments": {
"filePath": "/Users/dev/MyProject/MyProject.sln"
}
}
}{
"success": true,
"data": {
"loadedPath": "/Users/dev/MyProject/MyProject.sln",
"loadedKind": "solution",
"projectCount": 2,
"projects": [
{
"name": "MyProject",
"filePath": "/Users/dev/MyProject/MyProject.csproj",
"documentCount": 42
}
],
"fileWatcher": {
"enabled": true,
"watchedDirectory": "/Users/dev/MyProject"
},
"cache": {
"cacheStatus": "valid",
"revision": 1,
"lastRefreshUtc": "2026-01-23T21:06:33.123Z",
"loadedKind": "solution",
"loadedPath": "/Users/dev/MyProject/MyProject.sln"
},
"hints": {
"nextSteps": [
"Workspace load diagnostics were suppressed. Use server_status to inspect the cached diagnostics.",
"The presence of diagnostic messages does not indicate limited functionality of the glider. If you are experiencing issues with missing files or incomplete analysis results, please inspect the workspace diagnostics to determine if there are MSBuild load errors that need to be resolved."
]
}
},
"meta": {
"durationMs": 123,
"cancelled": false,
"timedOut": false,
"timeoutMs": 1200000,
"workspaceDiagnosticsSuppressed": true
},
"error": null
}Load with file watching
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "load",
"arguments": {
"filePath": "/Users/dev/MyProject/MyProject.sln",
"workingDirectory": "/Users/dev/MyProject",
"includeProjects": true
}
}
}{
"success": true,
"data": {
"loadedPath": "/Users/dev/MyProject/MyProject.sln",
"loadedKind": "solution",
"projectCount": 2,
"projects": [
{
"name": "MyProject",
"filePath": "/Users/dev/MyProject/MyProject.csproj",
"documentCount": 42
}
],
"fileWatcher": {
"enabled": true,
"watchedDirectory": "/Users/dev/MyProject"
},
"cache": {
"cacheStatus": "valid",
"revision": 1,
"lastRefreshUtc": "2026-01-23T21:06:33.123Z",
"loadedKind": "solution",
"loadedPath": "/Users/dev/MyProject/MyProject.sln"
},
"hints": {
"nextSteps": [
"Workspace load diagnostics were suppressed. Use server_status to inspect the cached diagnostics.",
"The presence of diagnostic messages does not indicate limited functionality of the glider. If you are experiencing issues with missing files or incomplete analysis results, please inspect the workspace diagnostics to determine if there are MSBuild load errors that need to be resolved."
]
}
},
"meta": {
"durationMs": 123,
"cancelled": false,
"timedOut": false,
"timeoutMs": 1200000,
"workspaceDiagnosticsSuppressed": true
},
"error": null
}Load and include workspace diagnostics
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "load",
"arguments": {
"filePath": "/Users/dev/MyProject/MyProject.sln",
"includeWorkspaceDiagnostics": true
}
}
}{
"success": true,
"data": {
"loadedPath": "/Users/dev/MyProject/MyProject.sln",
"loadedKind": "solution",
"projectCount": 2,
"projects": [
{
"name": "MyProject",
"filePath": "/Users/dev/MyProject/MyProject.csproj",
"documentCount": 42
}
],
"fileWatcher": {
"enabled": true,
"watchedDirectory": "/Users/dev/MyProject"
},
"cache": {
"cacheStatus": "valid",
"revision": 1,
"lastRefreshUtc": "2026-01-23T21:06:33.123Z",
"loadedKind": "solution",
"loadedPath": "/Users/dev/MyProject/MyProject.sln"
},
"hints": {
"nextSteps": [
"Workspace load diagnostics were suppressed. Use server_status to inspect the cached diagnostics.",
"The presence of diagnostic messages does not indicate limited functionality of the glider. If you are experiencing issues with missing files or incomplete analysis results, please inspect the workspace diagnostics to determine if there are MSBuild load errors that need to be resolved."
]
}
},
"meta": {
"durationMs": 123,
"cancelled": false,
"timedOut": false,
"timeoutMs": 1200000,
"workspaceDiagnosticsSuppressed": true
},
"error": null
}Load a standalone project
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "load",
"arguments": {
"filePath": "/Users/dev/MyProject/MyProject.csproj"
}
}
}{
"success": true,
"data": {
"loadedPath": "/Users/dev/MyProject/MyProject.sln",
"loadedKind": "solution",
"projectCount": 2,
"projects": [
{
"name": "MyProject",
"filePath": "/Users/dev/MyProject/MyProject.csproj",
"documentCount": 42
}
],
"fileWatcher": {
"enabled": true,
"watchedDirectory": "/Users/dev/MyProject"
},
"cache": {
"cacheStatus": "valid",
"revision": 1,
"lastRefreshUtc": "2026-01-23T21:06:33.123Z",
"loadedKind": "solution",
"loadedPath": "/Users/dev/MyProject/MyProject.sln"
},
"hints": {
"nextSteps": [
"Workspace load diagnostics were suppressed. Use server_status to inspect the cached diagnostics.",
"The presence of diagnostic messages does not indicate limited functionality of the glider. If you are experiencing issues with missing files or incomplete analysis results, please inspect the workspace diagnostics to determine if there are MSBuild load errors that need to be resolved."
]
}
},
"meta": {
"durationMs": 123,
"cancelled": false,
"timedOut": false,
"timeoutMs": 1200000,
"workspaceDiagnosticsSuppressed": true
},
"error": null
}Returns the loaded path, project list, watcher state, and cache metadata. Inline workspace load diagnostics are included only when requested; otherwise load may return next-step hints when diagnostics were suppressed.