mcpField
T
tor-mcp

tor-mcp

Remote
github.com/globalionSecurity1Updated 15w ago
Repository

About tor-mcp

tor-mcp is an MCP server that routes HTTP requests through Tor for MCP-compatible agents. It offers circuit changes, exit-node details, and .onion access, while documenting Tor's limits on Cloudflare-protected sites.

Key features

  1. 01HTTP requests through Tor
  2. 02Exit IP and country lookup
  3. 03Request a new Tor circuit
  4. 04Check URL reachability through Tor
  5. 05No logging of request bodies

Use cases

  1. 01Fetch pages on non-Cloudflare sites through Tor
  2. 02Access .onion services
  3. 03Test a site from different Tor exits

MCP support

The server provides four tools to MCP clients: tor_fetch, tor_get_exit_ip, tor_new_circuit, and tor_check.

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttps://tor.regiq.in/api/mcp
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

All endpoints
Streamable HTTPhttps://tor.regiq.in/api/mcpAuth required

Tools

Details

From the project README

tor-mcp

Route HTTP requests through the Tor network from any MCP-compatible agent.

Live at tor.regiq.in · Free forever · Google sign-in

What it does

Gives Claude Desktop / Cursor / any MCP client four tools:

ToolWhat it does
tor_fetch(url, method?, headers?, body?)HTTP request through Tor; returns status/headers/body
tor_get_exit_ip()Current exit node IP + country (verified via check.torproject.org)
tor_new_circuit()Force a fresh Tor circuit (SIGNAL NEWNYM)
tor_check(url)HEAD probe — is target reachable through Tor?

Honest scope

Tor exit nodes are blocked by Cloudflare on most big-brand sites (Indeed, Google, Amazon, etc.). Use tor-mcp for:

  • Non-Cloudflare sites
  • Geo-hidden fetches (see a site from a random country)
  • .onion services
  • IP-based rate-limit circumvention on APIs that don't blocklist Tor
  • Testing your own site from N different exits

If you need to hit Cloudflare-protected sites, use browser-mcp instead — real Chrome from a fixed Hetzner IP works for most WAFs, and you can layer a residential proxy on top for the rest.

Setup

  1. Sign in with Google at tor.regiq.in
  2. Generate an MCP API key on your dashboard
  3. Add to Claude Desktop / Cursor:
{
  "mcpServers": {
    "tor": {
      "url": "https://tor.regiq.in/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_KEY>"
      }
    }
  }
}

Limits (per API key, free tier)

  • 100 requests/day
  • 30s timeout per request
  • 10 MB response body cap
  • Methods: GET, POST, HEAD only

Higher quotas for aggregators — email [email protected].

Privacy

  • DNS resolves inside Tor (socks5h:// scheme) — no plaintext lookup from our host
  • We log: target host, method, response status, duration, size
  • We never log: full URLs, query strings, request bodies, response bodies, cookies, headers
  • Standard TorBrowser User-Agent sent by default

Self-host

git clone https://github.com/globalion/tor-mcp
cd tor-mcp
cp .env.example .env  # fill in
docker compose up -d --build

Then browse to http://localhost:3021.

License

MIT · Built by Shreyas · Shipped by Globalion

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.