Skip to content
MCP server

Bit Lantern

Local read-only code navigation for AI coding agents, built on a symbol index

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
macOS, Windows, Linux
Runs
Locally
Version
1.0.0-preview.30
Listing updated
2 days ago

About Bit Lantern

Bit Lantern is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Bit Lantern works on the principle that an agent should not read a repository to answer a focused question about it. It builds one disposable SQLite index per workspace, at .bitlantern/index/symbols.db, holding symbols, signatures, exact source ranges and relationships such as imports, calls, inheritance and type use. The agent gets identifiers and coordinates, then reads only the ranges that matter with its normal file tools.

The index stays local and is kept out of git automatically. It honours .gitignore files even outside a git repository, and a .bitlanternignore file adds exclusions of its own. Exclusions are reported rather than silent, through symbol_schema. The documentation says it navigates code that already exists, so an empty new project gives it nothing to map, and it complements search, compilers and language servers instead of replacing them.

The software is proprietary, from Zaguan Labs, and the version documented is 1.0.0-preview.30. It grew out of the Symbols Index in Zaguan Blade and was previously called Atlas Scout. The registry lists native bundles for Apple silicon macOS, Linux on ARM64 and x86-64, and 64-bit Windows; the README notes that preview macOS and Windows binaries are not yet platform-signed.

Install

Run in a terminal

claude mcp add atlas-scout -- npx -y https://github.com/ZaguanLabs/atlas-scout-mcp/releases/download/v1.0.0-preview.30/bitlantern-mcp-1.0.0-preview.30-aarch64-apple-darwin.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "atlas-scout": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ZaguanLabs/atlas-scout-mcp/releases/download/v1.0.0-preview.30/bitlantern-mcp-1.0.0-preview.30-aarch64-apple-darwin.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "atlas-scout": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ZaguanLabs/atlas-scout-mcp/releases/download/v1.0.0-preview.30/bitlantern-mcp-1.0.0-preview.30-aarch64-apple-darwin.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "atlas-scout": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ZaguanLabs/atlas-scout-mcp/releases/download/v1.0.0-preview.30/bitlantern-mcp-1.0.0-preview.30-aarch64-apple-darwin.mcpb"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "atlas-scout": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ZaguanLabs/atlas-scout-mcp/releases/download/v1.0.0-preview.30/bitlantern-mcp-1.0.0-preview.30-aarch64-apple-darwin.mcpb"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "atlas-scout": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ZaguanLabs/atlas-scout-mcp/releases/download/v1.0.0-preview.30/bitlantern-mcp-1.0.0-preview.30-aarch64-apple-darwin.mcpb"
      ]
    }
  }
}

Tools this server provides (1)

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

symbol_schema
Reports the index schema and the paths excluded from discovery.

What it does

Structural code map
Indexes every symbol, signature and exact source range, plus calls, imports, inheritance and type-use relationships.
Bounded answers
Returns definitions, ranges and references so the agent reads a few relevant lines instead of whole files.
Local and disposable index
A per-workspace SQLite index that is git-ignored and sends no code anywhere.
Visible exclusions
Ignore rules are honoured and excluded paths are reported through symbol_schema, capped at 256 entries.
Edit-impact evidence
The README lists static call relationships, architecture summaries and edit-impact evidence for connected agents.
Free and Pro tiers
Free covers symbol search, outlines and one-hop references; Pro adds deeper tracing, caller lists and a shared index.

Good for

  • Find where a function is implemented without grepping the whole repo
  • See which callers a refactor will affect before editing
  • Pick the few files to read first in an unfamiliar codebase
  • Answer how one module connects to another in a monorepo
  • Cut the tokens an agent spends re-reading files

Pricing

Freemium, from $32.5 a month

Free forever; Pro $32.50/month billed yearly ($390) or $39 monthly, 14-day trial

Prices change. Check atlasscout.dev before you buy.

Bit Lantern FAQ

Does my code leave my machine?

The pricing page says Bit Lantern sends nothing of your code anywhere, with no account, key or telemetry on the Free tier.

What does it cost?

Free is $0 with no project limit. Pro is $32.50 a month billed $390 yearly, or $39 a month, with a 14-day trial that needs no card.

Is it open source?

No. Bit Lantern is proprietary; only the packaging metadata and build scripts in the repository are Apache 2.0.

Which platforms are supported?

Preview 30 ships for macOS 15 on Apple silicon, Linux on ARM64 and x86-64, and Windows 11 on x86-64.

Does it work on an empty project?

No. It maps existing code, so a brand-new project gives it little to return.

Is Bit Lantern free?

Bit Lantern has a free plan, with paid plans for more usage or features. Paid plans start at $32.5 a month.

How do I add Bit Lantern to Claude Code?

Run this command in your terminal: claude mcp add atlas-scout -- npx -y https://github.com/ZaguanLabs/atlas-scout-mcp/releases/download/v1.0.0-preview.30/bitlantern-mcp-1.0.0-preview.30-aarch64-apple-darwin.mcpb

What are the best alternatives to Bit Lantern?

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

Alternatives to Bit Lantern

  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