semantic_query

[semantic]

Runs compact read-only semantic query patterns for package imports, cross-project API usage, and symbols with references.

Try it locally in the TGlider playground

Parameters

Name	Type	Required	Description
pattern	string	Yes	Query pattern: 'package_importers', 'project_exports_referenced_by_project', or 'symbols_with_references'.
packageName	string	No	Package name for package importer queries.
projectName	string	No	Optional loaded project name to scope the query.
referencedByProjectName	string	No	Project that references another project API.
text	string	No	Optional symbol name text filter.
kind	string	No	Optional TypeScript symbol kind filter.
exportedOnly	boolean	No	Return only exported symbols where the pattern supports it. Default: `false`
surface	string	No	API surface for project export queries: 'entrypoints' or 'allExports'.
exportKind	string	No	Filter exports by 'all', 'value', or 'type'.
includeTypeOnly	boolean	No	Include type-only imports and references where the pattern supports it. Default: `true`
includeReExports	boolean	No	Include re-export relationships where the pattern supports it. Default: `true`
matchSubpaths	boolean	No	Match package subpath imports for package importer queries. Default: `true`
maxReferencesPerSymbol	number	No	Maximum references to include for each symbol result. Default: `5`
candidateLimit	number	No	Maximum candidate symbols to inspect before returning matches. Default: `250`
skip	number	No	Number of matching results to skip. Default: `0`
take	number	No	Maximum number of matching results to return.

Examples

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

Find files importing a package

Arguments 
{
  "pattern": "package_importers",
  "packageName": "react"
}

Full MCP request

Full MCP request 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "semantic_query",
    "arguments": {
      "pattern": "package_importers",
      "packageName": "react"
    }
  }
}

Response Notes

Returns query-specific compact semantic evidence and next-tool hints.