multimedia-search-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PROWLARR_API_KEY | No | Prowlarr API key used for authentication. | |
| PROWLARR_TIMEOUT | No | Optional timeout in seconds (1-120). | |
| PROWLARR_BASE_URL | No | Base URL of the Prowlarr server, e.g. http://127.0.0.1:9696. | |
| PROWLARR_ENV_FILE | No | Optional path to the .env file containing Prowlarr configuration. If not set, the server searches ./.env and then the repository root .env. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Servidor de búsqueda multimedia de solo lectura. Busca releases en los proveedores configurados (actualmente Prowlarr) y normaliza los resultados. Nunca descarga contenido ni modifica el proveedor. Los datos técnicos solo aparecen si el proveedor los entrega de forma estructurada.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_mediaA | Busca contenido multimedia en los proveedores configurados. Args: query: Título o términos de búsqueda. media_type: movie, series, anime, book, manga u other. year: Año de estreno/publicación (solo si el proveedor lo soporta). categories: Filtro explícito de categorías del proveedor: ids numéricos Newznab o nombres exactos del árbol (p. ej. "2040" o "Movies/HD"). Los ids se validan contra el árbol antes de buscar; las categorías nativas de un indexador (p. ej. 130420) se rechazan porque el filtro de Prowlarr es global. Si el árbol no está disponible, los ids se envían sin validar y se avisa. limit: Resultados por página (1-100, por defecto 20). offset: Desplazamiento dentro de la ventana recibida (por defecto 0). provider: Proveedor a usar (por defecto, el primero configurado). Semántica de la respuesta (deliberadamente conservadora): received_count: resultados recibidos del proveedor (una ventana, no el total del índice). returned_count: resultados de esta página tras limit/offset local. has_more: true si quedan resultados en la ventana recibida; null si no puede determinarse. Nunca false: no se puede demostrar que no haya más. next_offset indica la página siguiente cuando aplica. total_available: null cuando el proveedor no garantiza el total. truncated: true solo si el proveedor aporta evidencia de corte; null si no se sabe (caso de Prowlarr: no hay evidencia). per_indexer: resultados y fiabilidad de la ventana por indexador. category_match: por resultado, in_subtree / off_category / uncategorized (solo con filtro de categorías); resumen en category_match_summary. Los resultados sin categoría se conservan pero no se presentan como coincidencia confirmada. Una lista vacía no garantiza que no existan coincidencias. |
| list_providersA | Lista los proveedores registrados y si están configurados. No realiza peticiones de red. |
| list_indexersB | Lista los indexadores configurados en el proveedor y su estado. Incluye estadísticas cuando el proveedor las publica (son opcionales). |
| get_provider_statusA | Comprueba conectividad, autenticación y disponibilidad del proveedor. Devuelve |
| get_search_capabilitiesC | Devuelve los tipos de búsqueda y categorías que admite la configuración actual. Por tipo de contenido indica el modo ( Las capacidades describen el filtrado del proveedor, no una clasificación semántica: movie/series/anime pueden solaparse (TV 5000 incluye 5070). |
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 5 tools
search_media is clearly the only action tool, and the four introspection tools each target a different layer (providers registry, indexers, connectivity, capabilities). The closest pair is list_providers vs get_provider_status, but the descriptions explicitly separate 'configured' from 'reachable/authenticated', so confusion is limited.
All five tools follow a strict verb_noun snake_case pattern (list_providers, list_indexers, search_media, get_provider_status, get_search_capabilities). Verb choice is also semantically predictable (list for collections, get for single status/capability, search for queries).
Five tools is tightly scoped: one search operation plus four read-only introspection endpoints covering the configuration surface agents need before searching. Nothing looks redundant or padde.
Core lifecycle for a search gateway (discover providers/indexers, check health, inspect capabilities, run search with pagination) is covered, but there is no tool to fetch details for a specific result and no way to add or configure a provider, which could dead-end follow-up workflows.