Skip to main content
Glama
Sign In
deenesjakoruzh
mcp-arr-lite

mcp-arr-lite

by Cuti27
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

mcp-arr-lite

GHCR License

Lightweight MCP server for Radarr and Sonarr with a small set of granular, purpose-built tools. Unofficial project.

Why this project?

General "arr" MCP servers (like Knuckles-Team/arr-mcp) auto-generate thousands of tools from the Arr API and hand the whole surface to the LLM. mcp-arr-lite is the opposite:

  • Granular tools: exactly the operations needed for the "can you grab X for me?" flow — lookup, add, search releases, grab — no admin/config noise.

  • Preferred-indexer logic: search tools default to the indexer with the lowest numeric priority, deterministic instead of prompt-dependent.

  • HITL-friendly: read-only tools (lookup, list indexers) can be auto-approved; add/search/grab require explicit user approval.

  • Dual transport: stdio (npx) and HTTP (Docker).

Comparison with Knuckles-Team/arr-mcp

Aspect

arr-mcp

mcp-arr-lite

Tool surface

1123 generated tools

9 hand-written tools

Preferred indexer

Prompt-dependent

Coded into search tools

Apps

6+ Arr apps

Radarr + Sonarr

Transports

stdio

stdio + HTTP

Focus

Whole API

Add & download flow

Related MCP server: overseerr-mcp

Tools

Tool

Read-only

Description

radarr_lookup / sonarr_lookup

✅

Search a movie/series by title, returns name + poster URL

list_indexers

✅

List indexers for an app, marking the preferred one

radarr_add / sonarr_add

❌

Add a movie/series (optionally trigger search)

radarr_search_releases / sonarr_search_releases

❌

Search releases, defaulting to the preferred indexer

radarr_grab / sonarr_grab

❌

Start downloading a release

Requirements

  • Node.js >= 20 (npx) or Docker (container)

  • Radarr and/or Sonarr with an API key

Installation

Docker Compose (recommended)

services:
  arr-mcp:
    image: ghcr.io/cuti27/mcp-arr-lite:latest
    restart: unless-stopped
    environment:
      - RADARR_URL=http://radarr:7878
      - RADARR_API_KEY=your-radarr-api-key
      - SONARR_URL=http://sonarr:8989
      - SONARR_API_KEY=your-sonarr-api-key
      - MCP_TRANSPORT=http
      - MCP_AUTH_TOKEN=your-secure-token-here
      - PORT=3000
      - HOST=0.0.0.0
      - LOG_LEVEL=info

Only configure the apps you use — Radarr and Sonarr are both optional at startup; tools for an unconfigured app will return an error.

stdio (npx)

RADARR_URL=http://radarr:7878 \
RADARR_API_KEY=... \
SONARR_URL=http://sonarr:8989 \
SONARR_API_KEY=... \
MCP_TRANSPORT=stdio \
npx -y @cuti27/mcp-arr-lite

Environment variables

See .env.example. Required per app: RADARR_URL + RADARR_API_KEY, SONARR_URL + SONARR_API_KEY. MCP_AUTH_TOKEN is required when MCP_TRANSPORT=http.

Security

  • HTTP transport enforces bearer auth, rate limiting (60 req/min/IP) and a 1 MB body limit.

  • API keys are redacted from logs.

  • Only run the HTTP transport with MCP_AUTH_TOKEN set and behind a TLS-terminating reverse proxy.

License

MIT

Available Tools

9 tools
list_indexersA

List configured indexers for Radarr or Sonarr, marking the preferred one (lowest numeric priority among enabled). Use this when a preferred indexer returns no releases and you need to show the user the alternatives.

Inputs: app.

radarr_addA

Add a movie to Radarr. By default starts searching for a release immediately. Requires user confirmation before calling.

Inputs: title (required), tmdbId (required), search, monitored, +2 more.

radarr_grabB

Start downloading a movie release in Radarr. Requires user confirmation before calling.

Inputs: guid (required), indexerId.

radarr_lookupA

Search Radarr for a movie by title (or TMDB/IMDb id). Returns candidates with title, year, overview and poster URL. Use this to confirm with the user before adding.

Inputs: term (required).

radarr_search_releasesA

Search available releases for a movie in Radarr. Defaults to the preferred indexer (lowest numeric priority). If the preferred indexer returns no results, ask the user which alternative indexer to use and pass its id.

Inputs: movieId (required), indexer.

sonarr_addA

Add a series to Sonarr. By default starts searching for missing episodes immediately. Requires user confirmation before calling.

Inputs: title (required), tvdbId (required), search, monitored, +3 more.

sonarr_grabA

Start downloading a series episode release in Sonarr. Requires user confirmation before calling.

Inputs: guid (required), indexerId.

sonarr_lookupA

Search Sonarr for a series by title (or TVDB/IMDb id). Returns candidates with title, year, overview and poster URL. Use this to confirm with the user before adding.

Inputs: term (required).

sonarr_search_releasesA

Search available releases for one or more episodes in Sonarr. Defaults to the preferred indexer (lowest numeric priority). If the preferred indexer returns no results, ask the user which alternative indexer to use and pass its id.

Inputs: indexer, episodeId, episodeIds.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4/5.0

    Scored across 9 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose, separated by service (Radarr vs. Sonarr) and action (lookup, add, search_releases, grab). The list_indexers tool is generic but well-defined, with no overlap between tools.

    Naming Consistency5/5

    Tool names follow a consistent pattern: service_verb (e.g., radarr_lookup, sonarr_add). The list_indexers deviates slightly but still follows a verb_object structure, and there is no mixing of conventions.

    Tool Count5/5

    With 9 tools covering two services and a core workflow, the count is well-scoped. Each tool earns its place, and there is neither bloat nor insufficiency for the 'lite' purpose.

    Completeness4/5

    The tool set covers the primary workflow: lookup, add, search releases, and grab for both movies and series. Missing operations like delete or update are minor gaps given the 'lite' scope, and the list_indexers aids release search.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • nas-mcp-server

      matthieurosset
      A
      license
      A
      quality
      C
      maintenance
      MCP server for managing a media server stack (Plex, Radarr, Overseerr, Bazarr, Prowlarr, Trakt.tv) using natural language to browse, request, and discover content.
      12
      MIT

    • overseerr-mcp

      Milli42
      F
      license
      Not graded
      quality
      B
      maintenance
      MCP server for Overseerr that enables searching, requesting, and managing media (movies and TV shows) through natural language, with integration to Radarr/Sonarr for automated downloads.
      -

    • Arr-MCP

      LtMarx
      A
      license
      A
      quality
      C
      maintenance
      MCP server to manage your *ARR media stack (Radarr, Sonarr, Lidarr, Readarr, Prowlarr) for searching, adding, and managing movies, TV shows, music, books, and indexers.
      1
      ISC