Torrentclaw MCP

What torrentclaw/torrentclaw-mcp MCP server does

The torrentclaw/torrentclaw-mcp MCP server exposes TorrentClaw’s movie and TV catalog through the Model Context Protocol. An assistant can search for films or shows and receive matching torrent records, magnet links, and optional streaming information. Search parameters cover content type, genre, year, rating, quality, language, audio, HDR, season, episode, and sort order.

The server also supports discovery tasks beyond direct searches. It can suggest titles while a user is typing, list content ranked by user clicks, show recently added titles, identify streaming availability by country, and return cast and director information. A separate resource at torrentclaw://stats provides catalog statistics, including content and torrent counts by source.

How it works

The package runs as a local MCP process and wraps requests to the TorrentClaw API. Compatible clients communicate with the process over MCP rather than calling the API directly. The default API base URL is https://torrentclaw.com, and the server does not require an API key for basic use.

Torrent-related operations include retrieving a .torrent download URL from an info hash and recording interactions such as magnet clicks, downloads, or copied links. Quality review is handled as an asynchronous workflow: an assistant can submit a torrent for audio and video analysis through TrueSpec, then query the scan status later.

Setup and configuration

Install and run the torrentclaw/torrentclaw-mcp MCP server with Node.js 18 or newer:

npx -y torrentclaw-mcp

For Claude Desktop, add the following server entry to claude_desktop_config.json:

{
  "mcpServers": {
    "torrentclaw": {
      "command": "npx",
      "args": ["-y", "torrentclaw-mcp"]
    }
  }
}

The same command can be placed in an MCP configuration for Claude Code. TORRENTCLAW_API_URL changes the API base URL from its default. TORRENTCLAW_API_KEY is optional and can be supplied for authenticated access with higher rate limits.

Tools and capabilities

Available MCP tools include:

• search_content for filtered movie and show searches.
• autocomplete for up to eight title suggestions.
• get_popular and get_recent for catalog discovery.
• get_watch_providers for country-specific streaming availability.
• get_credits for cast and director details.
• get_torrent_url for obtaining a .torrent URL from an info hash.
• track_interaction for recording torrent-related user actions.
• submit_scan_request and get_scan_status for TrueSpec quality-analysis requests.

The package also defines prompts for movie searches, show searches, new-content discovery, and finding where a title can be streamed, rented, or bought.

Limitations and notes

The torrentclaw/torrentclaw-mcp MCP server depends on the TorrentClaw API, so results and availability reflect that service’s catalog and response data. An API key is not mandatory, but unauthenticated use may have lower rate limits. Streaming-provider results depend on the requested country and the information available from the API. Quality scans are not described as immediate results; they use a submission and status-check sequence.