# OnionLens Tor Tools

> OnionLens Tor Tools is a free MCP server for security. Validate v3 onion addresses and fetch a known test specimen; research logging disclosed. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API
- **Website:** https://onionlens.org/docs/
- **Repository:** https://github.com/nellinc/onionlens-public
- **MCP Registry name:** org.onionlens/tor-tools
- **Categories:** security, developer tools
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://onionlens.org/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "tor-tools": {
      "url": "https://onionlens.org/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/onionlens-tor-tools
