Arr Mcp

CLI or API | MCP

Documentation — Installation, deployment, usage across the API, CLI, MCP, and maintained in the official documentation.

---

Table of Contents

• Overview
• Key Features
• Installation
• CLI or API
• MCP
  • Dynamic Tool Selection & Visibility
• Environment Variables
• Security & Governance
• Contribute

---

Overview

Arr Mcp is a production-grade Agent and Model Context Protocol (MCP) server designed to interface directly with Arr Suite MCP Server for Agentic AI!.

---

Key Features

• Consolidated Action-Routed MCP Tools: Minimizes token overhead and eliminates tool bloat in LLM contexts by grouping methods into optimized, togglable tool modules.
• Enterprise-Grade Security: Complete support for Eunomia policies, OIDC token delegation, and granular execution context tracking.
• Native Telemetry & Tracing: Out-of-the-box OpenTelemetry exports and native Langfuse tracing.

---

CLI or API

This agent wraps the Arr Suite MCP Server for Agentic AI! API. The operator can interact with it programmatically or via its integrated execution entrypoints.

Detailed instructions on how to use the underlying API wrappers, extended schema bindings, and developer SDK references are maintained in docs/index.md.

---

MCP

This server use dynamic Action-Routed tools to optimize token overhead and maximize IDE compatibility.

Available MCP Tools

The table below is auto-generated from the live server — do not edit by hand.

Every upstream API operation is one typed tool named <app>_<operation>. No tool routes by action; there is no params_json. Every tool is tagged gated, so a fleet gateway loads it on demand.

App	Tools
Radarr (movies)	239
Sonarr (TV)	237
Lidarr (music)	235
Chaptarr (books, audiobooks)	233
Prowlarr (indexers)	129
Bazarr (subtitles)	84
Seerr (requests)	217
Knowledge graph	1 (arr_ingest_library)

MCP Tool	Description
radarr_add_movie	Lookup a movie by term, pick the first result, and add it to Radarr.
radarr_delete_autotagging_id	Delete autotagging id.
radarr_delete_blocklist_bulk	Delete blocklist bulk.
radarr_delete_blocklist_id	Delete blocklist id.
radarr_delete_command_id	Delete command id.
radarr_delete_customfilter_id	Delete customfilter id.
radarr_delete_customformat_bulk	Delete customformat bulk.
radarr_delete_customformat_id	Delete customformat id.
radarr_delete_delayprofile_id	Delete delayprofile id.
radarr_delete_downloadclient_bulk	Delete downloadclient bulk.
radarr_delete_downloadclient_id	Delete downloadclient id.
radarr_delete_exclusions_bulk	Delete exclusions bulk.
radarr_delete_exclusions_id	Delete exclusions id.
radarr_delete_importlist_bulk	Delete importlist bulk.
radarr_delete_importlist_id	Delete importlist id.
radarr_delete_indexer_bulk	Delete indexer bulk.
radarr_delete_indexer_id	Delete indexer id.
radarr_delete_metadata_id	Delete metadata id.
radarr_delete_movie_editor	Delete movie editor.
radarr_delete_movie_id	Delete movie id.
radarr_delete_moviefile_bulk	Delete moviefile bulk.
radarr_delete_moviefile_id	Delete moviefile id.
radarr_delete_notification_id	Delete notification id.
radarr_delete_qualityprofile_id

MCP Tool	Description
sonarr_add_series	Lookup a series by term, pick the first result, and add it to Sonarr.
sonarr_delete_autotagging_id	Delete an auto-tagging rule by ID.
sonarr_delete_blocklist_bulk	Delete blocklist bulk.
sonarr_delete_blocklist_id	Delete a blocklisted item by ID.
sonarr_delete_command_id	Delete command id.
sonarr_delete_customfilter_id	Delete customfilter id.
sonarr_delete_customformat_bulk	Delete customformat bulk.
sonarr_delete_customformat_id	Delete customformat id.
sonarr_delete_delayprofile_id	Delete delayprofile id.
sonarr_delete_downloadclient_bulk	Delete downloadclient bulk.
sonarr_delete_downloadclient_id	Delete downloadclient id.
sonarr_delete_episodefile_bulk	Delete episodefile bulk.
sonarr_delete_episodefile_id	Delete episodefile id.
sonarr_delete_importlist_bulk	Delete importlist bulk.
sonarr_delete_importlist_id	Delete an import list configuration by ID.
sonarr_delete_importlistexclusion_bulk	Delete importlistexclusion bulk.
sonarr_delete_importlistexclusion_id	Delete importlistexclusion id.
sonarr_delete_indexer_bulk	Delete indexer bulk.
sonarr_delete_indexer_id	Delete an indexer configuration by ID.
sonarr_delete_languageprofile_id	Delete languageprofile id.
sonarr_delete_metadata_id	Delete metadata id.
sonarr_delete_notification_id	Delete notification id.
sonarr_delete_qualityprofile_id

