Skip to content
MCP server

Solumbe

Local, deterministic repository context and merge-readiness checks for coding agents

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
4.12.0
Listing updated
3 days ago

About Solumbe

Solumbe is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

The idea is that a model should not grade its own work. This tool ranks which files a request will actually touch, using only the repository, with no model, embeddings or network. Afterwards a gate compares the stated intent against the files the staged diff changed and returns a convergence score and a receipt bound to the exact base and staged tree.

A scope-contract feature lets you declare the expected files before editing; any undeclared file touched later fails the gate until it is amended with a reason. Gates also check secret safety and flag risk-sensitive paths. Recent releases added dependents of changed files (up to three hops, marked EXTRACTED or INFERRED) and a history evaluation that replays past commits as retrieval cases.

It runs locally with no server or account. A passing gate is not a merge approval; CI, review and CODEOWNERS stay separate. Install from npm; setup connects Claude Code, Claude Desktop, Codex CLI, Cursor, VS Code, Gemini CLI and Kimi Code CLI. Formerly called Òtítọ́, MIT licensed.

Install

Run in a terminal

claude mcp add solumbe -- npx -y @bashbop/solumbe

Add to claude_desktop_config.json

{
  "mcpServers": {
    "solumbe": {
      "command": "npx",
      "args": [
        "-y",
        "@bashbop/solumbe"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "solumbe": {
      "command": "npx",
      "args": [
        "-y",
        "@bashbop/solumbe"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "solumbe": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@bashbop/solumbe"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "solumbe": {
      "command": "npx",
      "args": [
        "-y",
        "@bashbop/solumbe"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "solumbe": {
      "command": "npx",
      "args": [
        "-y",
        "@bashbop/solumbe"
      ]
    }
  }
}

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

repo_search
Search the repository at a path or all catalogued repositories
change_impact
Impact of a change, with dependents when given a diff
context_pack
Task-aware repository context
convergence_score
Compare stated intent to files actually changed

What it does

Impact ranking
Rank files a request will touch without a model or network.
Staged-tree gate
Check the exact staged tree with a convergence score and receipt.
Scope contract
Declare expected files and fail on undeclared ones.
Secret and risk checks
Flag credentials and risk-sensitive paths.
Dependents block
Show importing files up to three hops away.
One-step host setup
solumbe install connects supported agent hosts.

Good for

  • Check an agent's diff matched the task before merge
  • Find which files a change request should touch
  • Block unexpected edits outside a declared scope
  • See what depends on a changed file

Pricing

Open source

MIT licence, free

Prices change. Check bashbop.github.io before you buy.

Solumbe FAQ

Does code leave my machine?

The project says no server, no account and no code leaving the machine.

Does a pass mean I can merge?

No. Hosted CI, review and the human decision remain separate.

What was it called before?

Òtítọ́ (@bashbop/otito), renamed in 4.0.0.

What licence?

MIT.

Is Solumbe free?

Yes. Solumbe is open source, so you can use and self-host it for free.

How do I add Solumbe to Claude Code?

Run this command in your terminal: claude mcp add solumbe -- npx -y @bashbop/solumbe

What are the best alternatives to Solumbe?

The closest alternatives to Solumbe are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Solumbe

  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