superlenz

<p align="center"> <img src="assets/logo.png" alt="SuperLenz Logo" width="240" /> </p>

SuperLenz

Lenz — from Latin "lenticula" (lens). A super-powered lens that magnifies the truth. SuperLenz searches multiple sources, cross-verifies every claim through 10+ rounds, and delivers only credible, validated research.

High-credibility research automation with multi-source cross-verification (10+ rounds)

A Model Context Protocol (MCP) server that automates research tasks with a focus on credibility and accuracy. It performs automatic searching, collection, cross-verification (10+ rounds), and saves results to your preferred storage.

Features

• Multi-Source Search: Web search (Brave, Exa), academic papers (arXiv, Semantic Scholar), GitHub
• 10-Round Cross-Verification: Keyword overlap matching (rounds 1-4), conflict detection (5-8), optional LLM verification (9-10)
• Credibility Scoring: Authority assessment, temporal validation, source weighting
• Flexible Storage: Markdown (default), JSON
• Plugin Architecture: Extensible storage and search providers

Requirements

• Node.js >= 18.0.0
• Any MCP-compatible client

Environment Variables

SuperLenz reads these from the system environment. If a key is available, the corresponding feature is automatically enabled. No key is strictly required — arXiv search is always available.

| Variable | Required | Description | |----------|----------|-------------| | BRAVE_SEARCH_API_KEY | No | Brave Search API key | | EXA_API_KEY | No | Exa Search API key | | SEMANTIC_SCHOLAR_API_KEY | No | Semantic Scholar API key (improves rate limits) | | GITHUB_TOKEN | No | GitHub token for repository search | | ANTHROPIC_API_KEY | No | Enables LLM-based verification (rounds 9-10) | | OUTPUT_PATH | No | Output directory for saved documents (default: ./output) |

Tip: If your MCP client supports an "env" field, you can pass keys there instead of setting them system-wide.

---

MCP Client Configuration

All examples below use npx — no prior installation required.

Claude Desktop

No CLI — edit the JSON config file directly.

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "superlenz": {
      "command": "npx",
      "args": ["-y", "superlenz"]
    }
  }
}

Claude Code (CLI)

Option A — CLI command:

claude mcp add superlenz -- npx -y superlenz

| Flag | Description | |------|-------------| | -s local | Save to .claude/settings.local.json (default) | | -s user | Save to ~/.claude/settings.json (all projects) | | -s project | Save to .mcp.json in the current project root | | -e KEY=val | Set an environment variable | | -t <transport> | Transport type: stdio (default), sse, http |

Management commands:

claude mcp list              # list registered servers
claude mcp remove superlenz  # remove a server

Option B — JSON config:

Edit ~/.claude/settings.json (or .claude/settings.json at the project root):

{
  "mcpServers": {
    "superlenz": {
      "command": "npx",
      "args": ["-y", "superlenz"]
    }
  }
}

Cursor

No CLI "add" command — edit the config file or use the Settings UI.

Open Settings > MCP Servers and add, or edit .cursor/mcp.json (project) / ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "superlenz": {
      "command": "npx",
      "args": ["-y", "superlenz"]
    }
  }
}

Management commands (in Cursor's terminal):

cursor agent mcp list                # list servers
cursor agent mcp enable <id>         # enable a server
cursor agent mcp disable <id>        # disable a server

VS Code (Copilot)

Option A — CLI command:

code --add-mcp '{
  "name": "superlenz",
  "command": "npx",
  "args": ["-y", "superlenz"]
}'

Option B — JSON config:

Edit .vscode/mcp.json in your workspace. Note: VS Code uses the "servers" key (not "mcpServers").

{
  "servers": {
    "superlenz": {
      "command": "npx",
      "args": ["-y", "superlenz"]
    }
  }
}

Or add to VS Code settings.json under "mcp.servers".

Gemini CLI

Option A — CLI command:

gemini mcp add superlenz npx -y superlenz

Management commands:

gemini mcp list              # list registered servers
gemini mcp remove superlenz  # remove a server

Option B — JSON config:

Edit ~/.gemini/settings.json:

{
  "mcpServers": {
    "superlenz": {
      "command": "npx",
      "args": ["-y", "superlenz"]
    }
  }
}

---

MCP Tools

start_research

Start a new research session. Searches multiple sources, cross-verifies claims, generates a document, and saves the result.

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | topic | string | (required) | Research topic or question | | urls | string[] | — | Initial URLs to include in research | | depth | "quick" \| "standard" \| "deep" | "standard" | Verification depth (5 / 10 / 15 rounds) | | storage | "markdown" \| "notion" \| "json" \| "html" \| "confluence" | "markdown" | Storage provider for the final document | | template | "comprehensive" \| "executive-summary" \| "comparison" \| "guide" | "comprehensive" | Document template |

search_sources

Search for sources across multiple providers without running a full research pipeline.

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | query | string | (required) | Search query | | sources | string[] | ["web", "academic"] | Providers: web, academic, github, youtube, reddit | | limit | number | 10 | Maximum results per source (1-50) | | minRelevance | number | 0.5 | Minimum relevance score (0-1) |

get_research_status

Get the current status of a research session.

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | sessionId | string | (required) | Session ID to check |

list_sessions

List all research sessions with optional filtering.

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | status | string | — | Filter by status: initializing, searching, collecting, verifying, generating, saving, completed, failed | | limit | number | 20 | Max sessions to return (1-100) |

cross_verify

Cross-verify a list of claims against optional source URLs.

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | claims | string[] | (required) | List of claims to verify | | topic | string | (required) | Topic context for verification | | sources | string[] | — | Optional source URLs to check against |

save_to_storage

Save a previously generated research document to a storage provider.

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | sessionId | string | (required) | Session ID of the research to save | | provider | "markdown" \| "json" | "markdown" | Storage provider | | destination | string | — | Custom file path or name |

---

License

MIT