Skip to content
Back to search

mcp-arr

MCP server for *arr media management suite

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/aplaceforallmystuff/mcp-arr with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/aplaceforallmystuff/mcp-arr'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/aplaceforallmystuff--mcp-arr/badge.svg)](/listings/aplaceforallmystuff--mcp-arr)

HTML

<a href="/listings/aplaceforallmystuff--mcp-arr"><img src="/api/listings/aplaceforallmystuff--mcp-arr/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Using npm (Recommended)

npx mcp-arr-server

Remote HTTP Mode

MCP_TRANSPORT=http PORT=3000 npx mcp-arr-server

By default the remote server listens on `127.0.0.1:3000` and serves MCP on `/mcp`.

Environment variables for remote mode:

- `MCP_TRANSPORT=http` to enable remote Streamable HTTP transport - `HOST` to override the bind host (default `127.0.0.1`) - `PORT` to override the port (default `3000`) - `MCP_PATH` to 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:latest

Tags 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:latest

Run 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:latest

Minimal `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-key

Building 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 build

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 464 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # MCP *arr Server
  2. ![Architecture](docs/mcp-arr-architecture-diagram.png)
  3. <!-- <p align="center">
  4. <img src="docs/mcp-arr-logo.png" alt="MCP *arr Server" width="400">
  5. </p> -->
  6. [![Oathe Security](https://img.shields.io/endpoint?url=https%3A%2F%2Faudit-engine.oathe.ai%2Fapi%2Fbadge%2Faplaceforallmystuff%2Fmcp-arr&style=for-the-badge&logo=data:image/svg%2Bxml;base64,PHN2ZyB4bWxucz0naHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmcnIHZpZXdCb3g9JzAgMCAyNCAyNCcgZmlsbD0nd2hpdGUnPjxwYXRoIGQ9J00xMiAyQzkuMjQgMiA3IDQuMjQgNyA3djNINmMtMS4xIDAtMiAuOS0yIDJ2OGMwIDEuMS45IDIgMiAyaDEyYzEuMSAwIDItLjkgMi0ydi04YzAtMS4xLS45LTItMi0yaC0xVjdjMC0yLjc2LTIuMjQtNS01LTV6bTMgMTBIOVY3YzAtMS42NiAxLjM0LTMgMy0zczMgMS4zNCAzIDN2M3onLz48L3N2Zz4=&labelColor=000000&cacheSeconds=3600)](https://oathe.ai/report/aplaceforallmystuff/mcp-arr)
  7. [![npm version](https://img.shields.io/npm/v/mcp-arr-server.svg)](https://www.npmjs.com/package/mcp-arr-server)
  8. [![CI](https://github.com/aplaceforallmystuff/mcp-arr/actions/workflows/ci.yml/badge.svg)](https://github.com/aplaceforallmystuff/mcp-arr/actions/workflows/ci.yml)
  9. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  10. [![MCP](https://img.shields.io/badge/MCP-Compatible-blue)](https://modelcontextprotocol.io)
  11. MCP server for the [*arr media management suite](https://wiki.servarr.com/) - Sonarr, Radarr, Lidarr, and Prowlarr.
  12. Supports both local `stdio` mode for Claude/Codex-style clients and remote HTTP mode for hosted MCP clients such as ChatGPT connectors.
  13. ## Why Use This?
  14. - **Unified media management** - Control all your *arr applications from one interface
  15. - **Natural language queries** - Ask about your library in plain English
  16. - **Cross-service search** - Find content across TV, movies, and music simultaneously
  17. - **Download monitoring** - Check queue status and progress across all services
  18. - **Calendar integration** - See upcoming releases for all media types
  19. - **Configuration review** - Get AI-powered suggestions for optimizing your setup
  20. - **Flexible configuration** - Enable only the services you use
  21. ## Features
  22. | Category | Capabilities |
  23. |----------|-------------|
  24. | **Sonarr (TV)** | List series, view episodes, search shows, trigger downloads, check queue, view calendar, review setup |
  25. | **Radarr (Movies)** | List movies, search films, trigger downloads, check queue, view releases, review setup |
  26. | **Lidarr (Music)** | List artists, view albums, search musicians, trigger downloads, check queue, view calendar, review setup |
  27. | **Prowlarr (Indexers)** | List indexers, search across all trackers, test health, view statistics |
  28. | **Cross-Service** | Status check, unified search across all configured services |
  29. | **Configuration** | Quality profiles, download clients, naming conventions, health checks, storage info |
  30. | **TRaSH Guides** | Reference quality profiles, custom formats, naming conventions, compare against recommendations |
  31. ## Prerequisites
  32. - 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.
  33. - At least one *arr application running with API access:
  34. - [Sonarr](https://sonarr.tv/) for TV series
  35. - [Radarr](https://radarr.video/) for movies
  36. - [Lidarr](https://lidarr.audio/) for music
  37. - [Prowlarr](https://prowlarr.com/) for indexer management
  38. ## Installation
  39. ### Using npm (Recommended)
  40. ```bash
  41. npx mcp-arr-server
  42. ```
  43. ### Remote HTTP Mode
  44. ```bash
  45. MCP_TRANSPORT=http PORT=3000 npx mcp-arr-server
  46. ```
  47. By default the remote server listens on `127.0.0.1:3000` and serves MCP on `/mcp`.
  48. Environment variables for remote mode:
  49. - `MCP_TRANSPORT=http` to enable remote Streamable HTTP transport
  50. - `HOST` to override the bind host (default `127.0.0.1`)
  51. - `PORT` to override the port (default `3000`)
  52. - `MCP_PATH` to override the MCP endpoint path (default `/mcp`)
  53. ### Docker
  54. Prebuilt images are published to GitHub Container Registry on every release. You do not need to
  55. build anything:
  56. ```bash
  57. docker pull ghcr.io/aplaceforallmystuff/mcp-arr:latest
  58. ```
  59. Tags follow the release version — `latest`, `1`, `1.7`, and each exact version such as `1.7.3`.
  60. Pin to a major or minor tag if you want updates without surprises.
  61. Run in local stdio mode:
  62. ```bash
  63. docker run --rm -i \
  64. -e SONARR_URL=http://host.docker.internal:8989 \
  65. -e SONARR_API_KEY=your-sonarr-api-key \
  66. ghcr.io/aplaceforallmystuff/mcp-arr:latest
  67. ```
  68. Run in remote HTTP mode:
  69. ```bash
  70. docker run --rm -p 3000:3000 \
  71. -e MCP_TRANSPORT=http \
  72. -e HOST=0.0.0.0 \
  73. -e PORT=3000 \
  74. -e SONARR_URL=http://host.docker.internal:8989 \
  75. -e SONARR_API_KEY=your-sonarr-api-key \
  76. ghcr.io/aplaceforallmystuff/mcp-arr:latest
  77. ```
  78. Minimal `docker-compose.yml`:
  79. ```yaml
  80. services:
  81. mcp-arr:
  82. image: ghcr.io/aplaceforallmystuff/mcp-arr:latest
  83. ports:
  84. - "3000:3000"
  85. environment:
  86. MCP_TRANSPORT: http
  87. HOST: 0.0.0.0
  88. PORT: 3000
  89. SONARR_URL: http://host.docker.internal:8989
  90. SONARR_API_KEY: your-sonarr-api-key
  91. RADARR_URL: http://host.docker.internal:7878
  92. RADARR_API_KEY: your-radarr-api-key
  93. ```
  94. #### Building it yourself
  95. Only needed if you are developing against a change that is not released yet:
  96. ```bash
  97. docker build -t mcp-arr .
  98. ```
  99. ### From Source
  100. ```bash
  101. git clone https://github.com/aplaceforallmystuff/mcp-arr.git
  102. cd mcp-arr
  103. npm install
  104. npm run build
  105. ```
  106. ## Configuration
  107. ### Getting API Keys
  108. Each *arr application has an API key in Settings > General > Security:
  109. 1. Open your *arr application's web interface
  110. 2. Go to **Settings** > **General**
  111. 3. Find the **API Key** under the Security section
  112. 4. Copy the API key for use in configuration
  113. ### For Claude Desktop
  114. Add to your Claude Desktop config file:
  115. **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
  116. **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
  117. ```json
  118. {
  119. "mcpServers": {
  120. "arr": {
  121. "command": "npx",
  122. "args": ["-y", "mcp-arr-server"],
  123. "env": {
  124. "SONARR_URL": "http://localhost:8989",
  125. "SONARR_API_KEY": "your-sonarr-api-key",
  126. "RADARR_URL": "http://localhost:7878",
  127. "RADARR_API_KEY": "your-radarr-api-key",
  128. "LIDARR_URL": "http://localhost:8686",
  129. "LIDARR_API_KEY": "your-lidarr-api-key",
  130. "PROWLARR_URL": "http://localhost:9696",
  131. "PROWLARR_API_KEY": "your-prowlarr-api-key"
  132. }
  133. }
  134. }
  135. }
  136. ```
  137. ### For Claude Code
  138. Add to `~/.claude.json`:
  139. ```json
  140. {
  141. "mcpServers": {
  142. "arr": {
  143. "command": "npx",
  144. "args": ["-y", "mcp-arr-server"],
  145. "env": {
  146. "SONARR_URL": "http://localhost:8989",
  147. "SONARR_API_KEY": "your-sonarr-api-key",
  148. "RADARR_URL": "http://localhost:7878",
  149. "RADARR_API_KEY": "your-radarr-api-key"
  150. }
  151. }
  152. }
  153. }
  154. ```
  155. **Note**: Only configure the services you have running. The server automatically detects which services are available based on the environment variables you provide.
  156. **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`.
  157. **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`.
  158. ## ChatGPT / Remote MCP
  159. To use `mcp-arr` with ChatGPT, run the server in remote HTTP mode on a reachable host and connect ChatGPT to the `/mcp` endpoint.
  160. The server now exposes the generic `search` and `fetch` tools expected by ChatGPT-style remote MCP integrations:
  161. - `search` discovers matching *arr media and TRaSH profiles
  162. - `fetch` returns structured detail for a selected search result
  163. The existing service-specific tools remain available for richer local or power-user workflows.
  164. ## Usage Examples
  165. ### Library Management
  166. - "Show me all my TV series"
  167. - "What movies do I have in Radarr?"
  168. - "List all artists in my music library"
  169. ### Searching & Adding Content
  170. - "Search for sci-fi shows on Sonarr"
  171. - "Find action movies from the 90s"
  172. - "Add this show to my TV library"
  173. - "Add that movie to Radarr"
  174. - "Search for jazz albums and add this artist"
  175. - "Add this movie with my '4k' tag"
  176. - "What tags do I have in Sonarr?"
  177. ### Download Queue
  178. - "What's downloading right now?"
  179. - "Check the Sonarr queue"
  180. - "Show Radarr download progress"
  181. ### Upcoming Releases
  182. - "What TV episodes are coming this week?"
  183. - "Show upcoming movie releases"
  184. - "Any new albums coming out this month?"
  185. ### Downloading Content
  186. - "What episodes of this show am I missing?"
  187. - "Download the missing episodes for that series"
  188. - "Search for this specific movie"
  189. - "Grab that album I'm missing"
  190. ### Indexer Management
  191. - "Are my indexers healthy?"
  192. - "How are my indexers performing?"
  193. - "Test all my Prowlarr indexers"
  194. ### Configuration Review
  195. - "Review my Sonarr setup and suggest improvements"
  196. - "Show me my quality profiles in Radarr"
  197. - "Are there any health issues with my Lidarr?"
  198. - "What naming convention am I using for TV shows?"
  199. - "Help me understand my quality profiles - why am I not getting 4K?"
  200. - "Check my download client configuration"
  201. - "How much free space do I have on my root folders?"
  202. ### Cross-Service
  203. - "Check status of all my *arr services"
  204. - "Search for 'comedy' across all services"
  205. ## Available Tools
  206. ### Radarr manual import
  207. 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.
  208. 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.
  209. ### Exact release grabs
  210. 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.
  211. 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.
  212. ### Release inspection
  213. 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.
  214. ### Queue diagnostics
  215. 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.
  216. ### Add Sonarr and Radarr file metadata tools
  217. 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.
  218. - `sonarr_get_episode_files`
  219. - `radarr_get_movie_files`
  220. ### General Tools
  221. | Tool | Description |
  222. |------|-------------|
  223. | `arr_status` | Get connection status for all configured *arr services |
  224. | `arr_search_all` | Search across all configured services simultaneously |
  225. | `search` | Generic discovery tool for remote MCP clients such as ChatGPT |
  226. | `fetch` | Generic detail-fetch tool for items returned by `search` |
  227. ### Sonarr Tools (TV)
  228. | Tool | Description |
  229. |------|-------------|
  230. | `sonarr_get_series` | List TV series in your library, optionally sorted by date added or size on disk |
  231. | `sonarr_search` | Search for TV series by name (returns tvdbId for adding) |
  232. | `sonarr_add_series` | Add a TV series to Sonarr (supports tags) |
  233. | `sonarr_get_root_folders` | Get available root folders for adding series |
  234. | `sonarr_get_quality_profiles` | Get available quality profiles for adding series |
  235. | `sonarr_get_queue` | View current download queue with `limit` and `offset` pagination |
  236. | `sonarr_get_calendar` | See upcoming episodes |
  237. | `sonarr_get_episodes` | List episodes for a series (shows missing vs available) |
  238. | `sonarr_search_missing` | Trigger search for all missing episodes in a series |
  239. | `sonarr_search_episode` | Trigger search for specific episode(s) |
  240. | `sonarr_refresh_series` | Trigger a metadata refresh for a specific series in Sonarr |
  241. ### Radarr Tools (Movies)
  242. | Tool | Description |
  243. |------|-------------|
  244. | `radarr_get_movies` | List movies in your library, optionally sorted by date added or size on disk |
  245. | `radarr_search` | Search for movies by name (returns tmdbId for adding) |
  246. | `radarr_add_movie` | Add a movie to Radarr (supports tags) |
  247. | `radarr_get_root_folders` | Get available root folders for adding movies |
  248. | `radarr_get_quality_profiles` | Get available quality profiles for adding movies |
  249. | `radarr_get_queue` | View current download queue with `limit` and `offset` pagination |
  250. | `radarr_get_calendar` | See upcoming releases |
  251. | `radarr_search_movie` | Trigger search to download a movie in your library |
  252. | `radarr_search_movies` | Bulk-trigger searches for multiple movie IDs at once |
  253. | `radarr_update_movie` | Update a movie's quality profile, monitored status, minimum availability, tags, or path |
  254. | `radarr_delete_queue_item` | Remove an item from the download queue (optionally blocklist the release) |
  255. | `radarr_refresh_movie` | Trigger a metadata refresh for a specific movie in Radarr |
  256. ### Lidarr Tools (Music)
  257. | Tool | Description |
  258. |------|-------------|
  259. | `lidarr_get_artists` | List all artists in your library |
  260. | `lidarr_search` | Search for artists by name (returns foreignArtistId for adding) |
  261. | `lidarr_add_artist` | Add an artist to Lidarr (supports tags) |
  262. | `lidarr_get_root_folders` | Get available root folders for adding artists |
  263. | `lidarr_get_quality_profiles` | Get available quality profiles for adding artists |
  264. | `lidarr_get_metadata_profiles` | Get available metadata profiles for adding artists |
  265. | `lidarr_get_queue` | View current download queue with `limit` and `offset` pagination |
  266. | `lidarr_get_albums` | List albums for an artist (shows missing vs available) |
  267. | `lidarr_search_album` | Trigger search for a specific album |
  268. | `lidarr_search_missing` | Trigger search for all missing albums for an artist |
  269. | `lidarr_get_calendar` | See upcoming album releases |
  270. ### Prowlarr Tools (Indexers)
  271. | Tool | Description |
  272. |------|-------------|
  273. | `prowlarr_get_indexers` | List all configured indexers |
  274. | `prowlarr_search` | Search across all indexers |
  275. | `prowlarr_test_indexers` | Test all indexers and return health status |
  276. | `prowlarr_get_stats` | Get indexer statistics (queries, grabs, failures) |
  277. ### Configuration Review Tools
  278. These tools are available for Sonarr, Radarr, and Lidarr. Replace `{service}` with the service name (e.g., `sonarr_get_quality_profiles`).
  279. | Tool | Description |
  280. |------|-------------|
  281. | `{service}_get_quality_profiles` | Detailed quality profile information with allowed qualities and custom format scores |
  282. | `{service}_get_health` | Health check warnings and issues detected by the application |
  283. | `{service}_get_root_folders` | Storage paths, free space, and accessibility status |
  284. | `{service}_get_download_clients` | Download client configurations and settings |
  285. | `{service}_get_naming` | File and folder naming conventions |
  286. | `{service}_get_tags` | Tag definitions for content organization |
  287. | `{service}_review_setup` | **Comprehensive configuration dump for AI-assisted setup analysis** |
  288. 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.
  289. > **⚠️ 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.
  290. ### TRaSH Guides Tools
  291. Access community-curated quality profiles, custom formats, and naming conventions from [TRaSH Guides](https://trash-guides.info/) directly through Claude or ChatGPT. These tools work without any *arr configuration - they fetch reference data from the TRaSH Guides GitHub repository.
  292. | Tool | Description |
  293. |------|-------------|
  294. | `trash_list_profiles` | List available TRaSH quality profiles for Radarr or Sonarr |
  295. | `trash_get_profile` | Get detailed profile with custom formats, scores, and quality settings |
  296. | `trash_list_custom_formats` | List custom formats with optional category filter (hdr, audio, resolution, etc.) |
  297. | `trash_get_naming` | Get recommended naming conventions for Plex, Emby, Jellyfin, or standard |
  298. | `trash_get_quality_sizes` | Get recommended min/max/preferred sizes for each quality level |
  299. | `trash_compare_profile` | Compare your profile against TRaSH recommendations (requires *arr configured) |
  300. | `trash_compare_naming` | Compare your naming config against TRaSH recommendations (requires *arr configured) |
  301. **Example usage:**
  302. - "What quality profiles does TRaSH recommend for 4K movies?"
  303. - "Show me the remux-web-1080p profile details"
  304. - "Compare my Radarr profile 4 against the TRaSH uhd-bluray-web profile"
  305. - "What naming convention should I use for Plex?"
  306. - "List HDR-related custom formats for Radarr"
  307. Data is cached for 1 hour to minimize GitHub API calls.
  308. ## Development
  309. ```bash
  310. # Watch mode for development
  311. npm run watch
  312. # Build TypeScript
  313. npm run build
  314. # Run locally
  315. SONARR_URL="http://localhost:8989" SONARR_API_KEY="your-key" node dist/index.js
  316. ```
  317. ## Troubleshooting
  318. ### "No *arr services configured"
  319. Ensure you have set at least one pair of URL and API_KEY environment variables:
  320. ```bash
  321. SONARR_URL="http://localhost:8989"
  322. SONARR_API_KEY="your-api-key"
  323. ```
  324. ### "API error: 401 Unauthorized"
  325. The API key is incorrect. Verify it in your *arr application under Settings > General > Security.
  326. ### "fetch failed" or "ECONNREFUSED"
  327. The *arr application is not running or the URL is incorrect. Verify:
  328. - The application is running
  329. - The URL and port are correct
  330. - There's no firewall blocking the connection
  331. ### "Sonarr/Radarr/etc not configured"
  332. You tried to use a tool for a service that isn't configured. Add the corresponding URL and API_KEY environment variables.
  333. ### "SONARR_URL must be a full http:// or https:// URL"
  334. 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`.
  335. ### "Invalid arguments for ..."
  336. 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.
  337. ## Need help building or securing MCP servers?
  338. 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](https://jimchristian.net/work/) or book a [discovery session](https://jimchristian.net/discovery/).
  339. ## Contributing
  340. See [CONTRIBUTING.md](CONTRIBUTING.md) for setup, checks, and tool changes.
  341. ## License
  342. MIT - see [LICENSE](LICENSE) for details.
  343. ## Links
  344. - [Servarr Wiki](https://wiki.servarr.com/) - Documentation for all *arr applications
  345. - [TRaSH Guides](https://trash-guides.info/) - Quality profiles, custom formats, and setup guides
  346. - [Sonarr API Docs](https://sonarr.tv/docs/api/)
  347. - [Model Context Protocol](https://modelcontextprotocol.io)
  348. - [GitHub Repository](https://github.com/aplaceforallmystuff/mcp-arr)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.