Skip to content
MCP server

Topos

Structural code-quality scoring for coding agents, from SLOP to PLATINUM, run locally

Runs locallyStatus and history
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-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "topos": {
      "command": "uvx",
      "args": [
        "topos-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "topos": {
      "command": "uvx",
      "args": [
        "topos-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools