Skip to content
MCP server

Trace MCP

Code graph MCP server that indexes your repo once so agents stop re-reading files

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, macOS, Linux
Runs
Locally
Version
3.44.1
Listing updated
3 days ago

About Trace MCP

Trace MCP is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add trace-mcp -- npx -y trace-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "trace-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "trace-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "trace-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "trace-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Freemium

Open source; a paid Max tier is mentioned, prices not published

Prices change. Check trace-mcp.com before you buy.

Trace MCP 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 to Trace MCP

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools