Red Bee

The Red Bee MCP Server lets you connect Red Bee Media OTT services to MCP-compatible clients and web apps. It supports multiple operating modes—stdio for local AI agents, HTTP for REST/JSON-RPC web integration, SSE for real-time updates, or a combination—so you can choose the workflow that fits your setup and scale without changing your client code.

How to use

You can run the MCP server in stdio mode to interact with local AI agents, in HTTP mode to expose a REST/JSON-RPC API for web applications, or in SSE mode for real-time event streams. You can also run both stdio and HTTP concurrently to support multiple clients at the same time. When you start in HTTP mode, your server is reachable at a local URL and supports health checks, information endpoints, and a JSON-RPC endpoint for tool calls. If you want real-time updates, connect a client to the SSE stream.

How to install

Prerequisites: Python 3.8 or newer is required. You may also use the uvx runtime or install via pip to run the MCP server.

# Quick install with uvx (recommended)
# Test the server command help
uvx redbee-mcp --help

# Stdio mode (original)
uvx redbee-mcp --stdio --customer YOUR_CUSTOMER --business-unit YOUR_BU

# HTTP mode (new)
uvx redbee-mcp --http --customer YOUR_CUSTOMER --business-unit YOUR_BU

# Both modes simultaneously
uvx redbee-mcp --both --customer YOUR_CUSTOMER --business-unit YOUR_BU

Or install via pip and run the same usage as above using the redbee-mcp command.

pip install redbee-mcp

# Same usage as uvx, but with the redbee-mcp command
redbee-mcp --http --customer YOUR_CUSTOMER --business-unit YOUR_BU

Configuration overview

Configure clients to connect to the MCP server using either the stdio setup for local agents or the HTTP setup for web apps. The following client configurations show where to place credentials and how to start the server in the chosen mode.

{
  "mcpServers": {
    "redbee-mcp": {
      "command": "uvx",
      "args": ["redbee-mcp", "--stdio"],
      "env": {
        "REDBEE_CUSTOMER": "CUSTOMER_NAME",
        "REDBEE_BUSINESS_UNIT": "BUSINESS_UNIT_NAME"
      }
    }
  }
}

HTTP mode and endpoints

Start the HTTP server to expose a REST/JSON-RPC API and Server-Sent Events stream for real-time updates.

redbee-mcp --http --customer YOUR_CUSTOMER --business-unit YOUR_BU

# Server will be available at:
http://localhost:8000

# Key endpoints
# GET / -> API information
# GET /health -> health check
# POST / -> JSON-RPC MCP requests
# GET /sse -> Server-Sent Events stream

Security and maintenance notes

When deploying publicly, ensure proper CORS configuration, authentication, and secure handling of credentials. Use environment variables to inject sensitive data and avoid hardcoding them in configuration files.

Examples of real-time usage (SSE)

To receive live updates, connect to the SSE stream from your web app or client and handle incoming events in real time.

const eventSource = new EventSource('http://localhost:8000/sse')

eventSource.onmessage = function(event) {
  const data = JSON.parse(event.data)
  console.log('Event received:', data.type)
}

Available tools

login_user

Authenticate with username/password

create_anonymous_session

Create anonymous session

validate_session_token

Validate existing session

logout_user

Logout and invalidate session

get_public_asset_details

Get asset details via public endpoint (no auth)

search_content_v2

Search free text content in asset fields including descriptions

get_asset_details

Get detailed asset information

get_playback_info

Get streaming URLs and playback information

search_assets_autocomplete

Autocomplete search suggestions

get_epg_for_channel

Get Electronic Program Guide for a channel

get_episodes_for_season

Get all episodes in a season

get_assets_by_tag

Get assets by tag type (e.g., origin)

list_assets

List assets with advanced filters

search_multi_v3

Multi-search for assets, tags, and participants

get_asset_collection_entries

Get collection entries for an asset collection

get_asset_thumbnail

Get thumbnail URL for an asset at a specific time

get_seasons_for_series

Get all seasons for a TV series

signup_user

Create new user account

change_user_password

Change user password

get_user_profiles

Get user profiles

add_user_profile

Add new user profile

select_user_profile

Select active profile

get_user_preferences

Get user preferences

set_user_preferences

Set user preferences

get_account_purchases

Get user purchases

get_account_transactions

Get transaction history

get_offerings

Get available product offerings

purchase_product_offering

Purchase a product

cancel_purchase_subscription

Cancel subscription

get_stored_payment_methods

Get saved payment methods

add_payment_method

Add new payment method

get_system_config

Get platform configuration

get_system_time

Get server time

get_user_location

Get user location by IP

get_active_channels

Get active TV channels

get_user_devices

Get registered devices

delete_user_device

Delete a device