Model Context Protocol server for TorrentClaw — giving AI assistants the ability to search movies and TV shows, find torrents with magnet links, check streaming availability, and explore cast/crew metadata. torrentclaw-mcp is developed by TorrentClaw as part of its open-source ecosystem. It wraps the TorrentClaw API into the MCP standard so that any compatible AI assistant (Claude, GPT, etc.) can
Add this skill
npx mdskills install torrentclaw/torrentclaw-mcpWell-documented MCP server providing comprehensive torrent search and streaming availability tools
1# torrentclaw-mcp23[](https://www.npmjs.com/package/torrentclaw-mcp)4[](LICENSE)5[](https://github.com/torrentclaw/torrentclaw-mcp/actions/workflows/ci.yml)6[](https://nodejs.org)78[Model Context Protocol](https://modelcontextprotocol.io/) server for [TorrentClaw](https://torrentclaw.com) — giving AI assistants the ability to search movies and TV shows, find torrents with magnet links, check streaming availability, and explore cast/crew metadata.910torrentclaw-mcp is developed by [TorrentClaw](https://torrentclaw.com) as part of its open-source ecosystem. It wraps the TorrentClaw API into the MCP standard so that any compatible AI assistant (Claude, GPT, etc.) can access the platform's search and discovery features natively.1112## Quick Start1314```bash15npx torrentclaw-mcp16```1718No API key required (optional for higher rate limits).1920## What can it do?2122### Tools2324| Tool | Description |25| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |26| `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. |27| `autocomplete` | Type-ahead search suggestions (up to 8 results). Use to validate titles before a full search. |28| `get_popular` | Get popular content ranked by user clicks |29| `get_recent` | Get recently added content |30| `get_watch_providers` | Streaming availability by country (Netflix, Disney+, etc.) |31| `get_credits` | Cast and director for a title |32| `get_torrent_url` | Get .torrent file download URL from info hash |33| `track_interaction` | Track user interaction with a torrent (magnet click, download, copy) |34| `submit_scan_request` | Submit a torrent for audio/video quality analysis via [TrueSpec](https://github.com/torrentclaw/truespec) |35| `get_scan_status` | Check the status of a torrent scan request |3637### Resources3839| URI | Description |40| --------------------- | ----------------------------------------------------- |41| `torrentclaw://stats` | Catalog statistics (content/torrent counts by source) |4243### Prompts4445| Prompt | Description |46| ---------------- | -------------------------------------------------------- |47| `search_movie` | Search for a movie by title and get torrents + streaming |48| `search_show` | Search for a TV show by title and get torrents |49| `whats_new` | Discover recently added movies and TV shows |50| `where_to_watch` | Find where to stream, rent, or buy a title |5152## Configuration5354### Claude Desktop5556Add to `claude_desktop_config.json`:5758```json59{60 "mcpServers": {61 "torrentclaw": {62 "command": "npx",63 "args": ["-y", "torrentclaw-mcp"]64 }65 }66}67```6869### Claude Code7071Add to `.mcp.json` or `~/.claude/settings.json`:7273```json74{75 "mcpServers": {76 "torrentclaw": {77 "command": "npx",78 "args": ["-y", "torrentclaw-mcp"]79 }80 }81}82```8384### Environment Variables8586| Variable | Default | Description |87| --------------------- | ------------------------- | -------------------------------------------------------------- |88| `TORRENTCLAW_API_URL` | `https://torrentclaw.com` | Base URL of the TorrentClaw API |89| `TORRENTCLAW_API_KEY` | _(none)_ | Optional API key for authenticated access (higher rate limits) |9091## Project Structure9293```94.95├── src/96│ ├── index.ts # MCP server entry point97│ ├── config.ts # Configuration & URL validation98│ ├── api-client.ts # TorrentClaw API client with caching99│ ├── types.ts # TypeScript interfaces for API responses100│ ├── prompts.ts # MCP prompt definitions101│ ├── tools/ # MCP tool implementations102│ │ ├── search-content.ts103│ │ ├── autocomplete.ts104│ │ ├── get-popular.ts105│ │ ├── get-recent.ts106│ │ ├── get-watch-providers.ts107│ │ ├── get-credits.ts108│ │ ├── get-torrent-url.ts109│ │ ├── track-interaction.ts110│ │ └── scan-request.ts111│ ├── formatters/ # Output formatting112│ │ ├── content.ts113│ │ ├── providers.ts114│ │ └── credits.ts115│ └── resources/ # MCP resources116│ └── stats.ts117├── tests/ # Test suite (vitest)118├── .github/workflows/ # CI/CD (lint, build, test, release)119├── lefthook.yml # Git hooks (commit lint, prettier, tsc)120├── Makefile # Dev workflow (build, test, lint, fmt)121├── CONTRIBUTING.md # Contribution guidelines122├── LICENSE # MIT123└── README.md124```125126## Development127128```bash129git clone https://github.com/torrentclaw/torrentclaw-mcp.git130cd torrentclaw-mcp131make install-tools132make hooks133make build && make test134```135136Test with MCP Inspector:137138```bash139npx @modelcontextprotocol/inspector node build/index.js140```141142## About TorrentClaw143144[TorrentClaw](https://torrentclaw.com) is an open platform focused on improving the quality and reliability of torrent metadata. Our mission is to make torrent search engines more accurate and the torrent ecosystem healthier — by building tools that verify, enrich, and standardize metadata across the network.145146torrentclaw-mcp is part of the TorrentClaw open-source ecosystem, alongside [TrueSpec](https://github.com/torrentclaw/truespec) (torrent metadata verification).147148## Contributing149150See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.151152## License153154MIT License — see [LICENSE](LICENSE) for details.155
Full transparency — inspect the skill content before installing.