# Topos

> Topos is an open-source MCP server for developer tools. Structural code-quality scoring for coding agents, from SLOP to PLATINUM, run locally. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, vscode
- **Repository:** https://github.com/krv-labs/topos
- **MCP Registry name:** io.github.Krv-Labs/topos
- **Categories:** developer tools, security
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add topos -- uvx topos-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "topos": {
      "command": "uvx",
      "args": [
        "topos-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "topos": {
      "command": "uvx",
      "args": [
        "topos-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "topos": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "topos-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "topos": {
      "command": "uvx",
      "args": [
        "topos-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "topos": {
      "command": "uvx",
      "args": [
        "topos-mcp"
      ]
    }
  }
}
```

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/topos
