rqbit

rqbit is an MCP server that provides an interface to interact with the rqbit BitTorrent client API. It connects LLM-based assistants and automation environments directly to a local or remote rqbit daemon, enabling users to manage peer-to-peer file downloads programmatically. The server is built for developers, system administrators, and home lab operators who need automated torrent lifecycle management through standard model interactions. By exposing native operations as Model Context Protocol tools, rqbit allows assistants to fetch current download lists, query real-time bandwidth statistics, and retrieve specific torrent metadata. It also facilitates task execution such as starting, pausing, and deleting torrent jobs, as well as initiating downloads from magnet links or local file paths. Supporting multiple communication transports including stdio, SSE, and streamable HTTP, the rqbit server provides a standard way to incorporate decentralized file distribution workflows into agentic pipelines and developer IDEs without manually handling HTTP API calls.

Category: Other & General Purpose

Tags: file-transfer, p2p, rqbit, torrent

Visit rqbit

How to install and configure rqbit

1. Ensure a running instance of the rqbit torrent client is accessible (default is http://localhost:3030). 2. Install the package from PyPI by running pip install rqbit-mcp or run directly using uvx rqbit-mcp. 3. Configure your environment by setting RQBIT_URL to your rqbit instance address, and optionally RQBIT_HTTP_BASIC_AUTH_USERPASS if basic authentication is enabled. 4. Add the server to your MCP client configuration (such as Windsurf) using stdio: json { "mcpServers": { "rqbit-mcp": { "command": "uvx", "args": ["rqbit-mcp"], "env": { "RQBIT_URL": "http://localhost:3030" } } } } 5. Alternatively, launch the server using Docker or configure it via SSE using http://127.0.0.1:8000/sse.

What you can do with rqbit

• Initiating torrent downloads directly from magnet links or local file references through client prompts. * Monitoring peer-to-peer transfer progress, active peer connections, and bandwidth stats across all running torrents. * Pausing and resuming active torrent transfers to manage local network usage dynamically. * Listing active and completed torrents to review metadata and verify downloaded payload structures. * Deleting unwanted torrent jobs and optionally cleaning up downloaded files from local storage.

Key facts

• Open Source
• https://github.com/philogicae/rqbit-mcp
• Other & General Purpose
• file-transfer, p2p, rqbit, torrent

Part of MCP Servers

How do I install rqbit?

You can install rqbit directly from PyPI using pip install rqbit-mcp. Alternatively, you can run it without explicit installation using uvx rqbit-mcp in your client configuration, or deploy it as a container using the provided Docker setup and compose configuration.

What can rqbit do?

The rqbit server allows MCP clients to control a running rqbit client. It provides tools to list torrents, download content via magnet links or files, fetch torrent details, track transfer statistics, pause and start tasks, and remove or delete torrents alongside their downloaded data.

Which MCP clients work with rqbit?

The rqbit server works with any MCP-compliant client that supports stdio, SSE, or streamable-http transports. Documented examples include developer tools such as Windsurf, but it functions with standard desktop assistants and command-line MCP orchestrators.

Is rqbit open source?

Yes, rqbit is open source software released under the MIT License. The code and issue tracker are available in the project repository on GitHub.