trace_correlate_code
[diagnostics]
Maps stored GliderTrace stack-frame evidence to Glider-compatible C# symbol references.
Try it locally in the GliderTrace playground
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| sessionId | string | Yes | Trace session id, for example trc_20260507_123044_ab12cd34. |
| solutionPath | string | No | Optional solution or project path under the workspace root. If omitted, GliderTrace discovers a single workspace solution/project. |
| kinds | json | No | Optional evidence kinds such as testFailure, exception, buildError, buildWarning, log, counter, process, artifact, or warning. |
| cursor | string | No | Pagination cursor from the previous correlation result. Keep the other query arguments unchanged. |
| limit | number | No | Maximum number of evidence items to inspect. Default: 50 |
| pathStyle | string | No | Path style for returned source paths: 'relative' or 'absolute'. Defaults to relative. Default: "relative" |
Examples
Replace sample paths and symbol keys with values from your workspace.
Correlate exceptions to source symbols
{
"sessionId": "trc_20260507_123044_ab12cd34"
}Full MCP request
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "trace_correlate_code",
"arguments": {
"sessionId": "trc_20260507_123044_ab12cd34"
}
}
}Response Notes
Returns matched stack frames, source locations, symbol references, and unresolved evidence notes. Local symbols use the nearest addressable ancestor key. Positions without an addressable key use frame-text resolution.
From GliderTrace 1.0.0: symbolRef.confidence returns candidate instead of exact for a checkout match. correlationBasis is position, frameMethod, or none. sourceIdentity remains unverified, including when the file and line resolve. A candidate does not prove that the captured binary used the current source. Check warnings before using the candidate to explain a failure.
Pass the returned nextCursor as cursor to inspect the next evidence page. Keep the other query arguments unchanged. Read coverage separately from pagination.
GliderTrace 1.0.0 returns compact JSON for every tool. Result fields appear beside success; there is no response-format parameter. success describes the tool call. Check the process or session status and exitCode separately. Scalar results and fields that conflict with reserved names appear under result.
To migrate an envelope consumer, read response.sessionId instead of response.data.sessionId. Stored sessions and exported files keep their formats. --max-response-chars limits response text to 60,000 UTF-16 characters by default. Use 0 to disable it, or at least 1,000. This limit counts text characters, not transport bytes or tokens.
outputLimit.truncated marks omitted response detail. It does not change capture completeness. Use the returned next tool and arguments when available. Do not repeat a command or feedback submission to recover omitted output. For event pages, keep the filters and cursor while reducing limit.
For session details, set includeArtifacts and includeTopFindings to false to reduce output. Check error, actionable meta, warnings, and coverage before drawing conclusions. Internal diagnostics stay in local server logs.