The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Install
$
npx mcp-arr-serverClaude Code
claude mcp add mcp-arr -- npx mcp-arr-serverCursor / Claude Desktop (mcp.json)
{
"mcpServers": {
"mcp-arr": {
"command": "npx",
"args": [
"mcp-arr-server"
]
}
}
}Install command taken from the project's README or registry entry. Always review code before running it.
README excerpt
Read full README on GitHub →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
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 18+
- At least one *arr application running with API access:
Installation
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=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: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:
Similar plugs
Reverse engineer anything with agents, from app behavior down to native binaries.
Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype…
User-friendly AI Interface (Supports Ollama, OpenAI API, ...)
A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io