Topos
Structural code-quality scoring for coding agents, from SLOP to PLATINUM, run locally
- Pricing
- Open source
- Platforms
- CLI, macOS, Linux
- Runs
- Locally
- Version
- 0.15.0
- Listing updated
- 1 day ago
About Topos
Topos is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Topos measures program structure instead of asking an LLM for a review. Each file gets four verdicts: simple, based on AST entropy and control-flow complexity; composable, limiting outward dependencies; secure, checking dangerous API reachability and taint paths in the code property graph; and navigable, which keeps nesting shallow enough for an agent to read and change in one pass. Passing all four earns PLATINUM, and passing none or failing to parse is SLOP.
The agent loop is measure, edit, verify, repeat, with concrete failure locations and next actions returned. A pr-recap command gives a structural before-and-after card and debt ledger for a pull request, without an LLM and fully reproducible. It discovers Python, Rust, JavaScript, TypeScript, C++ and Go.
It is a Rust binary, with analysis running locally and no source sent to an external model. The installer detects supported harnesses, including Claude Code, Codex CLI, Gemini CLI, Cursor and VS Code, and its uninstall command previews and removes everything it added. The README says Topos is used internally at Krv Labs.
Install
Run in a terminal
claude mcp add topos -- uvx topos-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"topos": {
"command": "uvx",
"args": [
"topos-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"topos": {
"command": "uvx",
"args": [
"topos-mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"topos": {
"type": "stdio",
"command": "uvx",
"args": [
"topos-mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"topos": {
"command": "uvx",
"args": [
"topos-mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"topos": {
"command": "uvx",
"args": [
"topos-mcp"
]
}
}
}What it does
- Four verdicts
- Simple, composable, secure and navigable per file.
- Medal scale
- Roll-up from SLOP to PLATINUM that shows which pillar failed.
- PR recap
- Structural before and after for a pull request's changed files.
- Local analysis
- Source code is not sent to an external model.
- Multi-language
- Python, Rust, JavaScript, TypeScript, C++ and Go.
- Clean uninstall
- Removes the harness configuration it added.
Good for
- Ask an agent to fix a repo's worst structural problem and verify it
- Review a pull request's structural debt
- Check code for taint paths and risky APIs
- Keep generated code easy for agents to navigate
Pricing
Open source
Topos FAQ
Does it send my code anywhere?
The README says analysis runs locally and source is not sent to an external model or hosted service.
Which languages are supported?
Python, Rust, JavaScript, TypeScript, C++ and Go.
How do I remove it?
Run topos uninstall, which previews and removes what it added to harness configs.
Is it LLM based?
No. Scores come from program structure.
Is Topos free?
Yes. Topos is open source, so you can use and self-host it for free.
How do I add Topos to Claude Code?
Run this command in your terminal: claude mcp add topos -- uvx topos-mcp
What are the best alternatives to Topos?
The closest alternatives to Topos are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Topos

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools