Skip to content
MCP server

GroundLens

Deterministic checks of LLM answers against sources, with PASS, REVIEW or FAIL

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Linux, macOS
Runs
Locally
Version
6.0.5
Listing updated
2 days ago

About GroundLens

GroundLens is an open-source MCP server for ai models and llm tooling. It runs locally on your machine and is started by your AI client.

GroundLens is built around figures. Before anyone acts on an LLM answer, it checks that every number appears in the retrieved passages or follows from them by a sum, difference, ratio or percentage change, compared as exact fractions in the locale and units the documents use. It also checks that a figure belongs to the right company, contract or year, and that the answer matches what was asked, such as percent versus euros.

The decision is PASS, REVIEW or FAIL under your policy, and the signed, hash-chained record is stored before the decision returns. The site says no model, network, account or API key is involved, and that an optional LLM judge only sees answers the exact checks could not reject. It is explicit about limits: a real figure from the wrong row of the right table, or a fact wrong in the passages themselves, is not caught.

The MCP server exposes three tools, and there are Langfuse, OpenTelemetry and Grafana integrations. It installs from PyPI and is Apache-2.0.

Install

Run in a terminal

claude mcp add groundlens -- uvx groundlens

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "groundlens": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "groundlens"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "groundlens": {
      "command": "uvx",
      "args": [
        "groundlens"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "groundlens": {
      "command": "uvx",
      "args": [
        "groundlens"
      ]
    }
  }
}

Tools this server provides (3)

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

verify_answer
Check an answer against its source passages.
verify_run
Verify a run of checks.
verify_records
Verify stored signed records.

What it does

Exact figure checks
Verify numbers and derived arithmetic against passages.
Scope check
Fail real figures taken from another company, contract or year.
Intent check
Flag answers in the wrong kind or unit of figure.
Signed records
Hash and store a record before returning a decision.
Judge escalation
A FAIL never reaches the LLM judge, which can only escalate.
Observability hooks
Send decisions to Langfuse or OpenTelemetry.

Good for

  • Gate financial or legal answers before they reach a user
  • Audit past answers with offline record verification
  • Add a deterministic pre-check ahead of an LLM judge
  • Trace guardrail decisions in Langfuse or Grafana

Pricing

Open source

Free, Apache-2.0

Prices change. Check groundlens.dev before you buy.

GroundLens FAQ

Does it need a model or network?

No. The site says it runs in your process with no server, account, API key, model or network.

What does it return?

PASS, REVIEW or FAIL with reasons, and a signed record.

What does it not catch?

Wrong rows of the right table, sentences the passages never say, and errors in the passages themselves.

Is it free?

Yes, Apache-2.0.

Is GroundLens free?

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

How do I add GroundLens to Claude Code?

Run this command in your terminal: claude mcp add groundlens -- uvx groundlens

What are the best alternatives to GroundLens?

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

Alternatives to GroundLens

  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