MCP Tool	Description
lidarr_delete_album_id	Delete an album and optionally its files and add exclusion.
lidarr_delete_artist_editor	Delete multiple artists using the artist editor.
lidarr_delete_artist_id	Delete artist id.
lidarr_delete_autotagging_id	Delete autotagging id.
lidarr_delete_blocklist_bulk	Delete blocklist bulk.
lidarr_delete_blocklist_id	Delete blocklist id.
lidarr_delete_command_id	Delete command id.
lidarr_delete_customfilter_id	Delete customfilter id.
lidarr_delete_customformat_bulk	Delete customformat bulk.
lidarr_delete_customformat_id	Delete customformat id.
lidarr_delete_delayprofile_id	Delete delayprofile id.
lidarr_delete_downloadclient_bulk	Delete downloadclient bulk.
lidarr_delete_downloadclient_id	Delete downloadclient id.
lidarr_delete_importlist_bulk	Delete multiple import lists in bulk.
lidarr_delete_importlist_id	Delete an import list configuration.
lidarr_delete_importlistexclusion_id	Delete importlistexclusion id.
lidarr_delete_indexer_bulk	Delete indexer bulk.
lidarr_delete_indexer_id	Delete an indexer configuration by ID.
lidarr_delete_metadata_id	Delete metadata id.
lidarr_delete_metadataprofile_id	Delete metadataprofile id.
lidarr_delete_notification_id	Delete notification id.
lidarr_delete_qualityprofile_id	Delete qualityprofile id.
lidarr_delete_queue_bulk

MCP Tool	Description
chaptarr_delete_author_editor	Delete author editor.
chaptarr_delete_author_id	Delete an author by ID.
chaptarr_delete_blocklist_bulk	Delete blocklist bulk.
chaptarr_delete_blocklist_id	Delete blocklist id.
chaptarr_delete_book_editor	Delete book editor.
chaptarr_delete_book_id	Delete book id.
chaptarr_delete_bookfile_bulk	Delete bookfile bulk.
chaptarr_delete_bookfile_id	Delete bookfile id.
chaptarr_delete_command_id	Delete command id.
chaptarr_delete_customfilter_id	Delete customfilter id.
chaptarr_delete_customformat_id	Delete customformat id.
chaptarr_delete_delayprofile_id	Delete delayprofile id.
chaptarr_delete_downloadclient_bulk	Delete downloadclient bulk.
chaptarr_delete_downloadclient_id	Delete downloadclient id.
chaptarr_delete_importlist_bulk	Delete importlist bulk.
chaptarr_delete_importlist_id	Delete importlist id.
chaptarr_delete_importlistexclusion_id	Delete importlistexclusion id.
chaptarr_delete_indexer_bulk	Delete indexer bulk.
chaptarr_delete_indexer_id	Delete indexer id.
chaptarr_delete_metadata_id	Delete metadata id.
chaptarr_delete_metadataprofile_id	Delete metadataprofile id.
chaptarr_delete_notification_id	Delete notification id.
chaptarr_delete_qualityprofile_id	Delete qualityprofile id.

