Torium

An unofficial Python client for the Finnish Tori.fi marketplace. 🇫🇮 

Browse listings, manage your own listings, and chat with buyers. From the terminal, your Python code, or Claude.

Installation • CLI • MCP Tools • Library

Installation

Choose your preferred installation method:

• Hosted remote MCP server. Easiest, just connect claude.ai or ChatGPT to https://torium.fi/mcp.
• Local install (MCP and CLI). Run the MCP server and CLI on your own machine.
• Self-hosted remote MCP server. Host the remote MCP server yourself.

Hosted remote MCP server

The simplest way to use Torium. We host the MCP server at https://torium.fi/mcp. Just add it as a connector in claude.ai and log in with your Tori.fi account.

See torium.fi for setup instructions and a video walkthrough.

Local install (MCP and CLI)

1. Clone and install:

git clone https://github.com/ahnl/torium
uv tool install ./torium

This places torium-mcp (and torium) on your PATH globally.

2. Authenticate (once):

torium auth setup

Opens a browser for OAuth login. On macOS and Linux the redirect is captured automatically (Linux registers a temporary .desktop URL handler via xdg-mime).

On Windows, after login the browser will show an infinite loading spinner or a "can't open" error. Open the browser's developer tools (F12) → Console, find the failed redirect URL starting with fi.tori.www..., right-click it to copy the link address, and paste it into the terminal. Do this quickly. The code in the URL expires in 30-60 seconds.

Credentials will be saved to ~/.config/torium/credentials.json. Alternatively, set TORI_REFRESH_TOKEN in your environment. The MCP server will use it directly, no credentials file needed.

3. MCP: Add to Claude Desktop:

Go to Settings → Developer → Edit Config and add:

{
  "mcpServers": {
    "torium": {
      "command": "torium-mcp"
    }
  }
}

Restart Claude Desktop. The torium tools are now available.

Updating:

cd torium && git pull && uv tool install --reinstall .

Self-hosted remote MCP server

You can run torium-mcp as a remote HTTPS server that multiple users connect to via claude.ai connectors. Each user authenticates their own Tori.fi account through a one-time OAuth popup.

By default, the server uses an email whitelist. You must allow each user before they can log in.

1. Allow your email (must be done before first login):

torium-mcp allow you@example.com --note "your name"
torium-mcp list-allowed    # see who has access
torium-mcp revoke foo@example.com  # remove access

2. Start the server:

torium-mcp --transport streamable-http --host 127.0.0.1 --port 5001 --base-url https://tori.example.com

The --base-url must be the public HTTPS URL that claude.ai can reach (e.g. via a reverse proxy or SSH tunnel).

3. Add https://tori.example.com/mcp in claude.ai connectors.

Claude opens a login popup. Click Log in to Tori.fi, complete the Schibsted login, then copy the fi.tori.www... redirect URL from the browser console and paste it into the form. After that, Claude has a 180-day session, with no further logins needed until it expires.

Each user's Tori credentials are stored separately i

... View full README on GitHub