trovex MCP server

<!-- mcp-name: io.github.TsukumoHQ/trovex -->

trovex

trovex: one canonical doc for your coding agents, ~60% fewer tokens.

Your coding agents (Claude Code, Cursor, Windsurf, Zed, any MCP client) reread the repo every session to work out which .md is current, then answer from a guess. You pay for that on every session, every agent, every teammate.

trovex indexes your repo's markdown and exposes one MCP tool. Your agent asks a question; trovex returns the single current doc that answers it as a path:line pointer with a freshness marker (canonical / stale / duplicate), and serves just the section that answers instead of the whole file. Agents also write what they learn back through one shared point, so every agent and teammate reads the same source of truth instead of re-deriving it.

About 60% fewer tokens on doc lookups, measured at equal task-success on our own repo (it varies by yours). Runs locally: vectors in SQLite, embeddings via ONNX, no cloud or API keys.

What you're installing

A 30-second trust check, since the decision happens on the README, not the directory listing:

• First-party, open source. Built and run in production by tsukumo, the team behind it. AGPL-3.0-or-later.
• Local-first, nothing leaves your machine. Vectors in SQLite, embeddings via ONNX. No cloud, no API keys, no network call to answer a query.
• Confined writes, no shell. Six MCP tools: three read-only (trovex, trovexread, trovexsearch) and three that mutate only trovex's own doc store (trovexwrite, trovextag, trovex_delete). No shell execution, no writes to your source files.
• The ~60% is reproducible. Measured at equal task-success on our own repo (median 69%, ~41–81% by repo, n=26, LLM-judged); trovex search prints the savings on yours. Full method at trovex.dev/measure.

Quick start

trovex is in public beta, on PyPI. No clone needed; uv tool install puts trovex on your PATH:

uv tool install trovex   # one-time, no clone
trovex setup             # wire into Claude Code (skill + hooks + MCP); idempotent

trovex index /path/to/your/repo        # index your markdown (~1 min)
trovex search "how do we roll back a deploy?"   # ask, prints the tokens it saved
trovex serve                           # wire into your agent: MCP at /mcp, dashboard at /savings

Don't have uv? It's a one-line install: curl -LsSf https://astral.sh/uv/install.sh | sh (or brew install uv).

The search step is the fast way to see the point: it returns the one canonical doc and prints how many tokens that saved versus reading the top few candidates. Once trovex is wired into your agent over MCP, the same numbers accumulate on the savings dashboard at http://localhost:8765/savings.

Prefer not to install anything yet? uvx trovex search "..." runs a single command in a

throwaway environment, no install.

Wire it into your agent

trovex is an MCP server. Point your client at http://localhost:8765/mcp after trovex serve. Per-client setup (Claude Code, Cursor, Windsurf, Cline, Zed, Roo) is at trovex.dev/for.

Claude Code, one command. trovex setup installs the Claude Code skill, the Active-Memory hooks, and registers the MCP server in one step (idempotent, safe to re-run):

trovex setup

Shortened. The full README is on GitHub.