Arr Mcp

Arr Mcp

CLI or API | MCP | Agent

Version: 1.0.1

> Documentation — Installation, deployment, usage across the API, CLI, MCP, and > A2A agent interfaces, and guidance for provisioning the Arr Suite services are > maintained in the official documentation.

---

Table of Contents

• [Overview](#overview)
• [Key Features](#key-features)
• [Installation](#installation)
• [CLI or API](#cli-or-api)
• [MCP](#mcp)
• [Dynamic Tool Selection & Visibility](#dynamic-tool-selection--visibility)
• [Agent](#agent)
• [Environment Variables](#environment-variables)
• [Security & Governance](#security--governance)
• [Contribute](#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: Comprehensive support for Eunomia policies, OIDC token delegation, and granular execution context tracking.
• Integrated Graph Agent: Built-in Pydantic AI agent supporting the Agent Control Protocol (ACP) and standard Web interfaces (AG-UI).
• 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. You 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](docs/index.md).

---

MCP

This server utilizes 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.

Condensed action-routed tools (default — MCP_TOOL_MODE=condensed)

| MCP Tool | Toggle Env Var | Description | |----------|----------------|-------------| | bazarr_action | BAZARRTOOL | Execute any Bazarr API action. | | chaptarr_action | CHAPTARRTOOL | Execute any Chaptarr API action. | | lidarr_action | LIDARRTOOL | Execute any Lidarr API action. | | prowlarr_action | PROWLARRTOOL | Execute any Prowlarr API action. | | radarr_action | RADARRTOOL | Execute any Radarr API action. | | seerr_action | SEERRTOOL | Execute any Seerr API action. | | sonarr_action | SONARRTOOL | Execute any Sonarr API action. |

Verbose 1:1 API-mapped tools (MCP_TOOL_MODE=verbose or both)

1123 per-operation tools — one per public API method (click to expand)

| MCP Tool | Toggle Env Var | Description | |----------|----------------|-------------| | bazarr_add_to_blacklist | APITOOL | Add a subtitle to blacklist. | | bazarr_download_movie_subtitle | APITOOL | Download a subtitle for a movie. | | bazarr_download_series_subtitle | APITOOL | Download a subtitle for an episode. | | bazarr_get_blacklist | APITOOL | Get blacklisted subtitles. | | bazarr_get_enabled_languages | APITOOL | Get currently enabled subtitle languages. | | bazarr_get_enabled_providers | APITOOL | Get enabled subtitle providers. | | bazarr_get_episode_subtitles | APITOOL | Get subtitle information for a specific episode. | | bazarr_get_history | APITOOL | Get subtitle download history. | | bazarr_get_languages | APITOOL | Get all available subtitle languages. | | bazarr_get_movie_subtitles | APITOOL | Get subtitle information for a specific movie. | | bazarr_get_movies | APITOOL | Get all movies managed by Bazarr. | | bazarr_get_providers | APITOOL | Get all subtitle providers. | | bazarr_get_series | APITOOL | Get all series managed by Bazarr. | | bazarr_get_series_subtitles | APITOOL | Get subtitle information for a specific series. | | bazarr_get_settings | APITOOL | Get Bazarr settings. | | bazarr_get_system_health | APITOOL | Get system health issues. | | bazarr_get_system_logs | APITOOL | Get system logs. | | bazarr_get_system_status | APITOOL | Get Bazarr system status. | | bazarr_get_wanted_movies | APITOOL | Get movies with wanted/missing subtitles. | | bazarr_get_wanted_series | APITOOL | Get series episodes with wanted/missing subtitles. | | bazarr_remove_from_blacklist | APITOOL | Remove a subtitle from blacklist. | | bazarr_request | APITOOL | Generic request method for the Bazarr API. | | bazarr_search_movie_subtitles | APITOOL | Search for subtitles for a movie. | | bazarr_search_series_subtitles | APITOOL | Search for subtitles for a series or episode. | | bazarr_test_provider | APITOOL | Test a subtitle provider. | | bazarr_update_settings | APITOOL | Update Bazarr settings. | | chaptarr_delete_author_editor | APITOOL | Delete author editor. | | chaptarr_delete_author_id | APITOOL | Delete an author by ID. | | chaptarr_delete_blocklist_bulk | APITOOL | Delete blocklist bulk. | | chaptarr_delete_blocklist_id | APITOOL | Delete blocklist id. | | chaptarr_delete_book_editor | APITOOL | Delete book editor. | | chaptarr_delete_book_id | APITOOL | Delete book id. | | chaptarr_delete_bookfile_bulk | APITOOL | Delete bookfile bulk. | | chaptarr_delete_bookfile_id | APITOOL | Delete bookfile id. | | chaptarr_delete_command_id | APITOOL | Delete command id. | | chaptarr_delete_customfilter_id | APITOOL | Delete customfilter id. | | chaptarr_delete_customformat_id | APITOOL | Delete customformat id. | | chaptarr_delete_delayprofile_id | APITOOL | Delete delayprofile id. | | chaptarr_delete_downloadclient_bulk | APITOOL | Delete downloadclient bulk. | | chaptarr_delete_downloadclient_id | APITOOL | Delete downloadclient id. | | chaptarr_delete_importlist_bulk | APITOOL | Delete importlist bulk. | | chaptarr_delete_importlist_id | APITOOL | Delete importlist id. | | chaptarr_delete_importlistexclusion_id | APITOOL | Delete importlistexclusion id. | | chaptarr_delete_indexer_bulk | APITOOL | Delete indexer bulk. | | chaptarr_delete_indexer_id | APITOOL | Delete indexer id. | | chaptarr_delete_metadata_id | APITOOL | Delete metadata id. | | chaptarr_delete_metadataprofile_id | APITOOL | Delete metadataprofile id. | | chaptarr_delete_notification_id | APITOOL | Delete notification id. | | chaptarr_delete_qualityprofile_id | APITOOL | Delete qualityprofile id. | | chaptarr_delete_queue_bulk | APITOOL | Delete queue bulk. | | chaptarr_delete_queue_id | APITOOL | Delete queue id. | | chaptarr_delete_releaseprofile_id | APITOOL | Delete releaseprofile id. | | chaptarr_delete_remotepathmapping_id | APITOOL | Delete remotepathmapping id. | | chaptarr_delete_rootfolder_id | APITOOL | Delete rootfolder id. | | chaptarr_delete_system_backup_id | APITOOL | Delete system backup id. | | chaptarr_delete_tag_id | APITOOL | Delete tag id. | | chaptarr_get_ | APITOOL | Get . | | chaptarr_get_api | APITOOL | Get the base API information. | | chaptarr_get_author | APITOOL | Get all authors managed by Chaptarr. | | chaptarr_get_author_id | APITOOL | Get specific author. | | chaptarr_get_author_lookup | APITOOL | Get author lookup. | | chaptarr_get_blocklist | APITOOL | Get blocklist. | | chaptarr_get_book | APITOOL | Get book. | | chaptarr_get_book_id | APITOOL | Get specific book. | | chaptarr_get_book_id_overview | APITOOL | Get specific book overview. | | chaptarr_get_book_lookup | APITOOL | Get book lookup. | | chaptarr_get_bookfile | APITOOL | Get bookfile. | | chaptarr_get_bookfile_id | APITOOL | Get specific bookfile. | | chaptarr_get_calendar | APITOOL | Get calendar. | | chaptarr_get_calendar_id | APITOOL | Get specific calendar. | | chaptarr_get_command | APITOOL | Get command. | | chaptarr_get_command_id | APITOOL | Get specific command. | | chaptarr_get_config_development | APITOOL | Get config development. | | chaptarr_get_config_development_id | APITOOL | Get specific config development. | | chaptarr_get_config_downloadclient | APITOOL | Get config downloadclient. | | chaptarr_get_config_downloadclient_id | APITOOL | Get specific config downloadclient. | | chaptarr_get_config_host | APITOOL | Get config host. | | chaptarr_get_config_host_id | APITOOL | Get specific config host. | | chaptarr_get_config_indexer | APITOOL | Get config indexer. | | chaptarr_get_config_indexer_id | APITOOL | Get specific config indexer. | | chaptarr_get_config_mediamanagement | APITOOL | Get config mediamanagement. | | chaptarr_get_config_mediamanagement_id | APITOOL | Get specific config mediamanagement. | | chaptarr_get_config_metadataprovider | APITOOL | Get config metadataprovider. | | chaptarr_get_config_metadataprovider_id | APITOOL | Get specific config metadataprovider. | | chaptarr_get_config_naming | APITOOL | Get config naming. | | chaptarr_get_config_naming_examples | APITOOL | Get config naming examples. | | chaptarr_get_config_naming_id | APITOOL | Get specific config naming. | | chaptarr_get_config_ui | APITOOL | Get config ui. | | chaptarr_get_config_ui_id | APITOOL | Get specific config ui. | | chaptarr_get_content_path | APITOOL | Get content path. | | chaptarr_get_customfilter | APITOOL | Get customfilter. | | chaptarr_get_customfilter_id | APITOOL | Get specific customfilter. | | chaptarr_get_customformat | APITOOL | Get customformat. | | chaptarr_get_customformat_id | APITOOL | Get specific customformat. | | chaptarr_get_customformat_schema | APITOOL | Get customformat schema. | | chaptarr_get_delayprofile | APITOOL | Get delayprofile. | | chaptarr_get_delayprofile_id | APITOOL | Get specific delayprofile. | | chaptarr_get_diskspace | APITOOL | Get diskspace. | | chaptarr_get_downloadclient | APITOOL | Get downloadclient. | | chaptarr_get_downloadclient_id | APITOOL | Get specific downloadclient. | | chaptarr_get_downloadclient_schema | APITOOL | Get downloadclient schema. | | chaptarr_get_edition | APITOOL | Get edition. | | chaptarr_get_feed_v1_calendar_readarrics | APITOOL | Get feed v1 calendar readarrics. | | chaptarr_get_filesystem | APITOOL | Get filesystem. | | chaptarr_get_filesystem_mediafiles | APITOOL | Get filesystem mediafiles. | | chaptarr_get_filesystem_type | APITOOL | Get filesystem type. | | chaptarr_get_health | APITOOL | Get health. | | chaptarr_get_history | APITOOL | Get history. | | chaptarr_get_history_author | APITOOL | Get history author. | | chaptarr_get_history_since | APITOOL | Get history since. | | chaptarr_get_importlist | APITOOL | Get importlist. | | chaptarr_get_importlist_id | APITOOL | Get specific importlist. | | chaptarr_get_importlist_schema | APITOOL | Get importlist schema. | | chaptarr_get_importlistexclusion | APITOOL | Get importlistexclusion. | | chaptarr_get_importlistexclusion_id | APITOOL | Get specific importlistexclusion. | | chaptarr_get_indexer | APITOOL | Get indexer. | | chaptarr_get_indexer_id | APITOOL | Get specific indexer. | | chaptarr_get_indexer_schema | APITOOL | Get indexer schema. | | chaptarr_get_indexerflag | APITOOL | Get indexerflag. | | chaptarr_get_language | APITOOL | Get language. | | chaptarr_get_language_id | APITOOL | Get specific language. | | chaptarr_get_localization | APITOOL | Get localization. | | chaptarr_get_log | APITOOL | Get log. | | chaptarr_get_log_file | APITOOL | Get log file. | | chaptarr_get_log_file_filename | APITOOL | Get log file filename. | | chaptarr_get_log_file_update | APITOOL | Get log file update. | | chaptarr_get_log_file_update_filename | APITOOL | Get log file update filename. | | chaptarr_get_login | APITOOL | Get the login status or page. | | chaptarr_get_logout | APITOOL | Log out from the Chaptarr instance. | | chaptarr_get_manualimport | APITOOL | Get manualimport. | | chaptarr_get_mediacover_author_author_id_filename | APITOOL | Get specific mediacover author author filename. | | chaptarr_get_mediacover_book_book_id_filename | APITOOL | Get specific mediacover book book filename. | | chaptarr_get_metadata | APITOOL | Get metadata. | | chaptarr_get_metadata_id | APITOOL | Get specific metadata. | | chaptarr_get_metadata_schema | APITOOL | Get metadata schema. | | chaptarr_get_metadataprofile | APITOOL | Get metadataprofile. | | chaptarr_get_metadataprofile_id | APITOOL | Get specific metadataprofile. | | chaptarr_get_metadataprofile_schema | APITOOL | Get metadataprofile schema. | | chaptarr_get_notification | APITOOL | Get notification. | | chaptarr_get_notification_id | APITOOL | Get specific notification. | | chaptarr_get_notification_schema | APITOOL | Get notification schema. | | chaptarr_get_parse | APITOOL | Get parse. | | chaptarr_get_path | APITOOL | Get path. | | chaptarr_get_ping | APITOOL | Get ping. | | chaptarr_get_qualitydefinition | APITOOL | Get qualitydefinition. | | chaptarr_get_qualitydefinition_id | APITOOL | Get specific qualitydefinition. | | chaptarr_get_qualityprofile | APITOOL | Get qualityprofile. | | chaptarr_get_qualityprofile_id | APITOOL | Get specific qualityprofile. | | chaptarr_get_qualityprofile_schema | APITOOL | Get qualityprofile schema. | | chaptarr_get_queue | APITOOL | Get queue. | | chaptarr_get_queue_details | APITOOL | Get queue details. | | chaptarr_get_queue_status | APITOOL | Get queue status. | | chaptarr_get_release | APITOOL | Get release. | | chaptarr_get_releaseprofile | APITOOL | Get releaseprofile. | | chaptarr_get_releaseprofile_id | APITOOL | Get specific releaseprofile. | | chaptarr_get_remotepathmapping | APITOOL | Get remotepathmapping. | | chaptarr_get_remotepathmapping_id | APITOOL | Get specific remotepathmapping. | | chaptarr_get_rename | APITOOL | Get rename. | | chaptarr_get_retag | APITOOL | Get retag. | | chaptarr_get_rootfolder | APITOOL | Get rootfolder. | | chaptarr_get_rootfolder_id | APITOOL | Get specific rootfolder. | | chaptarr_get_search | APITOOL | Get search. | | chaptarr_get_series | APITOOL | Get series. | | chaptarr_get_system_backup | APITOOL | Get system backup. | | chaptarr_get_system_routes | APITOOL | Get system routes. | | chaptarr_get_system_routes_duplicate | APITOOL | Get system routes duplicate. | | chaptarr_get_system_status | APITOOL | Get system status. | | chaptarr_get_system_task | APITOOL | Get system task. | | chaptarr_get_system_task_id | APITOOL | Get specific system task. | | chaptarr_get_tag | APITOOL | Get tag. | | chaptarr_get_tag_detail | APITOOL | Get tag detail. | | chaptarr_get_tag_detail_id | APITOOL | Get specific tag detail. | | chaptarr_get_tag_id | APITOOL | Get specific tag. | | chaptarr_get_update | APITOOL | Get update. | | chaptarr_get_wanted_cutoff | APITOOL | Get wanted cutoff. | | chaptarr_get_wanted_cutoff_id | APITOOL | Get specific wanted cutoff. | | chaptarr_get_wanted_missing | APITOOL | Get wanted missing. | | chaptarr_get_wanted_missing_id | APITOOL | Get specific wanted missing. | | chaptarr_post_author | APITOOL | Add a new author. | | chaptarr_post_book | APITOOL | Add a new book. | | chaptarr_post_bookshelf | APITOOL | Add a new bookshelf. | | chaptarr_post_command | APITOOL | Add a new command. | | chaptarr_post_customfilter | APITOOL | Add a new customfilter. | | chaptarr_post_customformat | APITOOL | Add a new customformat. | | chaptarr_post_delayprofile | APITOOL | Add a ne

…

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Knuckles-Team
• Source: Knuckles-Team/arr-mcp
• License: MIT

Install and usage instructions live in the source repository linked above.