MCP *arr Server
One-line summary: This MCP server provides unified AI-assisted management, search, monitoring, and configuration review for Sonarr, Radarr, Lidarr, and Prowlarr, plus TRaSH Guides reference and comparison tools.
Check status across configured *arr services and search across all services.
Use generic
search/fetchdiscovery tools for remote MCP clients such as ChatGPT.Browse Sonarr series, episodes, files, queues, and calendars; trigger missing/episode searches, refresh metadata, and add series.
Browse Radarr movies, files, releases, queues, and calendars; add/update/search movies, bulk-search movies, refresh metadata, and remove queue items with optional blocklisting.
Inspect exact Sonarr/Radarr releases and grab a user-approved release with confirmation and rejection acknowledgement safeguards.
Inspect Radarr manual-import candidates and submit selected imports with confirmed paths, sizes, movie IDs, and import mode.
Manage Lidarr artists and albums, view calendars, add artists, and search albums or missing releases.
Manage Prowlarr indexers: list, search, test health, and view statistics.
Review service configuration: quality profiles, health warnings, root folders/storage, download clients, naming, tags, and comprehensive setup dumps.
Use TRaSH Guides tools for quality profiles, custom formats, naming conventions, quality sizes, and comparison against your configured profiles/naming.
Support pagination, filtering, sorting, and read-only annotations, with mutating tools clearly marked for state-changing actions.
Provides tools for managing movie libraries, including listing movies, searching for films, triggering downloads, checking download queues, and viewing upcoming movie releases.
Provides tools for managing TV series libraries, including listing series, viewing episodes, searching for shows, triggering downloads, checking download queues, and viewing upcoming episode calendars.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP *arr Server what's downloading right now?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP *arr Server

