Putio Mcp Server

What is Putio Mcp Server about?

Putio Mcp Server allows users to control their Put.io account through the Model Context Protocol, offering command‑line style management of torrent transfers.

How to use Putio Mcp Server?

1. Install uvx (the universal Python runner).
2. Ensure Python 3.x is available.
3. Add the following configuration to claude_desktop_config.json, replacing <your-putio-api-token> with your Put.io API token:

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

4. Start the MCP client (e.g., Claude Desktop) and invoke the server commands.

Key features of Putio Mcp Server

• List active transfers – view ongoing downloads and their statuses.
• Add new transfers – submit URLs or magnet links to start new downloads.
• Cancel existing transfers – stop any unwanted or stalled transfers.
• Retrieve browser links – obtain direct download or streaming URLs for completed items.

Use cases of Putio Mcp Server

• Automating media download pipelines from torrent sources.
• Integrating Put.io management into custom scripts or AI assistants.
• Providing remote control of a personal cloud storage service without a web UI.
• Building notifications or dashboards that reflect current transfer activity.

FAQ from the Putio Mcp Server

Q: Do I need a Put.io account? A: Yes, an active Put.io account and a valid API token are required.

Q: Can I run this on Windows? A: As long as Python 3.x and uvx are installed, the server works on any OS that supports them.

Q: What environment variable stores the token? A: PUTIO_TOKEN.

Q: Is any additional software needed? A: Only Python 3.x, uvx, and the Claude Desktop (or any MCP‑compatible client).

putio-mcp-server

MCP server for interacting with put.io

Features

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

Prerequisites

• Claude Desktop
• Python 3.x
• uvx
• Put.io account and API token (guide)

Setup

Put following config in your claude_desktop_config.json.

Don't forget to replace <your-putio-api-token> with your own API token.

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