putio

This MCP server enables interaction with put.io through Claude Desktop. It supports listing active transfers, adding new transfers via a URL or magnet link, canceling existing transfers, and generating browser links for completed transfers. To use it, ensure you have a Put.io API token configured in the environment (PUTIO_TOKEN) and run the server via UVX as shown in the setup. Once running, you can trigger actions such as querying current transfers, submitting new transfer requests by providing a Put.io transfer URL or magnet link, canceling transfers by their IDs, and retrieving download/browser links for completed items. The server exposes an interface compatible with the MCP protocol, so you can invoke actions from Claude Desktop or any MCP client that communicates with your running instance.

Prerequisites:

• Claude Desktop installed and configured
• Python 3.x installed
• uvx installed (per uvx documentation)
• Put.io account and API token

1. Install and configure uvx according to its documentation, ensuring it is accessible in your system PATH.
2. Create the Claude Desktop configuration file (claude_desktop_config.json) with the following content, replacing <your-putio-api-token> with your actual Put.io API token:

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

3. Ensure the Put.io token has the necessary permissions for reading transfers and adding/canceling transfers as required by the MCP server.
4. Start the MCP server by running the configured command via UVX or by starting the Copper/Claude Desktop workflow that launches the uvx-based server:

uvx putio-mcp-server

5. In Claude Desktop or your MCP client, connect to the running server (named putio) and begin issuing commands such as listing transfers, adding new transfers via a URL or magnet link, canceling transfers, and retrieving browser links for completed transfers.

Tips and notes:

• Keep your PUTIO_TOKEN secure; do not hard-code it in public repositories.
• Ensure the Put.io API token has the necessary scopes to list, add, and cancel transfers.
• If you encounter authentication errors, re-check the PUTIO_TOKEN value in your claude_desktop_config.json and restart the server.
• The server relies on Python 3.x and uvx; verify compatibility with your environment and Python version.
• When testing, try adding a small, valid public magnet link or URL to verify transfer creation works before moving to larger batches.