trace-mcp
Coding · tested 2026-09-27 · by the Hlido desk, not the vendor
In short: A genuinely agent-native code-intelligence MCP server — open-source, local-first, broadly integrated — whose headline token-savings claims are asserted without a published, reproducible benchmark.
5 PASS · 0 FAIL of 5 public-surface claims
Quick answer
trace-mcp scores 77/100 (STEADY) on Hlido’s independent, hands-on test (reviewed 2026-09-27). STEADY (77) reflects a coherent, genuinely agent-native product with a strong open-source and security posture (MIT, local-first, zero egress, audited writes), documented broad framework/language coverage, a clean no-key Pricing: Open source (free entry point documented).
trace-mcp is exactly the kind of component the agent ecosystem is short on: an MCP server that indexes a repository once into a framework-aware graph and serves it back to coding agents as precomputed answers instead of files to re-read. The design is agent-first rather than retrofitted — 169 MCP tools over stdio or HTTP, tree-sitter parsing with optional LSP enrichment, and a local SQLite index — and the trust posture is unusually clean for the space: MIT-licensed, no API keys, no cloud, bundled embeddings, and 'no data leaves your machine.' Distribution is real (the page cites ~3.1k npm downloads last month), and the install path is honestly three commands. Where Hlido withholds credit is the marketing's central promise. The '~40–50% fewer tokens on average, up to 94–99% in structured workflows, up to 2×' figures are attributed only to 'baseline agent runs' with no linked methodology, dataset, or third-party reproduction, and the surface carries some internal inconsistency (58 vs 87 integrations, live graph-explorer counters reading 0 in our capture) plus category-defining language ('the execution layer for AI systems') that runs ahead of its 101 GitHub stars. This is a promising, well-secured building block for agent developers; the efficiency numbers should be treated as vendor claims until independently measured, which Hlido has not done here.
Why STEADY
STEADY (77) reflects a coherent, genuinely agent-native product with a strong open-source and security posture (MIT, local-first, zero egress, audited writes), documented broad framework/language coverage, a clean no-key install path, and real npm distribution. It is not scored higher because this is a public-surface review (medium confidence) — Hlido did not install trace-mcp or run it against a live codebase — and the headline token-reduction claims are asserted without a published, reproducible benchmark, alongside modest community traction (101 stars) and some internal inconsistency on the surface.
Public-surface checklist
- PASS Homepage loads (required) — trace-mcp.com returned a full product page (page_title 'trace-mcp — Make AI agents understand your codebase, not just read it')
- PASS Primary value prop (required) — 'Make AI agents understand your codebase — not just read it' — framework-aware MCP server serving precomputed code intelligence
- PASS Cta present (required) — 'GET STARTED IN MINUTES' / 'npm install -g trace-mcp' copy button / 'VIEW ON GITHUB'
- PASS Pricing or access — Free and open source (MIT license), no signup and no API keys required
- PASS Evidence or demo — Install walkthrough with example terminal session, cross-language edge trace example, and an optional desktop graph explorer shown; live graph-explorer counters read 0 in capture
What we saw
4 screenshots captured by the Hlido engine during the reviewed run (run-21c397ad7f35ce6c-trace-mcp-com). Our own captures — not vendor marketing material.
What it does well
- Agent-native by design: an MCP server exposing 169 tools over stdio/HTTP that return answers, not files for the agent to re-read
- Strong trust and security posture — MIT-licensed, runs fully local, no API keys, bundled embeddings, 'no data leaves your machine', dry-run defaults and a guard hook on writes
- Broad documented coverage: tree-sitter parsing plus optional LSP enrichment across many languages, with framework-aware edges for common stacks (Laravel, Django, Next.js, Rails, NestJS, and more)
- Low-friction adoption — a three-command install with no signup, auto-detection of installed MCP clients, and incremental file-watcher reindexing
- Real distribution signal on the surface (~3.1k npm downloads last month) for a young open-source project
What it fails at
- Headline efficiency claims (~40–50% average, up to 94–99%, up to 2× context) are attributed only to unspecified 'baseline agent runs' with no linked methodology, dataset, or independent reproduction
- Internal inconsistency on the public surface — integration counts given as both 58 and 87, and the live graph-explorer counters (languages/integrations/tools) read 0 in Hlido's capture
- Category-creation marketing ('the execution layer for AI systems', 'recomputation → reuse') runs well ahead of demonstrated traction (101 GitHub stars, 2 watching)
- No hands-on behavioral run by Hlido — token savings, tool reliability, and indexing accuracy are asserted by the project, not independently confirmed here
- The heavier features (LSP enrichment, apply_codemod, decision memory, desktop app) are documented capabilities whose real-world reliability is unverified from the public surface
Red flags
- Performance is the product's core promise, yet the ~40–50% / up-to-99% / up-to-2× figures are presented without a reproducible methodology or third-party benchmark — buyers should require their own measurement.
Best for
- Developers building or running AI coding agents (Claude Code, Cursor, Windsurf, VS Code, Codex) who want repository context served over MCP
- Teams wanting a local-first, zero-egress code-intelligence layer with no cloud dependency or API keys
- Engineers on large or multi-framework codebases where blind file-by-file traversal is burning tokens and latency
- Open-source-preferring shops comfortable running and updating a self-hosted CLI/MCP server
Not recommended for
- Buyers who need the token-savings figures verified before adoption — treat them as unmeasured vendor claims
- Teams wanting a managed, hosted, zero-ops service rather than a locally installed CLI/MCP server
- Non-technical users who cannot run a Node.js CLI and wire an MCP client
- Environments where a young, single-maintainer open-source project with modest traction is an unacceptable dependency risk
Pricing & access
- ModelOpen source
- Free entry pointYes — a free tier or open-source edition is documented
- Pricing findable on the public surfacePASS Free and open source (MIT license), no signup and no API keys required (tested 2026-09-27)
Derived from Hlido-held evidence only (engine checklist + editorial text); quotes are verbatim from the scorecard; not vendor-supplied; re-derived daily. Verify current prices on the vendor's pricing page. Last verified 2026-09-27.
Related agents
Agent relevance
API CLI MCP SDK Behavioral-testable
Native MCP server: install the CLI (npm install -g trace-mcp), run 'trace-mcp init' to wire it into an MCP client, then 'trace-mcp add' per repo. Agents then call any of the ~169 tools (search, get_outline, find_usages, get_call_graph, get_change_impact, apply_codemod, …) over stdio or HTTP against a locally indexed graph. An open plugin API lets developers add framework-specific edges. Maximally agent-native — MCP is the primary and intended consumption surface.
Agent-friendly score: 9/10
Score over time
The longitudinal record — every point is the score as published on that date. Raw series.
Evidence
- Framework-aware MCP server that serves a precomputed dependency graph, full-text search, impact analysis and decision memory to cut token usage for AI coding agents — source (2026-09-27) verified
- Open source, MIT-licensed, runs locally with no API keys — 'no data leaves your machine', bundled ONNX embeddings, fully offline after first install — source (2026-09-27) verified
- Installs via 'npm install -g trace-mcp' (Node.js 20+) and exposes 169 MCP tools over stdio or HTTP to Claude Code, Cursor, Windsurf, VS Code and other MCP clients — source (2026-09-27) verified
- ~40–50% fewer tokens on average, up to 94–99% in structured workflows, up to 2× effective context — attributed only to 'baseline agent runs', no published methodology — source (2026-09-27)
- Code-linked decision memory and agent-behavior rules keep reuse the default across sessions — source (2026-09-27)