MCP Tool	Description
prowlarr_delete_applications_bulk	Delete applications bulk.
prowlarr_delete_applications_id	Delete an application configuration.
prowlarr_delete_appprofile_id	Delete appprofile id.
prowlarr_delete_command_id	Delete command id.
prowlarr_delete_customfilter_id	Delete customfilter id.
prowlarr_delete_downloadclient_bulk	Delete downloadclient bulk.
prowlarr_delete_downloadclient_id	Delete downloadclient id.
prowlarr_delete_indexer_bulk	Delete indexer bulk.
prowlarr_delete_indexer_id	Delete indexer id.
prowlarr_delete_indexerproxy_id	Delete indexerproxy id.
prowlarr_delete_notification_id	Delete notification id.
prowlarr_delete_system_backup_id	Delete system backup id.
prowlarr_delete_tag_id	Delete tag id.
prowlarr_get_	Get .
prowlarr_get_api	Get the base API information.
prowlarr_get_applications	Get all applications managed by Prowlarr.
prowlarr_get_applications_id	Get details for a specific application by ID.
prowlarr_get_applications_schema	Get applications schema.
prowlarr_get_appprofile	Get appprofile.
prowlarr_get_appprofile_id	Get specific appprofile.
prowlarr_get_appprofile_schema	Get appprofile schema.
prowlarr_get_command	Get command.
prowlarr_get_command_id	Get specific command.
prowlarr_get_config_development

MCP Tool	Description
bazarr_delete_episodes_blacklist	Delete an episodes subtitles from blacklist
bazarr_delete_episodes_subtitles	Delete an episode subtitles
bazarr_delete_movies_blacklist	Delete a movies subtitles from blacklist
bazarr_delete_movies_subtitles	Delete a movie subtitles
bazarr_delete_system_backups	Delete a backup file
bazarr_delete_system_jobs	Delete a job from the queue
bazarr_delete_system_logs	Force log rotation and create a new log file
bazarr_get_badges	Get badges count to update the UI
bazarr_get_browse_bazarr_fs	List Bazarr file system content
bazarr_get_browse_radarr_fs	List Radarr file system content
bazarr_get_browse_sonarr_fs	List Sonarr file system content
bazarr_get_episodes	List episodes metadata for specific series or episodes
bazarr_get_episodes_blacklist	List blacklisted episodes subtitles
bazarr_get_episodes_history	List episodes history events
bazarr_get_episodes_wanted	List episodes wanted subtitles
bazarr_get_history_stats	Get history statistics
bazarr_get_jellyfin_libraries	List available movie and series libraries from the Jellyfin server
bazarr_get_languages	List languages for history filter or for language filter menu
bazarr_get_languages_profiles	List languages profiles
bazarr_get_movies	List movies metadata for specific movies
bazarr_get_movies_blacklist	List blacklisted movies subtitles
bazarr_get_movies_history

MCP Tool	Description
seerr_delete_blacklist_tmdb_id	Remove media from blocklist
seerr_delete_blocklist_collection_id	Remove collection from blocklist
seerr_delete_blocklist_tmdb_id	Remove media from blocklist
seerr_delete_issue_comment_comment_id	Delete issue comment
seerr_delete_issue_id	Delete issue
seerr_delete_media_id	Delete media item
seerr_delete_media_id_file	Delete media file
seerr_delete_override_rule_rule_id	Delete override rule by ID
seerr_delete_request_id	Delete request
seerr_delete_settings_discover_slider_id	Delete slider by ID
seerr_delete_settings_radarr_id	Delete Radarr instance
seerr_delete_settings_sonarr_id	Delete Sonarr instance
seerr_delete_user_id	Delete user by ID
seerr_delete_user_id_push_subscription_endpoint	Delete user push subscription by key
seerr_delete_user_id_settings_linked_accounts_jellyfin	Remove the linked Jellyfin account for a user
seerr_delete_user_id_settings_linked_accounts_plex	Remove the linked Plex account for a user
seerr_delete_watchlist_tmdb_id	Delete watchlist item
seerr_get_auth_jellyfin_quickconnect_check	Check Quick Connect authorization status
seerr_get_auth_me	Get logged-in user
seerr_get_backdrops	Get backdrops of trending items
seerr_get_blacklist	Returns blocklisted items
seerr_get_blacklist_tmdb_id	Get media from blocklist
seerr_get_blocklist

1375 tools in all.

Detailed tool schemas, parameter shapes, and validation constraints are preserved in docs/index.md#mcp-tools.

Dynamic Tool Selection & Visibility

This MCP server supports dynamic toolset selection and visibility filtering at runtime. This allows the operator to restrict the set of exposed tools to prevent blowing up the LLM's context window.

The operator can configure tool filtering via multiple input channels:

• CLI Arguments: Pass --tools or --toolsets (or their disabled counterparts --disabled-tools and --disabled-toolsets) during startup.
• Environment Variables: Define standard environment variables:
  • MCP_ENABLED_TOOLS / MCP_DISABLED_TOOLS
  • MCP_ENABLED_TAGS / MCP_DISABLED_TAGS
