Skip to content
MCP server

OnionLens Tor Tools

Validate v3 onion addresses and fetch a known test specimen; research logging disclosed

Install
Pricing
Free
Platforms
API
Runs
Remotely
Version
0.1.3
Listing updated
2 days ago

About OnionLens Tor Tools

OnionLens Tor Tools is a free MCP server for security. It runs as a hosted remote server, so there is nothing to install locally.

OnionLens is a Python sensor for applications you own, and this hosted endpoint is a separate, small set of Tor-related tools. It is stateless, answers over Streamable HTTP with JSON, supports protocol versions 2025-03-26 and 2025-06-18, and needs no persistent sessions. A second path, /demo/mcp, is meant for labelled experiments.

The three tools are read-only. One checks the syntax, version and checksum of a v3 onion address, one returns an index of primary-source Tor resources, and one returns a known UTF-8 specimen to test retrieval. The docs include curl examples for initialising, listing tools and calling the fixture.

Logging is disclosed. The hosted research deployment stores data in a private PostgreSQL database with additional canary placements, and its clearnet ingress records an edge-observed IP address. The downloadable middleware is described differently: it keeps bounded request paths, methods, user agents, timestamps and token correlations in local SQLite and sends no telemetry.

Install

Run in a terminal

claude mcp add --transport http tor-tools https://onionlens.org/mcp

Add to Settings → Connectors → Add custom connector

https://onionlens.org/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tor-tools": {
      "url": "https://onionlens.org/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "tor-tools": {
      "type": "http",
      "url": "https://onionlens.org/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "tor-tools": {
      "serverUrl": "https://onionlens.org/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "tor-tools": {
      "type": "http",
      "url": "https://onionlens.org/mcp"
    }
  }
}

Tools this server provides (3)

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

validate_onion_address
Checks v3 syntax, version and checksum of an onion address.
list_resources
Returns an index of primary-source Tor resources.
retrieval_fixture
Returns a known UTF-8 specimen.

What it does

Onion address check
Validates v3 syntax, version and checksum.
Tor resource index
Lists primary-source Tor resources.
Retrieval fixture
Returns a known UTF-8 specimen for testing retrieval.
Stateless endpoint
JSON responses over Streamable HTTP with no sessions.
Demo path
A separate /demo/mcp path for labelled experiments.

Good for

  • Check whether a string is a well-formed v3 onion address
  • Test that an MCP client retrieves known text correctly
  • Point an assistant at primary Tor documentation
  • Evaluate Tor-aware tool integrations in a sandbox path

Pricing

Free

No prices published

Prices change. Check onionlens.org before you buy.

OnionLens Tor Tools FAQ

Are the tools read-only?

Yes. The docs describe three real, read-only tools.

Which protocol versions work?

2025-03-26 and 2025-06-18.

What is logged?

The hosted research deployment uses a private PostgreSQL store and records an edge-observed IP on clearnet ingress; the downloadable middleware stores request metadata locally in SQLite.

Is the middleware free to run?

The sensor is on PyPI as onionlens and needs Python 3.10 or newer with no third-party dependencies.

Is OnionLens Tor Tools free?

Yes. OnionLens Tor Tools is free to use.

How do I add OnionLens Tor Tools to Claude Code?

Run this command in your terminal: claude mcp add --transport http tor-tools https://onionlens.org/mcp

What are the best alternatives to OnionLens Tor Tools?

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

Alternatives to OnionLens Tor Tools

  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