Loading ToolBench
MCP server for TorrentClaw — search and discover movies and TV shows with torrent downloads, magnet links, streaming availability, and cast/crew metadata
TorrentClaw MCP demonstrates solid definition quality with well-structured tools, comprehensive parameter schemas, and detailed descriptions. All 10 tools have clear names starting with action verbs (search_, get_, track_, autocomplete, submit_). Tool descriptions are detailed (avg ~300 chars), exceeding the 194-char baseline, and most include usage guidance and context. Parameter schemas are consistently defined with types, descriptions, and constraints (enums, min/max bounds). However, output schemas are not explicitly documented in the provided source, forcing inference from descriptions rather than formal schema documentation. Error handling guidance exists in descriptions but lacks structured error classification. Security considerations around API key injection are absent from visible code. Tool composition is strong, tools chain cleanly (search_content→get_watch_providers/get_credits), and most support the common user workflows (find content, get metadata, track interactions, request scans).
Get type-ahead search suggestions for movies and TV shows. Use this to validate or disambiguate a title before calling search_content. Returns up to 8 suggestions with id, title, year, and content type. Much faster than a full search.
Get the director and top 10 cast members (with character names) for a movie or TV show. Use when the user asks about actors, cast, director, or 'who is in' a title. Requires content_id from search_content results.
Get trending movies and TV shows ranked by user click count. Use when the user asks for recommendations, trending titles, or 'what's popular'. Returns a paginated list with title, year, type, ratings, and content_id. Note: results do NOT include torrents — to get torrents for a title, call search_content with its name.
Get the most recently added movies and TV shows, sorted by addition date. Use when the user asks 'what's new', 'latest additions', or 'recently added'. Returns a paginated list with title, year, type, ratings, date added, and content_id. Note: results do NOT include torrents — to get torrents for a title, call search_content with its name.
Check the status of a torrent audio/video scan request. Returns the current scan status (pending, scanning, completed, failed). Use after submit_scan_request.
Output schemas not formally documented. Tool responses require inference from descriptions rather than explicit JSON Schema definitions. This forces LLMs to guess field names and types, increasing mismatches in chained calls.
Error handling lacks structured categorization. Descriptions mention rate limits (submit_scan_request), 404s (get_watch_providers), and validation errors (implicit), but do not categorize them as retryable/user-fixable/fatal or provide recovery guidance. LLMs cannot plan retry strategies.
API key injection via environment (TORRENTCLAW_API_KEY) is mentioned in api-client.ts but not visible in tool parameter schemas or input validation. Verify that no tool parameters accept secrets.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | C | 68 | 2026-07-28+ | v2 |
| 2026-03-09 | D | 51 | - | v1 |
Get a direct .torrent file download URL from an info_hash. Use when the user specifically wants a .torrent file rather than a magnet link (magnet links are already in search_content results). Returns a single URL the user can open in their browser or torrent client.
Check where a movie or TV show is available to stream, rent, or buy (Netflix, Disney+, Amazon Prime, etc.) in a specific country. Requires content_id from search_content results. Note: if you passed country to search_content, streaming info is already in those results — use this tool only for a different country or to get more detail. Returns grouped providers: Stream (subscription), Free, Rent, Buy.
Search for movies and TV shows by title, genre, year, rating, or quality. Returns matching content with metadata (title, year, genres, IMDb/TMDB ratings) and torrent download options (magnet links, quality, seeders, file size). This is the primary tool — use it first when a user asks to find, download, or learn about a movie or TV show. Results include a content_id needed by get_watch_providers and get_credits. For TV shows, you can filter by season/episode. Season/episode can also be auto-detected from the query (e.g. 'Bluey s01e05'). IMPORTANT: When presenting results to users, make magnet links clickable using markdown format [Download](magnet:?xt=...), include the contentUrl for browsing all seasons/episodes, and present the information in a user-friendly format rather than raw tables.
Submit a torrent for audio/video quality analysis (codec, tracks, resolution, HDR). Use when the user wants to know the exact media specs of a torrent before downloading. Results are not instant — use get_scan_status to check progress. Rate limited to 5 requests per hour.
Track user interactions with torrents (magnet link click, torrent download, copy action). Use to log when the user downloads or clicks a magnet/torrent link. Requires info_hash from search_content results and action type.
Tool annotations (readOnlyHint, destructiveHint, idempotentHint) not visible in tool registrations. track_interaction and submit_scan_request are write operations and should be marked with destructiveHint=true; read-only tools should have readOnlyHint=true.
No confirmation/dry-run pattern for destructive operations. track_interaction logs clicks; submit_scan_request submits analysis requests. Both are side-effectful and should support optional confirmation before execution.