README

Torreable

Publish static websites as Tor hidden services (.onion sites) via MCP.

Requirements

Python 3.10+
Tor running with control port enabled

Installing Tor

macOS:

brew install tor
brew services start tor

Linux:

apt install tor
systemctl start tor

Make sure Tor has a control port. Add to /etc/tor/torrc or ~/.torrc:

ControlPort 9051

Installation

Click the button to install:

Or install manually:

Go to Advanced settings -> Extensions -> Add custom extension. Name to your liking, use type STDIO, and set the command to uvx torreable. Click "Add Extension".

Tools

Tool	Description
`create_site(name, directory)`	Register a static site
`preview(name)`	Local preview at localhost
`publish(name)`	Publish to Tor network
`unpublish(name)`	Take offline, keep address
`destroy(name)`	Delete site and address
`list_sites()`	Show all sites and status

How it works

Sites are stored in ~/.torreable/sites/
Each site keeps its Tor private key, so the .onion address persists
Publishing starts a local HTTP server and creates an ephemeral Tor hidden service
Sites are only reachable while torreable is running

Example

> create_site("myblog", "/path/to/blog/dist")
Created site 'myblog' -> /path/to/blog/dist

> preview("myblog")
Preview running at http://localhost:52431

> publish("myblog")
Published at http://abc123...xyz.onion

> unpublish("myblog")
Unpublished 'myblog'. Address abc123...xyz.onion preserved for later.

Torreable

README

Torreable

Requirements

Installing Tor

Installation

Click the button to install:

Or install manually:

Tools

How it works

Example

Recommended Servers