Skip to content

arr-mcp

typed, deterministic control surface over Sonarr, Radarr, Lidarr, Prowlarr, Bazarr, Seerr, and Chaptarr.

Official documentation

This site is the canonical reference for arr-mcp, maintained alongside every release.

PyPI MCP Server License GitHub

Overview

arr-mcp wraps the REST surface of the Arr Suite of media-automation services provides:

  • Per-service API clients — request-session facades over Sonarr, Radarr, Lidarr, Prowlarr, Bazarr, Seerr, and Chaptarr, each constructed from the environment.
  • Typed MCP tools — one tool per upstream API operation (radarr_get_queue, seerr_get_request, …), loaded on demand by a fleet gateway.
  • Skills, agent-definition prompts and an ontology — task workflows, operator and role prompts, and the tool-use contracts, data locations and federation of the suite. Agent Control Protocol with an optional web interface.

Each service connector remains inactive when its credentials are absent, so the server runs cleanly with only the integrations the operator configure.

Explore the documentation

  • :material-rocket-start: Installation — pip, source, extras, and the prebuilt Docker image.
  • Usage — the MCP tools, the Python API clients, and the CLI.
  • Backing Platform — provision the Arr Suite services with Docker.
  • Overview — ecosystem role, enterprise readiness, and configuration.
  • Concepts — the CONCEPT:ARR-* registry.

Quick start

pip install "arr-mcp[mcp]"
arr-mcp                          # stdio MCP server (default transport)

Connect it to the operator's Arr Suite services:

export SONARR_BASE_URL=http://localhost:8989
export SONARR_TOKEN=your_sonarr_api_key
arr-mcp --transport streamable-http --host 0.0.0.0 --port 8000

See Installation and Deployment for the proxy, DNS).