# Trace MCP

> Trace MCP is a freemium MCP server for developer tools. Code graph MCP server that indexes your repo once so agents stop re-reading files. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, macOS, Linux, Windows
- **Website:** https://trace-mcp.com
- **Repository:** https://github.com/nikolai-vysotskyi/trace-mcp
- **MCP Registry name:** io.github.nikolai-vysotskyi/trace-mcp
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

A tree-sitter parse builds one graph of symbols and edges across 81 languages, with framework plugins (91 listed, such as Laravel, Django, Next.js, NestJS and Rails) resolving routes to controllers, models and pages. Optional LSP data from tsserver, pyright or gopls refines call resolution. The graph is stored locally in SQLite with FTS5 and kept fresh by a file watcher and content-hashed incremental reindex.

The site reports 72.7% fewer input tokens to review a pull request, a median over 60 merged PRs in six repos it does not own, with comprehension at parity (67% vs 65%) and slightly more false positives (0.80 vs 0.58 per PR). It notes these are results for specific builds. 182 tools are available and a preset sets how many a client sees.

It installs with npm, then trace init and trace add. Hooks and routing blocks it adds are configuration you could change yourself. A Max tier is mentioned.

## Features

- **Code graph:** Symbols and edges across 81 languages in one graph.
- **Framework awareness:** 91 integrations resolve routes, models and views.
- **Local index:** SQLite with FTS5, updated incrementally.
- **Tool presets:** Controls how many of 182 tools a client sees.
- **Published benchmarks:** Method for the PR review token result is public.

## Good for

- Reduce tokens spent on PR review
- Find usages before a refactor
- Assess change impact
- Give agents framework-level context

## Install

### Claude Code (Terminal)

```sh
claude mcp add trace-mcp -- npx -y trace-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "trace-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "trace-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "trace-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "trace-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "trace-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "trace-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "trace-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "trace-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "trace-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "trace-mcp"
      ]
    }
  }
}
```

## Tools

- `get_change_impact`: Shows what a change affects.
- `find_usages`: Finds usages of a symbol.
- `apply_rename`: Applies a rename.

## FAQ

### How is it installed?

npm install -g trace-mcp, then trace init and trace add.

### Does it patch my client?

The site says it only changes configuration you could change yourself, with one declinable Max-tier exception.

### What did the benchmark show?

72.7% fewer input tokens on 60 merged PRs, with comprehension at parity.

### Where is the index stored?

Locally in SQLite.

### Is Trace MCP free?

Trace MCP has a free plan, with paid plans for more usage or features.

### How do I add Trace MCP to Claude Code?

Run this command in your terminal: claude mcp add trace-mcp -- npx -y trace-mcp

### What are the best alternatives to Trace MCP?

The closest alternatives to Trace MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/trace-mcp
