<strong>X-ray vision for your codebase - built for AI agents, not humans.</strong>
X-ray vision for your codebase - built for AI agents, not humans.. The qartez mcp mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 14 defined tools rather than through you.
Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.
Everything the assistant can do here goes through one of these:
qartez_refs — Trace every usage of a symbol across the codebase, with optional transitive chainsqartez_calls — Call hierarchy: who calls this function, and what does it callqartez_cochange — Files that historically change together in git. Logical coupling invisible to the import graphqartez_context — Smart context builder: given files you plan to modify, returns the optimal set of related files to read firstqartez_unused — Dead-code finder: exported symbols with zero importers, pre-materialized at index timeqartez_diff_impact — Batch impact for a git diff range. Pass a revspec like main..HEAD to get changed files with PageRank, union blast radius, convergence points, andqartez_hotspots — The refactor radar. Ranks files and functions by hotspot score = cyclomatic complexity x PageRank x (1 + churn). Points straight at theqartez_clones — Structural code-clone detection via AST shape hashing (identifiers, literals, and comments are normalized away). Finds duplicate logic the humanqartez_boundaries — Architecture-boundary enforcement. Declare "these modules may not import those" in .qartez/boundaries.toml and get every violating edge backqartez_hierarchy — Type hierarchy queries: find all types implementing a trait/interface, or all traits/interfaces a type implements. Works across Rust, TypeScriptqartez_trend — Complexity trend over git history: tracks how a function's cyclomatic complexity evolved commit by commit. Flags functions that are GROWING, STABLEqartez_security — Security scanner with 13 built-in rules. Regex-based pattern matching scored by PageRank to prioritize high-impact files. Custom rules viaThis sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Qartez MCP's toolset — qartez_refs, qartez_calls, qartez_cochange and 11 more — is a fair guide to whether it matches your workflow. It is maintained by kuberstar; worth a glance at recent repository activity before you build anything load-bearing on it.
We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.
| Tool | What it does |
|---|---|
| qartez_refs | Trace every usage of a symbol across the codebase, with optional transitive chains. |
| qartez_calls | Call hierarchy: who calls this function, and what does it call. |
| qartez_cochange | Files that historically change together in git. Logical coupling invisible to the import graph. |
| qartez_context | Smart context builder: given files you plan to modify, returns the optimal set of related files to read first. |
| qartez_unused | Dead-code finder: exported symbols with zero importers, pre-materialized at index time. |
| qartez_diff_impact | **Batch impact for a git diff range.** Pass a revspec like main..HEAD to get changed files with PageRank, union blast radius, convergence points, and co-change omissions. One call replaces N calls to qartez_impact + qart |
| qartez_hotspots | **The refactor radar.** Ranks files and functions by hotspot score = **cyclomatic complexity x PageRank x (1 + churn)**. Points straight at the highest-risk code in the repo. |
| qartez_clones | Structural code-clone detection via AST shape hashing (identifiers, literals, and comments are normalized away). Finds duplicate logic the human reviewer would never spot. |
| qartez_boundaries | Architecture-boundary enforcement. Declare "these modules may not import those" in .qartez/boundaries.toml and get every violating edge back. suggest=true seeds a starter config from the Leiden clustering. |
| qartez_hierarchy | Type hierarchy queries: find all types implementing a trait/interface, or all traits/interfaces a type implements. Works across Rust, TypeScript, Java, Python, and Go. |
| qartez_trend | Complexity trend over git history: tracks how a function's cyclomatic complexity evolved commit by commit. Flags functions that are GROWING, STABLE, or SHRINKING. |
| qartez_security | Security scanner with 13 built-in rules. Regex-based pattern matching scored by PageRank to prioritize high-impact files. Custom rules via .qartez/security.toml. Filters by severity (low/medium/high/critical) and categor |
| qartez_smells | Code smell detector: finds **god functions** (high complexity + long body), **long parameter lists**, and **feature envy** (methods that use another type more than their own). Tuneable thresholds. |
| qartez_health | **Prioritized fix list.** Cross-references qartez_hotspots with qartez_smells and buckets files as Critical (hotspot + smell), High (hotspot only), or Medium (smell only). Each entry carries a concrete suggested refactor |
### Claude Desktop (manual)
```json
{
"mcpServers": {
"qartez": {
"command": "/absolute/path/to/qartez",
"args": []
}
}
}Configuration as documented by the project. Restart the client after saving.
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.