MCP server for the *arr media management suite - Sonarr, Radarr, Lidarr, and Prowlarr.
Supports both local stdio mode for Claude/Codex-style clients and remote HTTP mode for hosted MCP clients such as ChatGPT connectors.
Why Use This?
Unified media management - Control all your *arr applications from one interface
Natural language queries - Ask about your library in plain English
Cross-service search - Find content across TV, movies, and music simultaneously
Download monitoring - Check queue status and progress across all services
Calendar integration - See upcoming releases for all media types
Configuration review - Get AI-powered suggestions for optimizing your setup
Flexible configuration - Enable only the services you use
Related MCP server: MCParr Server
Features
Category | Capabilities |
Sonarr (TV) | List series, view episodes, search shows, trigger downloads, check queue, view calendar, review setup |
Radarr (Movies) | List movies, search films, trigger downloads, check queue, view releases, review setup |
Lidarr (Music) | List artists, view albums, search musicians, trigger downloads, check queue, view calendar, review setup |
Prowlarr (Indexers) | List indexers, search across all trackers, test health, view statistics |
Cross-Service | Status check, unified search across all configured services |
Configuration | Quality profiles, download clients, naming conventions, health checks, storage info |
TRaSH Guides | Reference quality profiles, custom formats, naming conventions, compare against recommendations |
Prerequisites
Node.js 20+ for HTTP mode. Node.js 18 builds, but valid HTTP requests return HTTP 400 in the verified baseline and v1.7.4 candidate. Use Node.js 20 or newer for HTTP clients.
At least one *arr application running with API access:
Installation
Using npm (Recommended)
npx mcp-arr-serverRemote HTTP Mode
MCP_TRANSPORT=http PORT=3000 npx mcp-arr-serverBy default the remote server listens on 127.0.0.1:3000 and serves MCP on /mcp.
Environment variables for remote mode:
MCP_TRANSPORT=httpto enable remote Streamable HTTP transportHOSTto override the bind host (default127.0.0.1)PORTto override the port (default3000)MCP_PATHto override the MCP endpoint path (default/mcp)
Docker
Prebuilt images are published to GitHub Container Registry on every release. You do not need to build anything:
docker pull ghcr.io/aplaceforallmystuff/mcp-arr:latestTags follow the release version — latest, 1, 1.7, and each exact version such as 1.7.3.
Pin to a major or minor tag if you want updates without surprises.
Run in local stdio mode:
docker run --rm -i \
-e SONARR_URL=http://host.docker.internal:8989 \
-e SONARR_API_KEY=your-sonarr-api-key \
ghcr.io/aplaceforallmystuff/mcp-arr:latestRun in remote HTTP mode:
docker run --rm -p 3000:3000 \
-e MCP_TRANSPORT=http \
-e HOST=0.0.0.0 \
-e PORT=3000 \
-e SONARR_URL=http://host.docker.internal:8989 \
-e SONARR_API_KEY=your-sonarr-api-key \
ghcr.io/aplaceforallmystuff/mcp-arr:latestMinimal docker-compose.yml:
services:
mcp-arr:
image: ghcr.io/aplaceforallmystuff/mcp-arr:latest
ports:
- "3000:3000"
environment:
MCP_TRANSPORT: http
HOST: 0.0.0.0
PORT: 3000
SONARR_URL: http://host.docker.internal:8989
SONARR_API_KEY: your-sonarr-api-key
RADARR_URL: http://host.docker.internal:7878
RADARR_API_KEY: your-radarr-api-keyBuilding it yourself
Only needed if you are developing against a change that is not released yet:
docker build -t mcp-arr .From Source
git clone https://github.com/aplaceforallmystuff/mcp-arr.git
cd mcp-arr
npm install
npm run buildConfiguration
Getting API Keys
Each *arr application has an API key in Settings > General > Security:
Open your *arr application's web interface
Go to Settings > General
Find the API Key under the Security section
Copy the API key for use in configuration
For Claude Desktop
Add to your Claude Desktop config file:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"arr": {
"command": "npx",
"args": ["-y", "mcp-arr-server"],
"env": {
"SONARR_URL": "http://localhost:8989",
"SONARR_API_KEY": "your-sonarr-api-key",
"RADARR_URL": "http://localhost:7878",
"RADARR_API_KEY": "your-radarr-api-key",
"LIDARR_URL": "http://localhost:8686",
"LIDARR_API_KEY": "your-lidarr-api-key",
"PROWLARR_URL": "http://localhost:9696",
"PROWLARR_API_KEY": "your-prowlarr-api-key"
}
}
}
}For Claude Code
Add to ~/.claude.json:
{
"mcpServers": {
"arr": {
"command": "npx",
"args": ["-y", "mcp-arr-server"],
"env": {
"SONARR_URL": "http://localhost:8989",
"SONARR_API_KEY": "your-sonarr-api-key",
"RADARR_URL": "http://localhost:7878",
"RADARR_API_KEY": "your-radarr-api-key"
}
}
}
}Note: Only configure the services you have running. The server automatically detects which services are available based on the environment variables you provide.
TRaSH-only mode: if you don’t configure any *arr services, the server still starts and exposes the TRaSH Guides reference tools plus generic search and fetch.
Read-only mode: set ARR_READ_ONLY=true to hide every tool that changes state (searches, refreshes, adds, updates, deletes, release grabs and manual imports) from tools/list and refuse calls to them. A tool counts as read-only when its readOnlyHint annotation is true.
ChatGPT / Remote MCP
To use mcp-arr with ChatGPT, run the server in remote HTTP mode on a reachable host and connect ChatGPT to the /mcp endpoint.
The server now exposes the generic search and fetch tools expected by ChatGPT-style remote MCP integrations:
searchdiscovers matching *arr media and TRaSH profilesfetchreturns structured detail for a selected search result
The existing service-specific tools remain available for richer local or power-user workflows.
Usage Examples
Library Management
"Show me all my TV series"
"What movies do I have in Radarr?"
"List all artists in my music library"
Searching & Adding Content
"Search for sci-fi shows on Sonarr"
"Find action movies from the 90s"
"Add this show to my TV library"
"Add that movie to Radarr"
"Search for jazz albums and add this artist"
"Add this movie with my '4k' tag"
"What tags do I have in Sonarr?"
Download Queue
"What's downloading right now?"
"Check the Sonarr queue"
"Show Radarr download progress"
Upcoming Releases
"What TV episodes are coming this week?"
"Show upcoming movie releases"
"Any new albums coming out this month?"
Downloading Content
"What episodes of this show am I missing?"
"Download the missing episodes for that series"
"Search for this specific movie"
"Grab that album I'm missing"
Indexer Management
"Are my indexers healthy?"
"How are my indexers performing?"
"Test all my Prowlarr indexers"
Configuration Review
"Review my Sonarr setup and suggest improvements"
"Show me my quality profiles in Radarr"
"Are there any health issues with my Lidarr?"
"What naming convention am I using for TV shows?"
"Help me understand my quality profiles - why am I not getting 4K?"
"Check my download client configuration"
"How much free space do I have on my root folders?"
Cross-Service
"Check status of all my *arr services"
"Search for 'comedy' across all services"
Available Tools
Radarr manual import
Use radarr_get_manual_import_candidates to inspect a completed download folder or download ID. Review exact paths, movie mappings, sizes, quality, languages and rejection reasons before calling radarr_manual_import. Import requires confirmed=true, 1–25 selected files with expected sizes, and an explicit auto, copy or move mode. A fresh scan must still match each selection. Duplicate paths or movie selections, unknown metadata, changed download IDs and substantive rejections are refused. Preference overrides use the same narrow recognized reasons as exact release grabs and require exact current acknowledgements.
Radarr may replace existing library files. copy preserves the download source; move can remove it; auto follows Radarr download-client rules. A response with submitted=true and imported=false means only that Radarr accepted a command. Use radarr_get_command and inspect the resulting movie files and queue before treating the import as complete or retrying.
Exact release grabs
Use sonarr_grab_release or radarr_grab_release only after the user approves the exact media ID, indexer ID and GUID. Both require confirmed=true and re-query current releases before submitting one download. Missing, ambiguous or download-disallowed candidates are refused.
Rejection overrides require exact current acknowledgedRejections strings. Supported preference reasons are Not an upgrade, Existing file meets cutoff, and cutoff reasons naming a Remux/Bluray/WEBDL/WEBRip/HDTV quality at 720p, 1080p or 2160p. Unknown wording and substantive rejections are refused. After an ambiguous submission, inspect the queue and library before retrying.
Release inspection
Use sonarr_get_episode_releases or radarr_get_movie_releases to inspect interactive indexer results without starting downloads. Responses include exact GUID/indexer IDs, sizes, languages, quality, availability and rejection reasons. Pagination limits the response, not the underlying indexer search.
Queue diagnostics
Paginated queue responses include statusMessages, downloadId, outputPath, sizeBytes and sizeLeftBytes. These fields help distinguish failed downloads from completed downloads awaiting import. Queue absence alone does not establish success or failure. Output paths refer to the configured server filesystem.
Add Sonarr and Radarr file metadata tools
Inspect existing episode and movie files with paginated summary or full MediaInfo responses. Defaults to 25 records; limit is capped at 100. No media files are opened or changed.
sonarr_get_episode_filesradarr_get_movie_files
General Tools
Tool | Description |
| Get connection status for all configured *arr services |
| Search across all configured services simultaneously |
| Generic discovery tool for remote MCP clients such as ChatGPT |
| Generic detail-fetch tool for items returned by |
Sonarr Tools (TV)
Tool | Description |
| List TV series in your library, optionally sorted by date added or size on disk |
| Search for TV series by name (returns tvdbId for adding) |
| Add a TV series to Sonarr (supports tags) |
| Get available root folders for adding series |
| Get available quality profiles for adding series |
| View current download queue with |
| See upcoming episodes |
| List episodes for a series (shows missing vs available) |
| Trigger search for all missing episodes in a series |
| Trigger search for specific episode(s) |
| Trigger a metadata refresh for a specific series in Sonarr |
Radarr Tools (Movies)
Tool | Description |
| List movies in your library, optionally sorted by date added or size on disk |
| Search for movies by name (returns tmdbId for adding) |
| Add a movie to Radarr (supports tags) |
| Get available root folders for adding movies |
| Get available quality profiles for adding movies |
| View current download queue with |
| See upcoming releases |
| Trigger search to download a movie in your library |
| Bulk-trigger searches for multiple movie IDs at once |
| Update a movie's quality profile, monitored status, minimum availability, tags, or path |
| Remove an item from the download queue (optionally blocklist the release) |
| Trigger a metadata refresh for a specific movie in Radarr |
Lidarr Tools (Music)
Tool | Description |
| List all artists in your library |
| Search for artists by name (returns foreignArtistId for adding) |
| Add an artist to Lidarr (supports tags) |
| Get available root folders for adding artists |
| Get available quality profiles for adding artists |
| Get available metadata profiles for adding artists |
| View current download queue with |
| List albums for an artist (shows missing vs available) |
| Trigger search for a specific album |
| Trigger search for all missing albums for an artist |
| See upcoming album releases |
Prowlarr Tools (Indexers)
Tool | Description |
| List all configured indexers |
| Search across all indexers |
| Test all indexers and return health status |
| Get indexer statistics (queries, grabs, failures) |
Configuration Review Tools
These tools are available for Sonarr, Radarr, and Lidarr. Replace {service} with the service name (e.g., sonarr_get_quality_profiles).
Tool | Description |
| Detailed quality profile information with allowed qualities and custom format scores |
| Health check warnings and issues detected by the application |
| Storage paths, free space, and accessibility status |
| Download client configurations and settings |
| File and folder naming conventions |
| Tag definitions for content organization |
| Comprehensive configuration dump for AI-assisted setup analysis |
The {service}_review_setup tool returns all configuration in a single call, enabling natural language conversations about optimizing your setup. Claude can analyze your quality profiles, suggest improvements, explain why certain content isn't being grabbed, and help configure complex settings like custom formats.
⚠️ Disclaimer: The configuration review tools provide read-only access to your *arr settings. Any changes to your configuration must be made directly in the *arr application interfaces. The AI's suggestions are recommendations only - always back up your configuration before making significant changes. The maintainers are not responsible for any configuration changes, data loss, or other issues that may arise from following AI-generated recommendations.
TRaSH Guides Tools
Access community-curated quality profiles, custom formats, and naming conventions from TRaSH Guides directly through Claude or ChatGPT. These tools work without any *arr configuration - they fetch reference data from the TRaSH Guides GitHub repository.
Tool | Description |
| List available TRaSH quality profiles for Radarr or Sonarr |
| Get detailed profile with custom formats, scores, and quality settings |
| List custom formats with optional category filter (hdr, audio, resolution, etc.) |
| Get recommended naming conventions for Plex, Emby, Jellyfin, or standard |
| Get recommended min/max/preferred sizes for each quality level |
| Compare your profile against TRaSH recommendations (requires *arr configured) |
| Compare your naming config against TRaSH recommendations (requires *arr configured) |
Example usage:
"What quality profiles does TRaSH recommend for 4K movies?"
"Show me the remux-web-1080p profile details"
"Compare my Radarr profile 4 against the TRaSH uhd-bluray-web profile"
"What naming convention should I use for Plex?"
"List HDR-related custom formats for Radarr"
Data is cached for 1 hour to minimize GitHub API calls.
Development
# Watch mode for development
npm run watch
# Build TypeScript
npm run build
# Run locally
SONARR_URL="http://localhost:8989" SONARR_API_KEY="your-key" node dist/index.jsTroubleshooting
"No *arr services configured"
Ensure you have set at least one pair of URL and API_KEY environment variables:
SONARR_URL="http://localhost:8989"
SONARR_API_KEY="your-api-key""API error: 401 Unauthorized"
The API key is incorrect. Verify it in your *arr application under Settings > General > Security.
"fetch failed" or "ECONNREFUSED"
The *arr application is not running or the URL is incorrect. Verify:
The application is running
The URL and port are correct
There's no firewall blocking the connection
"Sonarr/Radarr/etc not configured"
You tried to use a tool for a service that isn't configured. Add the corresponding URL and API_KEY environment variables.
"SONARR_URL must be a full http:// or https:// URL"
The server stops at startup when a configured service URL has no http:// or https:// scheme, for example localhost:8989. Use the full URL, such as http://localhost:8989.
"Invalid arguments for ..."
Tool arguments are checked against the tool's input schema before any request is sent. IDs must be positive integers, and booleans, enums and limits must match the schema.
Need help building or securing MCP servers?
I build and maintain MCP servers like this one, and I review AI and agent setups for security. If your team needs a custom server, an integration, or a security review of one you already run, see jimchristian.net/work or book a discovery session.
Contributing
See CONTRIBUTING.md for setup, checks, and tool changes.
License
MIT - see LICENSE for details.
Links
Servarr Wiki - Documentation for all *arr applications
TRaSH Guides - Quality profiles, custom formats, and setup guides
Available Tools
73 toolsarr_search_allBRead-only
Search across all configured *arr services for any media
Inputs: term (required).
arr_statusARead-only
Get status of all configured *arr services. Currently configured: Sonarr (TV), Radarr (Movies), Lidarr (Music), Prowlarr (Indexers)
Inputs: no named parameters.
fetchARead-only
Fetch a specific item returned by search. Accepts an opaque item id from the search tool.
Inputs: id (required).
lidarr_add_artistA
Add an artist to Lidarr. Use lidarr_search first to find the foreignArtistId, and lidarr_get_root_folders / lidarr_get_quality_profiles / lidarr_get_metadata_profiles to get valid values. Use lidarr_get_tags to get valid tag IDs.
Inputs: artistName (required), rootFolderPath (required), foreignArtistId (required), qualityProfileId (required), +3 more.
lidarr_get_albumsARead-only
Get albums for an artist in Lidarr. Shows which albums are available and which are missing.
Inputs: artistId (required).
lidarr_get_artistsBRead-only
Get all artists in Lidarr library
Inputs: no named parameters.
lidarr_get_calendarBRead-only
Get upcoming album releases from Lidarr
Inputs: days.
lidarr_get_download_clientsARead-only
Get download client configurations from Lidarr (Music). Shows configured clients and their settings.
Inputs: no named parameters.
lidarr_get_healthARead-only
Get health check warnings and issues from Lidarr (Music). Shows any problems detected by the application.
Inputs: no named parameters.
lidarr_get_metadata_profilesARead-only
Get available metadata profiles for Lidarr. Use this to find valid metadataProfileId values when adding an artist.
Inputs: no named parameters.
lidarr_get_namingBRead-only
Get file naming configuration from Lidarr (Music). Shows naming patterns for files and folders.
Inputs: no named parameters.
lidarr_get_quality_profilesARead-only
Get detailed quality profiles from Lidarr (Music). Shows allowed qualities, upgrade settings, and custom format scores.
Inputs: no named parameters.
lidarr_get_queueCRead-only
Get Lidarr download queue. Supports pagination with limit and offset.
Inputs: limit, offset.
lidarr_get_root_foldersBRead-only
Get root folders and storage info from Lidarr (Music). Shows paths, free space, and unmapped folders.
Inputs: no named parameters.
lidarr_get_tagsARead-only
Get all tags defined in Lidarr (Music). Tags can be used to organize and filter content.
Inputs: no named parameters.
lidarr_review_setupARead-only
Get comprehensive configuration review for Lidarr (Music). Returns all settings for analysis: quality profiles, download clients, naming, storage, indexers, health warnings, and more. Use this to analyze the setup and suggest improvements.
Inputs: no named parameters.
lidarr_searchARead-only
Search for artists by name. Returns results with foreignArtistId needed for lidarr_add_artist.
Inputs: term (required).
lidarr_search_albumB
Trigger a search for a specific album to download
Inputs: albumId (required).
lidarr_search_missingA
Trigger a search for all missing albums for an artist
Inputs: artistId (required).
prowlarr_get_indexersBRead-only
Get all configured indexers in Prowlarr
Inputs: no named parameters.
prowlarr_get_statsARead-only
Get indexer statistics (queries, grabs, failures)
Inputs: no named parameters.
prowlarr_searchCRead-only
Search across all Prowlarr indexers
Inputs: query (required).
prowlarr_test_indexersA
Test all indexers and return their health status
Inputs: no named parameters.
radarr_add_movieA
Add a movie to Radarr. Use radarr_search first to find the tmdbId, and radarr_get_root_folders / radarr_get_quality_profiles to get valid values. Use radarr_get_tags to get valid tag IDs.
Inputs: title (required), tmdbId (required), rootFolderPath (required), qualityProfileId (required), +3 more.
radarr_delete_queue_itemADestructiveIdempotent
Remove an item from the Radarr download queue. Use radarr_get_queue to find queue item IDs. Can optionally blocklist the release to prevent re-grabbing.
Inputs: queueId (required), blocklist, removeFromClient.
radarr_get_calendarCRead-only
Get upcoming movie releases from Radarr
Inputs: days.
radarr_get_commandBRead-only
Read Radarr command status by ID, including manual-import completion or failure. Verify actual movie files after completion.
Inputs: commandId (required).
radarr_get_download_clientsARead-only
Get download client configurations from Radarr (Movies). Shows configured clients and their settings.
Inputs: no named parameters.
radarr_get_healthARead-only
Get health check warnings and issues from Radarr (Movies). Shows any problems detected by the application.
Inputs: no named parameters.
radarr_get_manual_import_candidatesARead-only
Inspect a completed download folder or downloadId for manual import. Returns exact paths, sizes, parsed movie/quality/languages and rejection reasons. Does not import. Review edition and media quality separately.
Inputs: folder, downloadId.
radarr_get_movie_filesARead-only
Get paginated Radarr movie file sizes and MediaInfo. fields=summary (default) returns compact metadata; fields=full includes scene names and all available MediaInfo.
Inputs: movieId (required), limit, fields, offset.
radarr_get_movie_releasesARead-only
Read-only interactive Radarr indexer search for movie releases; does not grab or download. Returns release details and rejection reasons.
Inputs: movieId (required), limit, offset.
radarr_get_moviesARead-only
Get movies from Radarr library with optional pagination, title filtering and sorting. Defaults to limit=25 to avoid very large responses. Use offset to fetch additional pages. Optional sortBy (dateAdded or sizeOnDisk) is applied before pagination.
Inputs: limit, offset, search, sortBy, +1 more.
radarr_get_namingARead-only
Get file naming configuration from Radarr (Movies). Shows naming patterns for files and folders.
Inputs: no named parameters.
radarr_get_quality_profilesARead-only
Get detailed quality profiles from Radarr (Movies). Shows allowed qualities, upgrade settings, and custom format scores.
Inputs: no named parameters.
radarr_get_queueBRead-only
Get Radarr download queue. Supports pagination with limit and offset.
Inputs: limit, offset.
radarr_get_root_foldersARead-only
Get root folders and storage info from Radarr (Movies). Shows paths, free space, and unmapped folders.
Inputs: no named parameters.
radarr_get_tagsBRead-only
Get all tags defined in Radarr (Movies). Tags can be used to organize and filter content.
Inputs: no named parameters.
radarr_grab_releaseADestructive
Manually grab one specifically approved Radarr release, with exact acknowledgement required to override cutoff/not-an-upgrade rejections. Causes a download; call only after user explicitly approves the exact release. Revalidates release against current interactive search.
Inputs: guid (required), movieId (required), confirmed (required), indexerId (required), +1 more.
radarr_manual_importADestructive
Submit selected inspected files to Radarr ManualImport. May replace existing library files. Requires confirmed=true, exact paths/movie IDs/sizes, and exact acknowledged preference rejection reasons. Re-scans before submission. Substantive quality/language/edition problems are refused. Returns a command, not proof of import; check command and movie files before retrying. Copy preserves the source; move can remove it; auto follows Radarr download-client rules.
Inputs: files (required), confirmed (required), importMode (required), folder, +1 more.
radarr_refresh_movieB
Trigger a metadata refresh for a specific movie in Radarr
Inputs: movieId (required).
radarr_review_setupARead-only
Get comprehensive configuration review for Radarr (Movies). Returns all settings for analysis: quality profiles, download clients, naming, storage, indexers, health warnings, and more. Use this to analyze the setup and suggest improvements.
Inputs: no named parameters.
radarr_searchARead-only
Search for movies by name. Returns results with tmdbId needed for radarr_add_movie.
Inputs: term (required).
radarr_search_movieA
Trigger a search to download a movie that's already in your library
Inputs: movieId (required).
radarr_search_moviesA
Trigger a search for multiple movies at once. Accepts an array of movie IDs. Use this for bulk upgrade requests instead of calling radarr_search_movie one at a time.
Inputs: movieIds (required).
radarr_update_movieADestructiveIdempotent
Update a movie in Radarr. Can change qualityProfileId, monitored status, minimumAvailability, tags, and path. Fetches the full movie object, applies your changes, and PUTs it back.
Inputs: movieId (required), path, tags, monitored, +2 more.
searchARead-only
Search across configured *arr libraries plus TRaSH Guides reference profiles. This is the primary discovery tool for remote MCP clients such as ChatGPT.
Inputs: query (required).
sonarr_add_seriesA
Add a TV series to Sonarr. Use sonarr_search first to find the tvdbId, and sonarr_get_root_folders / sonarr_get_quality_profiles to get valid values for rootFolderPath and qualityProfileId. Use sonarr_get_tags to get valid tag IDs.
Inputs: title (required), tvdbId (required), rootFolderPath (required), qualityProfileId (required), +3 more.
sonarr_get_calendarBRead-only
Get upcoming TV episodes from Sonarr
Inputs: days.
sonarr_get_download_clientsBRead-only
Get download client configurations from Sonarr (TV). Shows configured clients and their settings.
Inputs: no named parameters.
sonarr_get_episode_filesARead-only
Get paginated Sonarr episode-file metadata. fields=summary (default) gives compact codec and size data; fields=full returns all available MediaInfo. Read-only.
Inputs: seriesId (required), limit, fields, offset.
sonarr_get_episode_releasesARead-only
Read-only interactive Sonarr indexer search for alternative releases of an episode; does not grab or download. Returns compact release details and rejection reasons.
Inputs: episodeId (required), limit, offset.
sonarr_get_episodesBRead-only
Get episodes for a TV series. Shows which episodes are available and which are missing.
Inputs: seriesId (required), seasonNumber.
sonarr_get_healthARead-only
Get health check warnings and issues from Sonarr (TV). Shows any problems detected by the application.
Inputs: no named parameters.
sonarr_get_namingARead-only
Get file naming configuration from Sonarr (TV). Shows naming patterns for files and folders.
Inputs: no named parameters.
sonarr_get_quality_profilesARead-only
Get detailed quality profiles from Sonarr (TV). Shows allowed qualities, upgrade settings, and custom format scores.
Inputs: no named parameters.
sonarr_get_queueBRead-only
Get Sonarr download queue. Supports pagination with limit and offset.
Inputs: limit, offset.
sonarr_get_root_foldersARead-only
Get root folders and storage info from Sonarr (TV). Shows paths, free space, and unmapped folders.
Inputs: no named parameters.
sonarr_get_seriesARead-only
Get TV series from Sonarr library with optional pagination, title filtering and sorting. Defaults to limit=25 to avoid very large responses. Use offset to fetch additional pages. Optional sortBy (dateAdded or sizeOnDisk) is applied before pagination.
Inputs: limit, offset, search, sortBy, +1 more.
sonarr_get_tagsBRead-only
Get all tags defined in Sonarr (TV). Tags can be used to organize and filter content.
Inputs: no named parameters.
sonarr_grab_releaseADestructive
Manually grab one specifically approved Sonarr release, with exact acknowledgement required to override cutoff/not-an-upgrade rejections. Causes a download; call only after user explicitly approves the exact release. Revalidates release against current interactive search.
Inputs: guid (required), confirmed (required), episodeId (required), indexerId (required), +1 more.
sonarr_refresh_seriesB
Trigger a metadata refresh for a specific series in Sonarr
Inputs: seriesId (required).
sonarr_review_setupARead-only
Get comprehensive configuration review for Sonarr (TV). Returns all settings for analysis: quality profiles, download clients, naming, storage, indexers, health warnings, and more. Use this to analyze the setup and suggest improvements.
Inputs: no named parameters.
sonarr_searchARead-only
Search for TV series by name. Returns results with tvdbId needed for sonarr_add_series.
Inputs: term (required).
sonarr_search_episodeB
Trigger a search for specific episode(s)
Inputs: episodeIds (required).
sonarr_search_missingB
Trigger a search for all missing episodes in a series
Inputs: seriesId (required).
trash_compare_namingARead-only
Compare your naming configuration against TRaSH Guides recommendations. Requires the corresponding *arr service to be configured.
Inputs: service (required), mediaServer (required).
trash_compare_profileARead-only
Compare your quality profile against TRaSH Guides recommendations. Shows missing custom formats, scoring differences, and quality settings. Requires the corresponding *arr service to be configured.
Inputs: service (required), profileId (required), trashProfile (required).
trash_get_namingBRead-only
Get TRaSH Guides recommended naming conventions for your media server (Plex, Emby, Jellyfin, or standard)
Inputs: service (required), mediaServer (required).
trash_get_profileARead-only
Get a specific TRaSH Guides quality profile with all custom format scores, quality settings, and implementation details
Inputs: profile (required), service (required).
trash_get_quality_sizesBRead-only
Get TRaSH Guides recommended min/max/preferred sizes for each quality level
Inputs: service (required), type.
trash_list_custom_formatsARead-only
List available TRaSH Guides custom formats. Can filter by category: hdr, audio, resolution, source, streaming, anime, unwanted, release, language
Inputs: service (required), category.
trash_list_profilesARead-only
List available TRaSH Guides quality profiles for Radarr or Sonarr. Shows recommended profiles for different use cases (1080p, 4K, Remux, etc.)
Inputs: service (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 73 tools
Service prefixes and action-specific names make most tools clearly distinct. However, several search-related tools overlap in wording (search, arr_search_all, prowlarr_search, sonarr_search, radarr_search vs radarr_search_movie, lidarr_search vs lidarr_search_album), so agents may need descriptions to avoid misselection.
Most tools follow a predictable service_verb_noun pattern such as sonarr_get_series, radarr_add_movie, and lidarr_search_album. The main deviations are the generic search/fetch tools and arr_status/arr_search_all, which break the service-prefix convention but remain understandable.
Seventy-three tools is far above the typical 3-15 sweet spot and creates a heavy navigation burden for an agent. The breadth across four *arr services plus TRaSH explains some of the count, but the repeated per-service config getters make the surface unnecessarily large.
Core discovery, add, search, queue, and configuration-read workflows are covered for Sonarr, Radarr, Lidarr, and Prowlarr. However, Sonarr and Lidarr lack update/delete operations for series/artists and queue-item removal, Prowlarr lacks indexer CRUD, and Sonarr lacks the manual-import/command-status workflow that Radarr has.
Maintenance
Related MCP Connectors
The media memory layer for AI agents and their humans. Your AI client can search your collection, add and log what you've finished, update ratings and lists, and find patterns across everything you've read, watched, played, and listened to.
Manage your Rad TV videos, playlists and channels from your AI assistant (Rad TV subscription).
Trakt MCP — TV/movie metadata + watch tracking signals
Unlock a world of television with the TV Maze MCP server. Effortlessly search for shows by name or
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Sonarr and Radarr APIs to query media libraries, check recent additions, view upcoming releases, manage download queues, and perform searches for TV shows and movies through natural language.1MIT
- FlicenseNot gradedqualityDmaintenanceIntegrates with Radarr and Sonarr to manage your media library, enabling search, download requests, status checks, and system health monitoring.6-
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to manage media automation services like Sonarr, Radarr, Prowlarr, Bazarr, Overseerr, and Plex through natural language commands.9MIT
- AlicenseAqualityDmaintenanceEnables interaction with the *arr media management suite (Sonarr, Radarr, Lidarr, Prowlarr, SABnzbd) and TRaSH Guides through MCP tools, allowing media library management, searching, and configuration via natural language.7027 npm1MIT