GroundLens
Deterministic checks of LLM answers against sources, with PASS, REVIEW or FAIL
- 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 groundlensAdd to claude_desktop_config.json
{
"mcpServers": {
"groundlens": {
"command": "uvx",
"args": [
"groundlens"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"groundlens": {
"command": "uvx",
"args": [
"groundlens"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools