Browse documentation

diagnostic_hotspots

[diagnostics]

Groups TypeScript and JavaScript diagnostics by file, project, category, or code for compact triage.

Try it locally in the TGlider playground

Parameters

NameTypeRequiredDescription
filePathstringNoWorkspace-relative or absolute file path.
projectNamestringNoOptional loaded project name to scope the query.
severitystringNoFilter by 'all', 'error', 'warning', 'suggestion', or 'message'. Default: "all"
diagnosticCodesjsonNoOptional array of TypeScript diagnostic codes.
includeDeclarationFilesbooleanNoInclude diagnostics from declaration files. Default: false
includeGeneratedbooleanNoInclude diagnostics from generated-looking files. Default: false
groupBystringNoGroup by 'file', 'project', 'category', or 'code'. Default: "file"
exampleTakenumberNoMaximum diagnostic examples to include per group.
skipnumberNoNumber of matching results to skip. Default: 0
takenumberNoMaximum number of matching results to return.

Examples

Replace sample paths and symbol keys with values from your workspace.

Group diagnostics by project

Arguments
{
  "groupBy": "project",
  "severity": "error"
}
Full MCP request
Full MCP request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "diagnostic_hotspots",
    "arguments": {
      "groupBy": "project",
      "severity": "error"
    }
  }
}

Response Notes

Returns grouped diagnostic counts and examples, with inferred-project labeling (scope.inferred, inferredProjectCount, notes) when diagnostics may be incomplete.