Browse documentation

find_code

[symbols]

Ranks semantic TypeScript and JavaScript symbol matches and suggests follow-up tools.

Try it locally in the TGlider playground

Parameters

NameTypeRequiredDescription
querystringYesSymbol or code concept to find.
intentstringNoNavigation intent: 'navigate', 'understand', 'refactor', or 'api'. Default: "navigate"
kindstringNoOptional TypeScript symbol kind filter.
projectNamestringNoOptional loaded project name to scope the query.
filePathstringNoWorkspace-relative or absolute file path.
exportedOnlybooleanNoReturn only exported symbols. Default: false
matchModestringNoName match mode: 'exact', 'prefix', or 'contains'. Default: exact matches win when they exist, otherwise contains.
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.

Find a component or service by name

Arguments
{
  "query": "UserService",
  "intent": "understand"
}
Full MCP request
Full MCP request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "find_code",
    "arguments": {
      "query": "UserService",
      "intent": "understand"
    }
  }
}

Response Notes

Returns ranked symbol matches with stable keys, spans, export metadata, next-tool suggestions, and match-mode reporting (appliedMatchMode, suppressedMatches, notes).