Skip to main content
Glama

FlixBridge

npm version npm downloads License: MIT

Media Management MCP Server
Connect your AI assistant to TV shows and movie management services

FlixBridge is a Model Context Protocol (MCP) server that bridges AI assistants with media management services. It provides a unified interface for monitoring downloads, managing libraries, and automating media workflows.

โœจ Key Features

  • ๐ŸŽฌ Multi-Service Support - TV shows, movies, and download clients

  • ๐Ÿ”„ Real-Time Monitoring - Queue status, system health, and diagnostics

  • ๐Ÿค– Smart Automation - Auto-fix stuck downloads and optimize workflows

  • ๐Ÿข Multi-Instance Ready - Quality tiers, content types, environments

  • ๐Ÿ” Intelligent Search - Find and add new content with smart quality profiles

  • ๐Ÿ“Š Unified Dashboard - Single view across all your services

  • ๐Ÿ› Advanced Debugging - Comprehensive logging and diagnostics

  • โšก High Performance - Efficient, lightweight, TypeScript-first

๐Ÿ“ฆ Installation

From npm (Recommended)

# Install globally npm install -g @thesammykins/flixbridge # Or install locally in your project npm install @thesammykins/flixbridge

๐Ÿ“ฆ View on npm

From Source

# Clone the repository git clone https://github.com/thesammykins/FlixBridge.git cd FlixBridge # Install dependencies and build npm install && npm run build

๐Ÿš€ Quick Start

# 1. Configure your services via environment variables export SONARR_URL="http://localhost:8989" export SONARR_API_KEY="your-sonarr-api-key" export RADARR_URL="http://localhost:7878" export RADARR_API_KEY="your-radarr-api-key" # Optional downloader export SABNZBD_URL="http://localhost:8080" export SABNZBD_API_KEY="your-sabnzbd-api-key" # 2. Build and run npm run build npm start

Or with slug-based configuration for multiple instances:

# Multiple Sonarr instances export SONARR_HD_URL="http://localhost:8989" export SONARR_HD_API_KEY="your-hd-sonarr-key" export SONARR_4K_URL="http://localhost:8990" export SONARR_4K_API_KEY="your-4k-sonarr-key" # Multiple Radarr instances export RADARR_MAIN_URL="http://localhost:7878" export RADARR_MAIN_API_KEY="your-main-radarr-key" export RADARR_UHD_URL="http://localhost:7879" export RADARR_UHD_API_KEY="your-uhd-radarr-key" npm start

โš™๏ธ Configuration

FlixBridge v0.3.x uses environment-only configuration with slug-based discovery. No config files and no JSON-in-env mapping required.

Slug-based multiple instances

  • Sonarr: SONARR_<SLUG>_URL, SONARR_<SLUG>_API_KEY, optional SONARR_<SLUG>_NAME

  • Radarr: RADARR_<SLUG>_URL, RADARR_<SLUG>_API_KEY, optional RADARR_<SLUG>_NAME

  • SABnzbd: SABNZBD_<SLUG>_URL, SABNZBD_<SLUG>_API_KEY, optional SABNZBD_<SLUG>_NAME

Multi-Instance Example

# Sonarr export SONARR_MAIN_URL="http://sonarr-main:8989" export SONARR_MAIN_API_KEY="{{SONARR_MAIN_KEY}}" export SONARR_4K_URL="http://sonarr-4k:8989" export SONARR_4K_API_KEY="{{SONARR_4K_KEY}}" # Radarr export RADARR_MAIN_URL="http://radarr-main:7878" export RADARR_MAIN_API_KEY="{{RADARR_MAIN_KEY}}" export RADARR_UHD_URL="http://radarr-uhd:7878" export RADARR_UHD_API_KEY="{{RADARR_UHD_KEY}}" # SABnzbd (optional) export SABNZBD_MAIN_URL="http://sab-main:8080" export SABNZBD_MAIN_API_KEY="{{SAB_MAIN_KEY}}"

Notes:

  • Service names default to sonarr-<slug> / radarr-<slug> (slug lowercased, _ โ†’ -).

  • If you set <KIND>_<SLUG>_NAME, that overrides the final name (ensure it contains "sonarr"/"radarr" to pass current detection).

  • Single-instance fallback (SONARR_URL/RADARR_URL/SABNZBD_URL) still works for simple setups.

๐Ÿ› ๏ธ Available Tools

โš ๏ธ Important: Always call list_services first to discover available services before using any other tools.

Service Discovery

  • list_services - Discover all configured services and downloaders

Core Operations

  • system_status - Health and version information

  • queue_list - Download queue with progress tracking

  • queue_grab - Force retry/grab specific downloads

  • queue_diagnostics - Auto-detect and fix stuck items

  • root_folders - Storage locations and free space

Media Management

  • search - Find new series/movies to add

  • add_new - Add media with intelligent quality profiles

  • quality_profiles - List available quality configurations

  • history_detail - Download and import history

  • import_issues - Detect stuck downloads and import problems

