FR Torrent MCP Server & Wrapper

You can access FR Torrent functionalities through an MCP server that exposes search and retrieval capabilities from FR Torrent providers. This server lets you integrate torrent search, magnet links, and torrent files into your applications via standard MCP transports, including stdio, SSE, or HTTP-based endpoints.

How to use

Set up a client that speaks MCP and point it at one of the available server endpoints. You can run the MCP server locally and connect with a client to perform operations such as searching for torrents across providers and obtaining torrent data. Use the SSE transport or a standard HTTP transport to communicate, depending on your client and deployment.

How to install

Prerequisites you need before installing:

• Python 3.10+ for PyPI installation
• uv for local development
• Docker and Docker Compose for Docker deployment
• An active YggTorrent account and a LaCale passkey if you plan to use those providers

Step-by-step commands to install and run the MCP server locally using Python (recommended for library usage and simple runs):

pip install fr-torrent-search-mcp

# Create a configuration file in your working directory
# Add provider credentials and options (example values shown as placeholders)
YGG_USERNAME=your_ygg_username
YGG_PASSWORD=your_ygg_password
LA_CALE_PASSKEY=your_la_cale_passkey
#FOLDER_TORRENT_FILES=/path/to/target/folder

# Run the MCP server with the default stdio transport
python -m fr_torrent_search

# Alternative: run with uvx for local development
uv run -m fr_torrent_search

Additional sections

Configuration and environment variables are read from a .env file in your project directory. The following variables are commonly used to enable providers and control the storage of torrent files:

• YGG_ENABLE, YGG_DOMAIN, YGG_LOCAL_API, YGG_USERNAME, YGG_PASSWORD, TURBO_ENABLED
• LA_CALE_ENABLE, LA_CALE_DOMAIN, LA_CALE_PASSKEY
• FOLDER_TORRENT_FILES (default: ./torrents) Create a .env file and populate these values to enable and configure providers.

If you prefer a Docker-based setup, you can run the server in a container. Build and start the container with Docker Compose, and monitor logs with a container log stream. The container is configured to bypass DNS issues and to run a local Ygg API for YggTorrent support.

For testing or development, you can also expose a FastAPI server alongside the MCP server to access HTTP endpoints for the same capabilities. Run the standard Python invocation with --mode fastapi or use uv to start the FastAPI server as shown in the usage examples.

Available tools

search_torrents

Search for torrents across supported FR Torrent providers. Result items include filename, size, seeders, leechers, downloads, and date.

get_torrent

Retrieve torrent data, either as a magnet link or as a .torrent file, for a given torrent identifier.

get_magnet_link

Obtain the magnet link for a specific torrent.

download_torrent_file

Download the .torrent file for a specific torrent.