# torrentclaw/torrentclaw-mcp [Health: Active]

**Category:** 🎥 Multimedia Process  
**Repository:** https://github.com/torrentclaw/torrentclaw-mcp  
**GitHub Stars:** 12  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/torrentclaw-torrentclaw-mcp

## Description
Search and discover movies and TV shows with torrent links, quality scoring, streaming availability, and cast/crew metadata.

## Tools
Capabilities this server exposes over MCP:

- **search_content** — Search movies/shows with filters (query, type, genre, year, rating, quality, language, audio, HDR, season, episode, sort). Returns torrents, magnet links, and optional streaming info.
- **autocomplete** — Type-ahead search suggestions (up to 8 results). Use to validate titles before a full search.
- **get_popular** — Get popular content ranked by user clicks
- **get_recent** — Get recently added content
- **get_watch_providers** — Streaming availability by country (Netflix, Disney+, etc.)
- **get_credits** — Cast and director for a title
- **get_torrent_url** — Get .torrent file download URL from info hash
- **track_interaction** — Track user interaction with a torrent (magnet click, download, copy)
- **submit_scan_request** — Submit a torrent for audio/video quality analysis via [TrueSpec](https://github.com/torrentclaw/truespec)
- **get_scan_status** — Check the status of a torrent scan request

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## 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:

```bash
npx -y torrentclaw-mcp
```

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

```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.

_Full upstream README: https://allmcps.com/mcp/torrentclaw-torrentclaw-mcp/readme_