Seerr MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | HTTP server port. | 8085 |
| HTTP_MODE | No | Enable HTTP transport. | false |
| SEERR_URL | No | Your Seerr/Overseerr instance URL. | |
| CACHE_ENABLED | No | Enable caching. | true |
| OVERSEERR_URL | No | Legacy (deprecated) Overseerr instance URL. Use SEERR_URL instead. Will be removed in v3.0.0. | |
| SEERR_API_KEY | No | API key from Settings → General in your Seerr/Overseerr instance. | |
| CACHE_MAX_SIZE | No | Maximum cache entries. | 1000 |
| CACHE_MEDIA_TTL | No | Media cache TTL in milliseconds (30 min). | 1800000 |
| CACHE_SEARCH_TTL | No | Search cache TTL in milliseconds (5 min). | 300000 |
| OVERSEERR_API_KEY | No | Legacy (deprecated) Overseerr API key. Use SEERR_API_KEY instead. Will be removed in v3.0.0. | |
| CACHE_REQUESTS_TTL | No | Request cache TTL in milliseconds (1 min). | 60000 |
| CACHE_SERVICES_TTL | No | Services cache TTL in milliseconds (10 min). | 600000 |
| CACHE_SERVICEDETAILS_TTL | No | Service details cache TTL in milliseconds (10 min). | 600000 |
| REQUIRE_MULTI_SEASON_CONFIRM | No | Confirm requests for more than 24 episodes. | true |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_mediaA | Search movies/TV with single/batch/dedupe modes. Dedupe returns actionable status for batch processing. Status: NOT_FOUND | ALREADY_AVAILABLE | ALREADY_REQUESTED | SEASON_AVAILABLE | SEASON_REQUESTED | AVAILABLE_FOR_REQUEST |
| request_mediaA | Request media with auto-confirm for TV ≤24 eps. Single/batch with validation. Confirm: Movies auto | TV ≤24 eps auto | TV >24 eps needs confirmed:true TV needs seasons (array or "all"). "all"=no specials; [0,1,2]=with specials |
| manage_media_requestsB | Manage requests: get/list/approve/decline/delete. Supports filters and batching. Filters: all|pending|approved|available|processing|unavailable|failed |
| get_media_detailsB | Get media details. Single/batch with level control (basic/standard/full). Media/season status: 1=UNKNOWN, 2=PENDING, 3=PROCESSING, 4=PARTIALLY_AVAILABLE, 5=AVAILABLE, 7=DELETED (Seerr). Code 6 is BLOCKLISTED in Seerr or DELETED in legacy Overseerr. Request statuses use a separate enum. |
| get_servicesA | List configured Radarr/Sonarr servers. Returns ID, name, isDefault, 4K status, active defaults (directory, profile, tags). |
| get_service_detailsB | Get quality profiles, root folders, tags, and language profiles (Sonarr) for a Radarr/Sonarr server. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool maps to a distinct action (list services, search, request, manage requests, details, service config), but the pairs get_services/get_service_details and search_media/get_media_details have overlapping-sounding names that require reading descriptions to separate. The descriptions do clarify the boundary (list vs. config detail; quick status vs. full detail), so misselection risk is low but non-zero.
All names use snake_case with a verb_noun pattern (get_services, search_media, request_media, manage_media_requests), which is highly predictable. Minor inconsistency in granularity between get_services (plural list) and get_service_details (singular detail), but the convention holds.
Six tools is a tight, well-scoped surface for a Seerr/Radarr/Sonarr request-proxy server, with no redundant or filler tools. Each tool covers a distinct stage of the discover→request→manage→inspect workflow.
The core lifecycle is covered: service discovery, media search with actionable statuses, request creation with confirmation rules, request management (get/list/approve/decline/delete), and detail inspection. Gaps exist around library-side operations (deleting media from Radarr/Sonarr) and user/quota or settings management, but agents can work around these.