• HTTP SSE Request Headers: Pass custom headers during transport initialization:
  • x-mcp-enabled-tools / x-mcp-disabled-tools
  • x-mcp-enabled-tags / x-mcp-disabled-tags
• HTTP SSE Request Query Parameters: Append query parameters directly to the operator's transport connection URL:
  • ?tools=tool1,tool2
  • ?tags=tag1

When query strings or parameters are provided, an LLM-free Knowledge Graph resolution layer (using DynamicToolOrchestrator) matches query intents against known tool tags, names, or descriptions, with safe fallback and automated 24-hour background cache refreshing.

---

MCP Configuration Examples

Install the connector-focused [mcp] extra. Examples use arr-mcp[mcp] to add FastMCP / FastAPI through scion-sdk; the required Scion SDK core still carries epistemic-graph[full]. The [agent-runtime] extra additionally enables model orchestration.

stdio Transport (local IDEs — Cursor, Claude Desktop, VS Code)

{
  "mcpServers": {
    "arr-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "arr-mcp[mcp]",
        "arr-mcp"
      ],
      "env": {
        "MCP_TOOL_MODE": "intent",
        "BAZARRTOOL": "True",
        "BAZARR_API_KEY": "your_bazarr_api_key_here",
        "BAZARR_BASE_URL": "http://localhost:6767",
        "CHAPTARRTOOL": "True",
        "CHAPTARR_BASE_URL": "http://localhost:8006",
        "CHAPTARR_TOKEN": "your_chaptarr_token_here",
        "LIDARRTOOL": "True",
        "LIDARR_BASE_URL": "http://localhost:8686",
        "LIDARR_TOKEN": "your_lidarr_token_here",
        "PROWLARRTOOL": "True",
        "PROWLARR_BASE_URL": "http://localhost:9696",
        "PROWLARR_TOKEN": "your_prowlarr_token_here",
        "RADARRTOOL": "True",
        "RADARR_BASE_URL": "http://localhost:7878",
        "RADARR_TOKEN": "your_radarr_token_here",
        "SEERRTOOL": "True",
        "SEERR_API_KEY": "your_seerr_api_key_here",
        "SEERR_BASE_URL": "http://localhost:5055",
        "SONARRTOOL": "True",
        "SONARR_BASE_URL": "http://localhost:8989",
        "SONARR_TOKEN": "your_sonarr_token_here"
      }
    }
  }
}

Runtime references require an alias-aware launcher such as Arbora. Other launchers must omit those entries and inject the resolved values through their own runtime secret boundary.

Streamable-HTTP Transport (networked / production)

{
  "mcpServers": {
    "arr-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "arr-mcp[mcp]",
        "arr-mcp",
        "--transport",
        "streamable-http",
        "--port",
        "8000"
      ],
      "env": {
        "TRANSPORT": "streamable-http",
        "HOST": "127.0.0.1",
        "PORT": "8000",
        "MCP_TOOL_MODE": "intent",
        "BAZARRTOOL": "True",
        "BAZARR_API_KEY": "your_bazarr_api_key_here",
        "BAZARR_BASE_URL": "http://localhost:6767",
        "CHAPTARRTOOL": "True",
        "CHAPTARR_BASE_URL": "http://localhost:8006",
        "CHAPTARR_TOKEN": "your_chaptarr_token_here",
        "LIDARRTOOL": "True",
        "LIDARR_BASE_URL": "http://localhost:8686",
        "LIDARR_TOKEN": "your_lidarr_token_here",
        "PROWLARRTOOL": "True",
        "PROWLARR_BASE_URL": "http://localhost:9696",
        "PROWLARR_TOKEN": "your_prowlarr_token_here",
        "RADARRTOOL": "True",
        "RADARR_BASE_URL": "http://localhost:7878",
        "RADARR_TOKEN": "your_radarr_token_here",
        "SEERRTOOL": "True",
        "SEERR_API_KEY": "your_seerr_api_key_here",
        "SEERR_BASE_URL": "http://localhost:5055",
        "SONARRTOOL": "True",
        "SONARR_BASE_URL": "http://localhost:8989",
        "SONARR_TOKEN": "your_sonarr_token_here"
      }
    }
  }
}

Alternatively, connect to a pre-deployed Streamable-HTTP instance by url:

