Skip to main content
Glama
hubbertj

iptorrents MCP Server

by hubbertj

iptorrents MCP Server

MCP (Model Context Protocol) server for searching and downloading torrents from iptorrents.com.

Features

  • Search torrents with filtering and sorting

  • Browser cookie-based authentication (no automated login due to Cloudflare Turnstile)

  • Torrent metadata extraction (seeders, leechers, size, category, etc.)

  • Freeleech detection

Related MCP server: RuTracker MCP Server

Installation

pip install -e .

Usage

Set environment variables for iptorrents authentication:

export IPTORRENTS_UID="<your_uid_cookie>"
export IPTORRENTS_PASS="<your_pass_cookie>"
export IPTORRENTS_CF_CLEARANCE="<cf_clearance_if_needed>"

Get cookies from iptorrents.com:

  1. Open https://iptorrents.com in browser

  2. Sign in

  3. Open DevTools (F12)

  4. Go to Storage → Cookies → iptorrents.com

  5. Copy values for uid, pass, and cf_clearance

Run the server:

python -m iptorrents_mcp.main

Tools

search_iptorrents

Search for torrents on iptorrents.com

Parameters:

  • query (string, required): Search query

  • limit (integer): Maximum results (default: 10)

  • sort (string): Sort field (seeders, leechers, size, downloads, name, age)

Example:

search_iptorrents("The Office", limit=5, sort="seeders")

Based On

Inspired by https://github.com/evanpurkhiser/iptorrents-cli - a reference implementation for proper iptorrents API interaction.

Related MCP Connectors

Related MCP Servers

  • F
    license
    A
    quality
    D
    maintenance
    Enables interaction with qBittorrent through its Web API to search for torrents using search plugins and manage downloads. Supports torrent searching, downloading via URLs/magnet links, and torrent management operations like pause, resume, and delete.
    7
    3
    -
  • F
    license
    Not graded
    quality
    B
    maintenance
    Allows users to search and browse torrents on rutracker.org, retrieving detailed metadata including magnet links and file lists. It automatically handles authentication by extracting session cookies from the Brave browser on macOS.
    -
  • F
    license
    A
    quality
    D
    maintenance
    Enables searching torrents, fetching metadata, and downloading torrent files from c411.org. It provides tools for accessing torrent comments and detailed infoHash metadata while maintaining authenticated sessions.
    4
    4
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables searching and downloading torrents from YggTorrent via MCP tools such as search_torrents, get_torrent_details, get_magnet_link, and download_torrent_file.
    MIT