Multi-Service Tools

  • all_services_diagnostics - Run diagnostics across all instances

  • download_status - Unified status across services and downloaders

๐Ÿ”ง MCP Client Setup

Claude Desktop

Add to claude_desktop_config.json:

{ "mcpServers": { "flixbridge": { "command": "npx", "args": ["@thesammykins/flixbridge"], "env": { "SONARR_URL": "http://localhost:8989", "SONARR_API_KEY": "your-sonarr-api-key", "RADARR_URL": "http://localhost:7878", "RADARR_API_KEY": "your-radarr-api-key" } } } }

Alternative: Global Installation

# Install globally for easier usage npm install -g @thesammykins/flixbridge

Then use with Claude Desktop by providing environment variables (standard or via mapping):

{ "mcpServers": { "flixbridge": { "command": "flixbridge", "env": { "SONARR_URL": "http://localhost:8989", "SONARR_API_KEY": "your-sonarr-api-key", "RADARR_URL": "http://localhost:7878", "RADARR_API_KEY": "your-radarr-api-key", "SABNZBD_URL": "http://localhost:8080", "SABNZBD_API_KEY": "your-sabnzbd-api-key" } } } }

Single Instance Setup (Alternative)

export SONARR_URL="http://localhost:8989" export SONARR_API_KEY="your-sonarr-api-key" export RADARR_URL="http://localhost:7878" export RADARR_API_KEY="your-radarr-api-key" export SABNZBD_URL="http://localhost:8080" export SABNZBD_API_KEY="your-sabnzbd-api-key"

๐Ÿ› Debugging

Enable comprehensive debug logging:

FLIX_BRIDGE_DEBUG=1 npm run dev

๐Ÿงช Testing

# Basic functionality test npm run smoke # Test with debug output FLIX_BRIDGE_DEBUG=1 npm run smoke

๐Ÿ“š Documentation

๐Ÿค Contributing

  1. Read the Architecture Guide

  2. Follow engineering principles in AGENTS.md

  3. Maintain TypeScript strict mode

  4. Add tests for new features

  5. Run npm run smoke before submitting

๐Ÿ“„ License

MIT - see LICENSE file for details

๐Ÿ†˜ Need Help?

  1. Check the

  2. Run diagnostics: npm run smoke

  3. Enable debug mode: FLIX_BRIDGE_DEBUG=1

  4. Review logs from your media management services


Made with โค๏ธ for the home media automation community

Deploy Server
-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

FlixBridge is a Model Context Protocol (MCP) server that bridges AI assistants with media management services.

It provides a unified interface for monitoring downloads, managing libraries, and automating media workflows.

  1. โœจ Key Features
    1. ๐Ÿ“ฆ Installation
      1. From npm (Recommended)
      2. From Source
    2. ๐Ÿš€ Quick Start
      1. โš™๏ธ Configuration
        1. Slug-based multiple instances
        2. Multi-Instance Example
      2. ๐Ÿ› ๏ธ Available Tools
        1. Service Discovery
        2. Core Operations
        3. Media Management
        4. Multi-Service Tools
      3. ๐Ÿ”ง MCP Client Setup
        1. Claude Desktop
        2. Alternative: Global Installation
        3. Single Instance Setup (Alternative)
      4. ๐Ÿ› Debugging
        1. ๐Ÿงช Testing
          1. ๐Ÿ“š Documentation
            1. ๐Ÿค Contributing
              1. ๐Ÿ“„ License
                1. ๐Ÿ†˜ Need Help?

                  Related MCP Servers

                  • A
                    security
                    A
                    license
                    A
                    quality
                    A TypeScript-based Model Context Protocol (MCP) server enabling integration with PiAPI for media content generation using platforms like Midjourney, Flux, and others through MCP-compatible applications.
                    Last updated -
                    61
                    MIT License
                    • Apple
                  • -
                    security
                    F
                    license
                    -
                    quality
                    This server acts as a Message Communication Protocol (MCP) service for integrating Apifox and Cursor, enabling OpenAPI interface implementation through AI-driven interaction.
                    Last updated -
                    7
                  • -
                    security
                    F
                    license
                    -
                    quality
                    A TypeScript-based MCP server for controlling LIFX smart lights via the official LIFX HTTP API, allowing users to manage light states, toggle power, apply effects, and activate scenes.
                  • A
                    security
                    A
                    license
                    A
                    quality
                    A bridge server that connects Agent Communication Protocol (ACP) agents with Model Context Protocol (MCP) clients, enabling seamless integration between ACP-based AI agents and MCP-compatible tools like Claude Desktop.
                    Last updated -
                    16
                    11
                    MIT License

                  View all related MCP servers

                  MCP directory API

                  We provide all the information about MCP servers via our MCP API.

                  curl -X GET 'https://glama.ai/api/mcp/v1/servers/thesammykins/FlixBridge'

                  If you have feedback or need assistance with the MCP directory API, please join our Discord server