README.md
Search movies and TV shows, find torrents, and check streaming availability.
torrentclaw-mcp
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 access the platform's search and discovery features natively.
Quick Start
npx torrentclaw-mcp
No API key required (optional for higher rate limits).
What can it do?
Tools
| Tool | Description |
|---|---|
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 |
get_scan_status |
Check the status of a torrent scan request |
Resources
| URI | Description |
|---|---|
torrentclaw://stats |
Catalog statistics (content/torrent counts by source) |
Prompts
| Prompt | Description |
|---|---|
search_movie |
Search for a movie by title and get torrents + streaming |
search_show |
Search for a TV show by title and get torrents |
whats_new |
Discover recently added movies and TV shows |
where_to_watch |
Find where to stream, rent, or buy a title |
Configuration
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"torrentclaw": {
"command": "npx",
"args": ["-y", "torrentclaw-mcp"]
}
}
}
Claude Code
Add to .mcp.json or ~/.claude/settings.json:
{
"mcpServers": {
"torrentclaw": {
"command": "npx",
"args": ["-y", "torrentclaw-mcp"]
}
}
}
Environment Variables
| Variable | Default | Description |
|---|---|---|
TORRENTCLAW_API_URL |
https://torrentclaw.com |
Base URL of the TorrentClaw API |
TORRENTCLAW_API_KEY |
(none) | Optional API key for authenticated access (higher rate limits) |
Project Structure
.
├── src/
│ ├── index.ts # MCP server entry point
│ ├── config.ts
Tools (10)
search_contentSearch movies/shows with filters like genre, year, quality, and language.autocompleteType-ahead search suggestions to validate titles.get_popularGet popular content ranked by user clicks.get_recentGet recently added content.get_watch_providersCheck streaming availability by country.get_creditsGet cast and director information for a title.get_torrent_urlGet .torrent file download URL from an info hash.track_interactionTrack user interaction with a torrent.submit_scan_requestSubmit a torrent for audio/video quality analysis.get_scan_statusCheck the status of a torrent scan request.Environment Variables
TORRENTCLAW_API_URLBase URL of the TorrentClaw APITORRENTCLAW_API_KEYOptional API key for authenticated access and higher rate limitsConfiguration
claude_desktop_config.json
{"mcpServers": {"torrentclaw": {"command": "npx", "args": ["-y", "torrentclaw-mcp"]}}}Try it
→Search for the latest sci-fi movies released in 2024.
→Where can I stream the TV show 'Breaking Bad' in the United States?
→Find the cast and director for the movie 'Inception'.
→What are some popular movies added to the catalog recently?