media

This Media Server MCP provides AI-assisted control over your Radarr, Sonarr, Plex, and TMDB-enabled metadata workflows. You can ask your AI assistant to search, add, and manage movies in Radarr; search, add, and manage TV series in Sonarr; browse Plex libraries and fetch content metadata; and perform advanced TMDB lookups for metadata enrichment. The server also offers a robust Tool Configuration System with multiple profiles and branches to tailor which tools are exposed to the AI, helping reduce clutter and focus on relevant tasks. To get started, configure at least one service (Radarr, Sonarr, or TMDB) in your MCP client, then interact with the assistant to perform tasks like adding a movie to Radarr or discovering a TV series via TMDB.

Prerequisites:

• A machine with DenO (Deno) installed and a compatible runtime environment for MCP servers
• Access to configure MCP client with a server reference
• API keys for Radarr, Sonarr, TMDB, and Plex if you want full integration

Installation steps:

1. Install Deno if you don’t have it:

# macOS / Linux
curl -fsSL https://deno.land/x/install/install.sh | sh

# Windows (PowerShell)
iwr myself -useb https://deno.land/x/install/install.ps1 | iex

2. Add the Media Server MCP to your MCP client configuration (JSR path shown):

{
  "mcpServers": {
    "media-server": {
      "command": "deno",
      "args": ["run", "--allow-all", "jsr:@wyattjoh/media-server-mcp"],
      "env": {
        "RADARR_URL": "http://localhost:7878",
        "RADARR_API_KEY": "your-radarr-api-key",
        "SONARR_URL": "http://localhost:8989",
        "SONARR_API_KEY": "your-sonarr-api-key",
        "TMDB_API_KEY": "your-tmdb-api-key",
        "PLEX_URL": "http://localhost:32400",
        "PLEX_API_KEY": "your-plex-api-key",
        "TOOL_PROFILE": "default"
      }
    }
  }
}

3. Start or test the setup using your MCP client tooling. If you prefer, you can also load the direct GitHub version in a similar configuration as shown in the repository's Quick Start sections.

Tips and considerations:

• SSE mode is available for HTTP transport with authentication via MCP_AUTH_TOKEN. If you enable SSE, generate a strong token and store it securely.
• At least one of Radarr, Sonarr, or TMDB must be configured to enable the toolset effectively.
• The Tool Configuration System supports 6 branches, grouping tools for discovery, library management, system maintenance, download management, metadata enrichment, and advanced searches. Use profiles to tailor exposed tools for your AI assistant.
• Keep API keys secure and rotate them periodically. Do not expose tokens in public spaces or logs.
• Health endpoint (/health) is unauthenticated in SSE mode; other endpoints require a Bearer token.
• If you encounter connection issues, verify that the provided URLs are reachable from the MCP server host and that API keys are correct.