OnionLens Tor Tools
Validate v3 onion addresses and fetch a known test specimen; research logging disclosed
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://onionlens.org/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"tor-tools": {
"url": "https://onionlens.org/mcp"
}
}
}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

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