m3u8

You run an MCP Server that serves m3u8/HLS streams through a dedicated API. It can parse playlists, extract segment URLs, download streams with FFmpeg, cache data for offline access, and connect to MCP clients for interactive control. This guide walks you through practical usage, installation steps, and essential configuration to get you streaming quickly and securely.

How to use

Start and use the m3u8 MCP server to work with m3u8/HLS playlists from any MCP client. You will connect to the server over HTTP on a configurable port (default 37650), parse playlists, inspect segments, and initiate downloads or conversions through simple client actions.

Typical workflow you can perform with an MCP client:

• Launch the server and confirm it is listening on port 37650 (default)
• Configure your MCP client to target http://localhost:37650/mcp
• Use the client’s playlist parsing to analyze an m3u8 file
• Request the list of segment URLs and copy individual endpoints as needed
• Start a download or conversion with FFmpeg through the server’s API
• Access cached playlists and metadata for offline viewing when needed

Available tools

m3u8_set_url

Set the current m3u8 URL in the UI so you can work with a playlist without retyping it.

m3u8_get_url

Retrieve the currently loaded m3u8 URL from the UI for quick reference or validation.

m3u8_parse

Parse an m3u8 playlist to inspect structure, variants, and metadata.

m3u8_extract_segments

Extract all segment URLs from a playlist, enabling copy or batch processing.

m3u8_download

Download a complete stream using FFmpeg and save to a specified output path.

m3u8_convert

Convert a video file to an HLS (m3u8) format with configurable segment duration and playlist type.

m3u8_probe

Probe an m3u8 stream to fetch metadata such as codecs, resolutions, and bitrates using FFmpeg.

m3u8_cache_list

List cached playlists and downloads to review previously processed content.

m3u8_cache_clear

Clear all cached data to reclaim space and reset offline access.