{
  "mcpServers": {
    "arr-mcp": {
      "url": "http://localhost:8000/arr-mcp/mcp"
    }
  }
}

Run a reviewed container image as a least-privilege stdio child (no listener or published port):

docker run -i --rm \
  --read-only \
  --cap-drop=ALL \
  --security-opt=no-new-privileges \
  --pids-limit=256 \
  --tmpfs /tmp:rw,noexec,nosuid,nodev,size=64m \
  -e TRANSPORT=stdio \
  -e MCP_TOOL_MODE=intent \
  -e BAZARRTOOL=True \
  -e BAZARR_API_KEY=your_bazarr_api_key_here \
  -e BAZARR_BASE_URL=http://localhost:6767 \
  -e CHAPTARRTOOL=True \
  -e CHAPTARR_BASE_URL=http://localhost:8006 \
  -e CHAPTARR_TOKEN=your_chaptarr_token_here \
  -e LIDARRTOOL=True \
  -e LIDARR_BASE_URL=http://localhost:8686 \
  -e LIDARR_TOKEN=your_lidarr_token_here \
  -e PROWLARRTOOL=True \
  -e PROWLARR_BASE_URL=http://localhost:9696 \
  -e PROWLARR_TOKEN=your_prowlarr_token_here \
  -e RADARRTOOL=True \
  -e RADARR_BASE_URL=http://localhost:7878 \
  -e RADARR_TOKEN=your_radarr_token_here \
  -e SEERRTOOL=True \
  -e SEERR_API_KEY=your_seerr_api_key_here \
  -e SEERR_BASE_URL=http://localhost:5055 \
  -e SONARRTOOL=True \
  -e SONARR_BASE_URL=http://localhost:8989 \
  -e SONARR_TOKEN=your_sonarr_token_here \
  registry.example.invalid/arr-mcp@sha256:<digest> arr-mcp

For containerized network HTTP, supply an authenticated TLS ingress (or direct server TLS), exact MCP_ALLOWED_HOSTS, and an exact trusted-proxy CIDR policy through the operator-owned deployment profile. The generator does not emit an unauthenticated non-loopback listener.

Auto-generated from the code-read env surface (MCP_TOOL_MODE + package vars) — do not edit.

Additional Deployment Options

arr-mcp can run as a local stdio process or container, or behind a remote network boundary. The Deployment guide carries the detailed transport contract.

• Local container — launch a reviewed immutable image as a least-privilege stdio child with no listener or published port.
• Remote URL — connect through an operator-supplied authenticated HTTPS ingress. Keep its URL, outbound identity references, trust profile, and exact MCP_ALLOWED_HOSTS in AgentConfig.

Agent

Set credentials

export SONARR_BASE_URL="http://localhost:8989" export SONARR_TOKEN="your_value" export RADARR_BASE_URL="http://localhost:7878" export RADARR_TOKEN="your_value"

Connector-focused MCP server (includes the shared graph engine)

uv pip install "arr-mcp[mcp]"

Everything (development)

uv pip install "arr-mcp[all]" # or: python -m pip install "arr-mcp[all]"

### Container images (`:mcp`)

One multi-stage `docker/Dockerfile` builds the MCP-only image (`--target mcp`):

| Image tag | Build target | Contents | Entrypoint |
|-----------|--------------|----------|------------|
| `example/arr-mcp:mcp` | `--target mcp` | `arr-mcp[mcp]` — **connector-focused**, includes `epistemic-graph[full]`; no model-orchestration stack | `arr-mcp` |

```bash
docker build --target mcp   -t example/arr-mcp:mcp    docker/   # connector-focused MCP server

agent (immutable agent digest) with a co-located :mcp sidecar.

Knowledge-graph database (epistemic-graph)

Scion SDK core dependency (epistemic-graph[full]). The [mcp] extra keeps deployments can use the bundled engine. For production or shared state, run epistemic-graph as a dedicated database service and configure the runtime to use it. Deployment recipes (single-node + Raft HA), connection configuration, and architecture diagrams are documented in the epistemic-graph deployment guide.

---

Usage & Quick Start

To start and run arr-mcp services:

1. Starting the MCP Server

Start the MCP server in standard I/O mode (ideal for IDEs):

arr-mcp

Or start it as a Streamable-HTTP server on port 8000:

arr-mcp --transport streamable-http --port 8000