codebase_graph_build
Build a polyglot dependency graph (runs in background — poll with codebasegraphstatus)
How to use it
codebase_graph_build is exposed by the SocratiCode MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the codebase_graph_build tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
Install SocratiCode
claude mcp add socraticode -- npx -y socraticodeOther tools in SocratiCode (25)
Display info about SocratiCode
List all context artifacts defined in .socraticodecontextartifacts.json with names, descriptions, and index status
Index or re-index all artifacts from .socraticodecontextartifacts.json
Remove all indexed context artifacts for a project (blocked while indexing is in progress)
Semantic search across context artifacts (auto-indexes on first use, auto-detects staleness)
Trace forward execution flow from an entry point. Call with no args to discover entry points (orphans, main(), framework routes, tests)
Detect circular dependencies
Query imports and dependents for a specific file
Remove a project's persisted code graph (waits for in-flight graph build to finish first)
Get graph statistics (most connected files, orphans, language breakdown)
Check graph build progress or persisted graph metadata
Generate a Mermaid diagram (mode=mermaid, default) or an interactive HTML explorer (mode=interactive) of the dependency graph. Interactive mode writes a self-contained page (vendored Cytoscape.js + Dagre, works offline) and opens it in your default browser — file + symbol views, blast-radius overlay
Check Docker, Qdrant, and embedding provider status
Blast radius — what files break if you change file/function X (BFS through reverse-call edges)
Start indexing a codebase in the background (poll codebasestatus for progress)
List all indexed projects with paths and metadata
Remove a project's index (safely stops watcher, cancels in-flight indexing/update, waits for graph build)
Hybrid semantic + keyword search (dense + BM25, RRF-fused) with optional file path, language filters, and cross-project search (includeLinked)
Check index status and chunk count
Gracefully stop an in-progress indexing operation (current batch finishes and checkpoints; resume with codebaseindex)
360° view of one symbol — its definition, callers, and callees
List symbols in a file or search by name across the project
Incremental update — only re-indexes changed files
Start/stop file watching — on start, catches up missed changes then watches for future ones
Cytoscape.js + Dagre are vendored inside the SocratiCode package. No CDN, no network, works in air-gapped environments.