'%20stroke-width='14'%20opacity='.16'%20filter='url(%23soft)'/%3e%3cpath%20d='M246%2056%2098%20141v118'%20fill='none'%20stroke='url(%23frame)'%20stroke-width='18'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cpath%20d='M98%20259%2067%20290l31%2031v50l148%2085'%20fill='none'%20stroke='url(%23frame)'%20stroke-width='18'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cpath%20d='M266%2056%20414%20141v102'%20fill='none'%20stroke='url(%23frame)'%20stroke-width='18'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cpath%20d='M414%20337v34l-148%2085'%20fill='none'%20stroke='url(%23frame)'%20stroke-width='18'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cpath%20d='M256%20117v278'%20fill='none'%20stroke='url(%23tree)'%20stroke-width='13'%20stroke-linecap='round'/%3e%3cpath%20d='M256%20169%20205%20132h-43'%20fill='none'%20stroke='url(%23tree)'%20stroke-width='11'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cpath%20d='M256%20214%20196%20252h-50'%20fill='none'%20stroke='url(%23tree)'%20stroke-width='11'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cpath%20d='M256%20260%20206%20299l-38%2055'%20fill='none'%20stroke='url(%23tree)'%20stroke-width='11'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cpath%20d='M256%20321%20210%20350v33'%20fill='none'%20stroke='url(%23tree)'%20stroke-width='11'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cg%20fill='%230e1831'%20stroke='url(%23tree)'%20stroke-width='9'%3e%3ccircle%20cx='148'%20cy='132'%20r='14'/%3e%3ccircle%20cx='132'%20cy='252'%20r='14'/%3e%3ccircle%20cx='158'%20cy='367'%20r='14'/%3e%3ccircle%20cx='210'%20cy='397'%20r='14'/%3e%3c/g%3e%3cpath%20d='m302%20174-31%2031%2031%2031'%20fill='none'%20stroke='url(%23patch)'%20stroke-width='13'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3cpath%20d='m350%20174%2031%2031-31%2031'%20fill='none'%20stroke='url(%23patch)'%20stroke-width='13'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3ccircle%20cx='326'%20cy='193'%20r='6'%20fill='%238d48f2'/%3e%3ccircle%20cx='326'%20cy='217'%20r='6'%20fill='%238d48f2'/%3e%3cg%20fill='none'%20stroke='url(%23patch)'%20stroke-width='11'%20stroke-linecap='round'%3e%3cpath%20d='M293%20279h111'/%3e%3cpath%20d='M312%20313h92'%20opacity='.9'/%3e%3cpath%20d='M282%20347h63'%20opacity='.82'/%3e%3cpath%20d='M363%20347h41'%20opacity='.55'/%3e%3c/g%3e%3cpath%20d='M256%20365%20297%20338'%20fill='none'%20stroke='url(%23patch)'%20stroke-width='11'%20stroke-linecap='round'/%3e%3cpath%20d='m297%20338%2013%2013%2024-27'%20fill='none'%20stroke='url(%23patch)'%20stroke-width='10'%20stroke-linecap='round'%20stroke-linejoin='round'/%3e%3c/svg%3e)
Tools
Code intelligence
Choose the smallest AST-aware tool that answers the question.
ast-mcp exposes ast-bro tools directly. There is no generic proxy and no need to retrieve entire source files just to understand structure.
Learn the shape
| Tool | Use it for |
|---|---|
digest | A compact map of an unfamiliar directory |
map | Signatures, fields, headings, and parse health for exact files |
show | The body of one or more known symbols |
surface | The public API after re-export resolution |
context | One symbol plus nearby callers and callees within a token budget |
Find behavior
| Tool | Question |
|---|---|
search | Where is this concept or symbol implemented? |
find_related | What code is structurally or semantically similar to this location? |
callers | Who calls this symbol? |
callees | What does this symbol call? |
trace | How does one symbol reach another? |
implements | Which types implement or extend this type? |
Understand dependencies
depsfollows imports forward.reverse_depsfinds importers.graphreturns the file dependency graph.cyclesidentifies strongly connected components.impactcombines call edges, imports, and affected tests for a proposed change.
Search and rewrite syntax
run uses structural syntax patterns. $NODE matches one node and a metavariable beginning with three dollar signs matches zero or more nodes.
Search omits rewrite. A dry-run includes rewrite and leaves write false. Direct write: true is an exceptional lower-level escape hatch; normal edits belong in guarded file_patch batches.
The pinned ast-bro version rewrites the first match per file, so every rule must be narrowed to one reviewed match.