Putio Mcp Server

What is Putio Mcp Server about?

Provides an MCP endpoint that enables external tools to manage put.io transfers—listing, creating, cancelling, and fetching download links—through simple commands.

How to use Putio Mcp Server?

1. Install uvx (or any compatible Python runner).
2. Set the environment variable PUTIO_TOKEN with your put.io API token.
3. Run the server via uvx putio-mcp-server (or configure it in claude_desktop_config.json as shown below).
4. Send MCP requests to the server to perform transfer operations.

Key features of Putio Mcp Server

• List active transfers on put.io.
• Add new transfers using direct URLs or magnet links.
• Cancel existing transfers.
• Obtain browser‑ready links for completed transfers.

Use cases of Putio Mcp Server

• Automate download management from scripts or AI agents.
• Integrate put.io with personal productivity workflows.
• Provide a unified interface for multiple clients to control put.io downloads.

FAQ from the Putio Mcp Server

Q: What prerequisites are needed? A: Python 3.x, uvx, a put.io account, and an API token.

Q: How do I provide the API token? A: Set PUTIO_TOKEN in the environment or include it in the MCP server configuration JSON.

Q: Can I run the server without uvx? A: Yes, any method that can execute the Python package putio-mcp-server is acceptable; uvx is the recommended shortcut.

Q: Where is the server configured for Claude Desktop? A: Add an entry under mcpServers in claude_desktop_config.json as illustrated in the README.

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>"
      }
    }
  }
}