Skip to main content
Glama
iptorrents MCP Server

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    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.
      -
    • A
      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
      MIT
    • 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