{
  "mcpServers": {
    "codebase-memory": {
      "command": "/path/to/codebase-memory-mcp",
      "args": []
    }
  }
}

Core Operations

mcp__codebase-memory__index_repository
  project_name: "my-project"
  repo_path: "/path/to/repo"

First index takes 30-120s depending on repo size. Subsequent updates are incremental.

mcp__codebase-memory__index_status
  project_name: "my-project"

mcp__codebase-memory__search_code
  project_name: "my-project"
  query: "authentication middleware"

Returns relevant code snippets without reading entire files.

mcp__codebase-memory__get_architecture
  project_name: "my-project"

Returns high-level architecture: modules, dependencies, entry points.

mcp__codebase-memory__trace_call_path
  project_name: "my-project"
  from_symbol: "handleLogin"
  to_symbol: "validateToken"

mcp__codebase-memory__query_graph
  project_name: "my-project"
  query: "what depends on auth module?"

When to Use

Scenario	Without Graph	With Graph
Code review	Read all changed files + imports	Query impact of changes
Bug investigation	Read 10-20 files manually	Trace call path to bug
Refactoring	Read entire module	Query all dependents
Architecture review	Read project top-down	Get architecture overview

Before reviewing, query the graph for the blast radius of changes:

search_code("functions that call {changed_function}")

Get architecture overview before proposing changes:

get_architecture("project")

Trace call paths to understand bug propagation:

trace_call_path("buggy_function", "entry_point")

Operation	Raw Reading	Graph Query	Savings
Find all callers of function	~50K tokens	~700 tokens	71x
Architecture overview	~200K tokens	~3K tokens	67x
Impact analysis for PR	~30K tokens	~2K tokens	15x
Find related tests	~20K tokens	~1.5K tokens	13x