codebase_list_projects
List all indexed projects with paths and metadata
How to use it
codebase_list_projects is exposed by the SocratiCode MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the codebase_list_projects 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)
Build a polyglot dependency graph (runs in background — poll with codebasegraphstatus)
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)
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.