# arr-mcp

> arr-mcp is an open-source MCP server for events and entertainment. One self-hosted MCP server for Radarr, Sonarr, Jellyfin, Plex, Seerr and downloaders. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** self-hosted, API, CLI
- **Repository:** https://github.com/bardesss/arr-mcp
- **MCP Registry name:** io.github.bardesss/arr-mcp
- **Categories:** events and entertainment, cloud and infrastructure
- **Listing updated:** 2026-11-14

## About

The idea behind arr-mcp is that the useful questions about a home media setup sit between services. Its headline tool, `diagnose_media`, follows a title through request, monitoring, download, indexing, import and library scan, and names the first step that explains why it is missing. It still answers when one service is down and says which part it could not check.

It runs as a container (images for amd64 and arm64, plus an Unraid template and a Proxmox LXC script). A browser config page, claimed with a username and password on first visit, is where you add each service's URL and key; your MCP client then connects to `/mcp` with a token. Writes are off until you enable them per service, each one is previewed and needs confirmation, and all of them land in an audit trail.

Release names from public indexers are treated as untrusted data and fenced before they reach the model. An optional library event log keeps history after a title is deleted, and quality-profile checks flag settings that cannot do what they say, including profiles synced from TRaSH Guides through Profilarr.

## Features

- **Cross-service diagnosis:** diagnose_media correlates requests, indexers, downloads and the media server to explain a missing title.
- **Covers the whole stack:** Works with Radarr, Sonarr, Lidarr, Prowlarr, Bazarr, Jellyfin, Plex, Seerr, SABnzbd, qBittorrent and more.
- **Opt-in writes:** Writes are off by default, previewed, confirmed and recorded in an audit trail.
- **Indexer text fencing:** Release names from public indexers are fenced so they are treated as data, not instructions.
- **Library event log:** Optionally keeps history that Radarr, Sonarr and Lidarr would lose when a title is deleted.
- **Browser config page:** Add services, see what is broken and read logs without editing YAML.
- **Flexible auth:** Per-token tiers and expiry, with optional OAuth 2.1 access tokens if you run an identity provider.

## Good for

- Find out why a requested film never appeared in Jellyfin
- Check what is downloading and whether anything is stuck
- Spot indexers that are failing and read their errors
- Audit quality profiles for scores nothing can reach
- Ask for missing subtitles or a different release by chat

## Install

### Claude Code (Terminal)

```sh
claude mcp add arr-mcp -- docker run -i --rm ghcr.io/bardesss/arr-mcp:2.2.1
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "arr-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/bardesss/arr-mcp:2.2.1"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "arr-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/bardesss/arr-mcp:2.2.1"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "arr-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/bardesss/arr-mcp:2.2.1"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "arr-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/bardesss/arr-mcp:2.2.1"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "arr-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/bardesss/arr-mcp:2.2.1"
      ]
    }
  }
}
```

## Tools

- `diagnose_media`: Walk the request-to-library chain for a title and name the first thing that explains its absence.
- `get_history`: Return what the stack and the library event log recorded about a title.

## FAQ

### How do I run it?

As a Docker container (ghcr.io/bardesss/arr-mcp), an Unraid template or a Proxmox LXC script. Open port 6060, claim the instance with a password of at least 12 characters, then add your services.

### Can the AI delete or change things?

Only if you turn writes on for a service. Each write shows what it would do, waits for confirmation and is logged.

### Does it work over stdio?

Yes, with --stdio, but that connection is read-only; writes need the HTTP endpoint and a token.

### Where do my API keys live?

In config.yaml under /config. The README warns to claim the instance before exposing the port because it holds every service's keys.

### Is arr-mcp free?

Yes. arr-mcp is open source, so you can use and self-host it for free.

### How do I add arr-mcp to Claude Code?

Run this command in your terminal: claude mcp add arr-mcp -- docker run -i --rm ghcr.io/bardesss/arr-mcp:2.2.1

### What are the best alternatives to arr-mcp?

The closest alternatives to arr-mcp are MaineMCP, Agent Yurt, Agent Bookability Index, Tap2Cal and Proofline.

## Alternatives

- [MaineMCP](https://ai-powered.com/mcp/mainemcp): MaineMCP is a free MCP server for events and entertainment.
- [Agent Yurt](https://ai-powered.com/mcp/agent-yurt): Agent Yurt is a free MCP server for knowledge and memory.
- [Agent Bookability Index](https://ai-powered.com/mcp/agent-bookability-index): Agent Bookability Index is a free MCP server for events and entertainment.
- [Tap2Cal](https://ai-powered.com/mcp/tap2cal): Tap2Cal is a free MCP server for productivity.
- [Proofline](https://ai-powered.com/mcp/proofline): Proofline is a freemium MCP server for developer tools.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [Veseljko katalog usluga za proslave](https://ai-powered.com/mcp/veseljko-katalog-usluga-za-proslave): Veseljko katalog usluga za proslave is a free MCP server for events and entertainment.
- [숏츠생성기 Free K-pop Shorts](https://ai-powered.com/mcp/free-k-pop-shorts): 숏츠생성기 Free K-pop Shorts is a free MCP server for design and media.

---
Source: https://ai-powered.com/mcp/arr-mcp
