Lens-mcp Server

Every AI tool asks the same model that wrote the answer whether it's any good. It says yes. The Soulfield Lens is outside-in: a separate model runs a fixed gate over your output. It checks text — it…

Local serverstdioMIT

What is the Lens-mcp Server?

lens-mcp is an MCP project maintained in the mrhpython/lens-mcp repository. The maintainer describes its purpose as “Every AI tool asks the same model that wrote the answer whether it's any good. It says yes. The Soulfield Lens is outside-in: a separate…”. Read the project documentation for the complete scope.

Installation

The documented npm package is @soulfield/lens-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares SOULFIELD_API_BASE, SOULFIELD_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
validate_content	Runs the outside-in gate over text. Returns pass/fail, score, per-dimension results, and violation details with reasoning. Optional domain (general, finance…
scrub_pii	Server-side scan for structured PII and secrets — emails, UK/US phone numbers, credit-card numbers, US SSNs, UK NI/UTR numbers, database connection strings…
lens_health	Checks the Lens API is up. Returns status and version.
lens_consistency_leaks	Scans files for deny-list terms (case-insensitive literal). Run on every customer-facing file before an irreversible publish: catches a real client name, an…
lens_consistency_numbers	Checks every numeric literal in a summary actually appears in the body it summarizes. Catches the invented figure. Tripwire: literal matching only, no…
lens_consistency_markers	Checks evidence markers in a source survive into every rendered output — the caveat or citation dropped between formats. Case-SENSITIVE, unlike leaks above…
lens_catches_relevant	Reads the defect bank before you validate: prior named defects for an artifact type, most-recurrent first. Patterns at threshold are marked [PROMOTE] — they…
lens_catches_add	Records a named defect so it is caught next time: what was wrong, the general pattern, the forward rule. Routine passes are rejected by design — only real…
lens_catches_stats	Per-pattern recurrence counts with promote suggestions. Tells you what to harden next.

How to install the Lens-mcp Server

{
  "mcpServers": {
    "soulfield-lens": {
      "command": "npx",
      "args": [
        "@soulfield/lens-mcp"
      ],
      "env": {
        "SOULFIELD_API_BASE": "https://api.soulfield.one",
        "SOULFIELD_API_KEY": "YOUR_SOULFIELD_API_KEY"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
SOULFIELD_API_BASE	Declared in the maintainer’s client configuration.	Check documentation
SOULFIELD_API_KEY	Declared in the maintainer’s client configuration.	Yes