Loading ToolBench
Sonarr MCP has well-structured tool definitions with clear naming (verb_noun pattern) and complete input schemas. All 7 tools have descriptions and properly typed parameters. However, descriptions are generic and lack LLM-optimization guidance (e.g., 'when to use this instead of similar tools', dependency hints, prerequisites). Output schemas are not documented, LLMs cannot predict response structure for planning. Error handling is absent from tool definitions. Parameter descriptions lack format constraints, ranges, and validation rules. No tool annotations (readOnlyHint, destructiveHint) despite clear risk levels. Missing pagination guidance for list operations.
Add a new TV series to your library. You need the tvdbId from sonarr_search_series. Optionally specify root folder path, quality profile, and which seasons to monitor.
Delete a series from Sonarr. Optionally delete files from disk. WARNING: This cannot be undone!
Get all series in your Sonarr library. Returns complete list with metadata, seasons, and statistics.
Get all episodes for a specific series. Returns episode list with air dates, file status, and monitoring status.
Get detailed information about a specific series by its Sonarr ID. Includes all seasons, episodes, and statistics.
Get series information by TVDB ID. Useful when you know the TVDB ID but not the Sonarr ID.
No output schemas documented. LLMs cannot predict response structure (fields, types, nesting) for planning downstream calls or extracting data. Breaks tool chaining.
No tool annotations (readOnlyHint, destructiveHint, idempotentHint). sonarr_delete_series is destructive but unmarked; sonarr_add_series modifies state but unmarked. Agents cannot reason about safety/retry semantics.
Descriptions lack LLM-optimization guidance. Missing: when to use this tool vs similar ones, prerequisites, dependency hints (e.g., 'search first to get tvdbId'). Generic descriptions reduce tool selection accuracy.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 68 | 2026-07-28+ | v2 |
Search for TV series by title on TVDB/TMDB. Returns potential matches with metadata. Use this to find the tvdbId needed to add a series.
sonarr_get_all_series lacks pagination (limit, offset, page_size). Returning all series without bounds risks context window exhaustion. No documented result limit.
Parameter descriptions lack format constraints and validation rules. E.g., 'term' in sonarr_search_series has no length limits; 'seasonNumber' in sonarr_get_episodes has no range (0-99?). LLMs cannot self-validate inputs.