MCP tools
stacklit serve
Fifteen read-only tools. The first seven read stacklit.json; the last eight read the symbol graph (stacklit.graph.json, built in memory when missing).
| Tool | Input | Returns |
|---|---|---|
get_overview |
none | project name and type, languages, frameworks, entrypoints, file and line totals |
get_module |
name (exact module name) |
one module: purpose, exports, types, dependencies, files, activity |
find_module |
query (substring) |
up to 5 modules whose name or purpose contains the query, case-insensitive. It does not search exports or file names. |
list_modules |
none | every module with purpose, file and line counts, activity, sorted by name |
get_dependencies |
module |
the dependency edges that touch that module |
get_hot_files |
none | the most-changed files in the last 90 days |
get_hints |
none | add-feature guidance, test command, env var names, do-not-touch paths |
query_graph |
query, optional budget |
scoped symbol subgraph grouped by file, hard token budget (default 2000) |
shortest_path |
from, to |
shortest path between two symbols with weakest-hop confidence |
explain_symbol |
symbol |
definition, file and line range, signature, callers and callees |
impact |
symbol (name, Type.Method or file path), optional depth, budget |
symbols and files that depend on it |
get_hubs |
optional top |
most connected symbols |
get_communities |
none | deterministic file clusters with labels |
graph_report |
none | key concepts, surprising links, suggested questions |
slice_symbol |
symbol |
only that symbol’s source lines |
The server re-reads stacklit.json whenever its modification time changes, so you do not need to restart it after generate.
Generated from docs/USAGE.md in the repository, the single source of truth.