Command-line interface and MCP server for the Seerr media request management API
Strong foundation with 46 tools, all with descriptions and explicit schemas. Tool naming follows verb_noun convention consistently (list_, get_, create_, update_, etc.). Most parameters are typed and described. However, several tools have minimal descriptions (<50 chars), some parameters lack descriptions entirely, and output schemas are not documented. Error handling is basic, tools return generic API errors without recovery guidance. Tool composition is sound; tools chain well via ID references. Security: API key injection via context is correct; no secrets in parameters.
Get the currently authenticated user's profile, permissions, and quota
Add a media item to the blocklist
List all blocklisted media items
Remove a media item from the blocklist
Get collection details by TMDB collection ID
Get issue counts by status
Create a new issue
Output schemas not documented. Tools return JSON but LLMs cannot infer field structure, types, or required fields. Agents must guess what data is available for downstream calls.
Error handling is generic. Tools return raw API errors without recovery guidance. E.g., 'BlocklistPost failed' tells the agent nothing about why it failed or what to try next.
Minimal descriptions on several tools. 'Get issue counts by status' (30 chars) and 'List configured Radarr instances' (32 chars) lack context for when/why to call them vs similar tools.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 66 | 2025-06-18+ | v2 |
Get a specific issue by ID
List issues
Update the status of an issue
List movies and TV shows tracked by Seerr (i.e. requested or added to the library), including their download/availability status and associated requests. Supports pagination via take/skip. Each result includes statusLabel and status4kLabel string fields alongside the numeric status codes.
Update the status of a media item
Get movie details by TMDB ID
Get ratings for a given movie
Get combined RT and IMDB ratings for a given movie
Get movie recommendations for a given movie
Get similar movies for a given movie
Get combined credits for a person
Get person details by TMDB ID
Approve a media request
Get request counts by status
Create a new media request
Decline a media request
Delete a media request
Get a specific media request by ID
List media requests
Retry a failed media request download
Search for production companies
Discover movies
Discover TV shows
Search for TMDB keywords
Search for movies, TV shows, and people
Get trending movies and TV shows
List configured Radarr instances
List configured Sonarr instances
Get Seerr system information and settings
Cancel a running scheduled job
List all scheduled jobs
Trigger a scheduled job to run immediately
Update the cron schedule for a scheduled job
Get the system status of the Seerr API
Get TV show details by TMDB ID
Get ratings for a given TV show
Get TV show recommendations for a given show
Get season details for a TV show
Get similar TV shows for a given show
Parameter descriptions missing or generic on discovery/list tools. 'filter' and 'sort' parameters lack enum values or format guidance. LLMs must guess valid options.
No pagination guidance in descriptions. Tools accept take/skip but descriptions don't explain default limits, max results, or when pagination is required.