Debrid-Link API v2 MCP Server

This is a Model Context Protocol (MCP) server that enables AI assistants (such as Claude Desktop, Cursor, Cline, etc.) to manage your Seedbox (torrents), Downloader (link unlocking/premium download links), and transcoding streams using the Debrid-Link API v2.

Tools (Capabilities)

This server exposes the following tools to the AI client:

Account & Limits

• get_account_info: Retrieve Debrid-Link account details (premium status, registered email, points, etc.).

• get_seedbox_limits: Fetch Seedbox storage and daily download limits/usage.

• get_downloader_limits: Fetch Downloader traffic quotas and usage per filehoster.

Seedbox (Torrent Management)

• list_torrents: List torrents currently in your Seedbox.

• get_torrents_activity: Get a simplified/faster status of active torrents.

• add_torrent: Add a torrent via magnet link, torrent URL, or info hash.

• remove_torrents: Delete one or more torrents from the Seedbox (supports comma-separated IDs).

• configure_torrent: Exclude/select files for a waiting torrent (when wait=true).

Downloader (Premium Link Generation)

• list_downloader_links: List unlocked download links.

• add_downloader_link: Unlock/decrypt a filehoster link (e.g. Mega, Rapidgator) to get a direct premium download URL.

• remove_downloader_links: Delete one or more unlocked links (supports comma-separated IDs).

Files & Streaming

• list_files: List files and folders in a normalized file manager tree format.

• create_transcode: Create a live transcoding stream (HLS or MP4) for video files.

• get_transcode_infos: Retrieve status and URL of active transcodes.

Related MCP server: Synology MCP Server

Installation & Setup

1. Get Your API Key

Go to Debrid-Link API Key and generate your Private API key.

2. Install Dependencies

npm install
# Note: If installing on virtual/cloud drives (e.g., Google Drive) that do not support symlinks, run:
# npm install --no-bin-links

3. Build the Project

npm run build

4. Configure Your MCP Client

Claude Desktop

Add this to your configuration file (usually at %APPDATA%\Roaming\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "debrid-link": {
      "command": "node",
      "args": ["/path/to/debrid-link-api-v2/dist/index.cjs"],
      "env": {
        "DEBRID_LINK_API_KEY": "YOUR_DEBRID_LINK_PRIVATE_API_KEY"
      }
    }
  }
}

Cline (VSCode Extension)

Add this to your configuration file (usually at %APPDATA%\Roaming\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json):

{
  "mcpServers": {
    "debrid-link": {
      "command": "node",
      "args": ["/path/to/debrid-link-api-v2/dist/index.cjs"],
      "env": {
        "DEBRID_LINK_API_KEY": "YOUR_DEBRID_LINK_PRIVATE_API_KEY"
      },
      "disabled": false
    }
  }
}

CLI Usage

This project also includes a CLI tool dl-cli to interact with Debrid-Link directly from your terminal.

1. Global Installation

Install the CLI globally on your system:

npm install -g .

2. Available Commands

Configure your DEBRID_LINK_API_KEY in your .env or export it to your environment, then run:

• Account Status:

  dl-cli status

• Traffic & Limits:

  dl-cli limits

• Seedbox Management:

  dl-cli torrent list                # List torrents
  dl-cli torrent add "magnet:..."    # Add magnet/torrent URL
  dl-cli torrent rm <torrent_ids>   # Delete torrent(s)

• Link Unlocking (Downloader):

  dl-cli unlock "https://host.com/file..."

Development & Local Testing

Create a .env file in the root directory:

DEBRID_LINK_API_KEY=YOUR_DEBRID_LINK_PRIVATE_API_KEY

Run in development mode:

npm run dev

License

This project is licensed under the MIT License.