codetopo — code graph for AI agents
Queryable code graph of symbols, calls and blast radius for AI coding agents
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.9.0
- Listing updated
- 3 days ago
About codetopo — code graph for AI agents
codetopo — code graph for AI agents is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
codetopo indexes a repository once into a graph stored in SQLite, then answers structural questions as data: what calls this function, what depends on it, and what a change would ripple into. Its Rust core parses Rust, TypeScript/JavaScript and Python with tree-sitter, and it keeps a hash-chained audit log so the graph's own history is tamper-evident.
The design is deliberately domain-blind. It reports measurements, such as counts and rankings with their method stated, and does not score code quality or interpret what the code means. Output is aggregate-first, with totals before lists, to keep token use down; an --expand flag returns full lists.
The stdio MCP server, codetopo-mcp, exposes 20 tools covering symbol dossiers with size and cyclomatic complexity, index-time diagnostics, importance and complexity rankings, coupling measurements, change-impact diffs, callers and callees, and module structure. The same project also ships a CLI, a JSON HTTP server and codetopo-acp, a read-only Agent Client Protocol agent that answers plain-language questions with no LLM and no network. Install needs a Rust toolchain, for example cargo install codetopo-mcp.
Install
Run in a terminal
claude mcp add codetopo -- npx -y codetopo-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"codetopo": {
"command": "npx",
"args": [
"-y",
"codetopo-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"codetopo": {
"command": "npx",
"args": [
"-y",
"codetopo-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"codetopo": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"codetopo-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"codetopo": {
"command": "npx",
"args": [
"-y",
"codetopo-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"codetopo": {
"command": "npx",
"args": [
"-y",
"codetopo-mcp"
]
}
}
}What it does
- Symbol and call graph
- Maps symbols, calls, references and structure into a queryable graph.
- Blast radius
- Shows what a failure or change at a node would take with it.
- Measured rankings
- Ranks symbols by importance or complexity with the method stated.
- Graph diff
- Compares two graphs to show change impact.
- Tamper-evident log
- A hash-chained audit log records the graph's history.
- Other surfaces
- Also provides a CLI, an HTTP API and an ACP agent for editors.
Good for
- Find every caller before changing a function signature
- Give an agent structural context without pasting whole files
- Estimate the blast radius of a refactor
- Onboard onto an unfamiliar repository
- Compare code graphs between two revisions
Pricing
Open source
Open-core; Rust crates
Prices change. Check aimlds.org before you buy.
codetopo — code graph for AI agents FAQ
Which languages are parsed?
Rust, TypeScript/JavaScript and Python via tree-sitter.
How do I install the MCP server?
Run cargo install codetopo-mcp; a Rust toolchain is required.
How many tools does it have?
The MCP server exposes 20 tools.
Does the ACP agent use an LLM?
No. codetopo-acp answers deterministically from the graph, with no LLM, network or file writes.
Is codetopo — code graph for AI agents free?
Yes. codetopo — code graph for AI agents is open source, so you can use and self-host it for free.
How do I add codetopo — code graph for AI agents to Claude Code?
Run this command in your terminal: claude mcp add codetopo -- npx -y codetopo-mcp
What are the best alternatives to codetopo — code graph for AI agents?
The closest alternatives to codetopo — code graph for AI agents are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to codetopo — code graph for AI agents

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools