putio-mcp-server

Name: putio-mcp-server
Author: putdotio

@putdotio

Repository

About putio-mcp-server

MCP server for interacting put.io

#bittorrent #mcp

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "putio": {
      "command": "uvx",
      "args": [
        "putio-mcp-server"
      ],
      "env": {
        "PUTIO_TOKEN": "<your-putio-api-token>"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is putio-mcp-server?

putio-mcp-server is an MCP (Model Context Protocol) server that integrates with put.io to manage file transfers. It enables Claude Desktop to control put.io transfers—such as adding, listing, and canceling them—directly through natural language. Designed for put.io users who want to automate or simplify download management via Claude.

How to use putio-mcp-server?

Ensure Python 3.x, uvx, and Claude Desktop are installed, and obtain a put.io API token. Then add the provided JSON configuration block to your claude_desktop_config.json, replacing <your-putio-api-token> with your actual token. Once configured, Claude can invoke the server’s tools to interact with put.io.

Key features of putio-mcp-server

List active transfers
Add new transfers via URL or magnet link
Cancel existing transfers
Get browser links for completed transfers

Use cases of putio-mcp-server

Add a torrent or magnet link to put.io by describing it in Claude
Check the progress of current downloads without leaving Claude
Remove stalled or unwanted transfers from the queue
Retrieve direct browser links for finished files

FAQ from putio-mcp-server

How do I get a put.io API token?

Follow the guide at https://help.put.io/en/articles/5972538-how-to-get-an-oauth-token-from-put-io.

What are the prerequisites for using putio-mcp-server?

You need Claude Desktop, Python 3.x, uvx, and a put.io account with an API token.

How do I configure putio-mcp-server in Claude Desktop?

Add the JSON configuration to your claude_desktop_config.json with the command uvx, argument putio-mcp-server, and the environment variable PUTIO_TOKEN set to your token.