Streaming Telemetry & HLS Diagnostics MCP

    1

    Diagnose HLS playlists (.m3u8), audit SCTE-35 ad breaks, and triage playback QoE.

    Free

    Security scanned

    Works with the AI tools you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+22 more

    Streaming Telemetry & HLS Diagnostics MCP

    Example session with this skill installed

    Inspect this HLS master manifest and tell me if our bitrate ladder has any aggressive step jumps that could cause player rebuffering stalls.
    Analyze this HLS manifest at https://cdn.example.com/live/stream.m3u8 and check for SCTE-35 ad marker synchronization issues reported in recent session drops.

    • Read your context and instructions
    • Compiled the streaming telemetry

    Summary

    Analyzed Master Playlist containing 3 renditions (360p, 720p, 1080p). Identified 2 high-risk bitrate ladder steps exceeding the recommended 2.5x threshold.

    RenditionResolutionBandwidth (bps)Step Ratio vs PreviousCompliance Status
    360p640x360800,000Baseline✅ Optimal
    720p1280x7202,400,0003.0x jump⚠️ High Risk
    1080p1920x10807,500,0003.1x jump⚠️ High Risk

    Detected Video Playback Risks:

    Aggressive Bitrate Step (3.0x): Jump from 800 kbps (360p) to 2.4 Mbps (720p) exceeds the 2.5x threshold, risking player buffer depletion during sudden network throttling.

    Aggressive Bitrate Step (3.1x): Jump from 2.4 Mbps (720p) to 7.5 Mbps (1080p) risks visual stutter and rebuffering stalls on mobile clients.

    Recommended Next Steps:

    1. Insert an intermediate 480p rendition (approx. 1.4 Mbps) to smooth the lower ladder step.
    2. Insert an intermediate 1080p medium-profile rendition (approx. 4.5 Mbps) before stepping up to 7.5 Mbps.

    Connects securely to your tools. The creator never sees your data.

    About this skill

    Equips Claude Code, Cursor, Copilot, and other AI coding agents with direct video streaming diagnostics to inspect HLS playlists, validate SCTE-35 ad break splices, and triage playback QoE incidents.

    Backed by the open-source streaming-telemetry-mcp server, this skill allows your AI assistant to run local diagnostics without sending proprietary stream URLs or internal telemetry to external third-party cloud APIs.

    What Your Agent Can Do With This Skill:

    1. HLS Playlist Diagnostics: Ingests Master and Media .m3u8 manifests to audit bitrate ladder steps (flagging aggressive bandwidth drops > 2.5x that cause player ABR buffering stalls), check #EXT-X-TARGETDURATION segment overruns, and detect discontinuity tags.
    2. SCTE-35 & SSAI Ad Insertion Validation: Audits #EXT-X-DATERANGE and #EXT-X-CUE-OUT/#EXT-X-CUE-IN splice synchronization to detect unclosed ad breaks and planned duration mismatches before broadcast.
    3. Playback QoE Incident Triage: Evaluates playback telemetry (startup time/TTFF, rebuffering ratio %, CDN edge POP, error codes like CDN 504 or HTTP 503) and generates an automated Root Cause Analysis (RCA) with mitigation and multi-CDN traffic steering recommendations.

    Setup & Local Execution:

    Includes client configuration templates for Cursor (.cursor/mcp.json) and Claude Desktop (claude_desktop_config.json). The MCP server runs 100% locally on your machine.

    How it works

    1. Analyze Manifest via the inspect_hls_manifest tool to scan for spec compliance and encoding issues.
    2. Validate Ad Markers using validate_ad_markers to ensure ad pods are correctly signaled and closed.
    3. Query Telemetry with query_stream_qoe to correlate manifest issues with real-world player errors like CDN_504.

    Frameworks & tools

    This skill requires the streaming-telemetry-mcp server. It supports HLS (.m3u8) video standards, SCTE-35 ad-insertion protocols, and standard QoE telemetry metrics including TTFF and rebuffer ratios.

    Why this beats prompting it yourself

    Generic LLMs cannot parse multi-megabyte HLS playlists or perform precise duration arithmetic for ad-splice validation without hallucinating timing offsets. This skill connects the agent to specialized tools that extract exact manifest data and telemetry trends for objective debugging.

    Use cases

    • Debugging playback stalls caused by EXT-X-DISCONTINUITY tags.
    • Verifying SCTE-35 splice points for a new SSAI integration.
    • Performing automated RCA on player telemetry spikes during live events.
    • Auditing bitrate ladders for spec compliance before deployment.

    Known limitations

    Requires a local instance of the streaming-telemetry-mcp server configured in your agent settings. Does not support DASH (.mpd) manifests or DRM license challenge inspection.

    How to use

    Skills on Agensi run inside your AI agent. Copy the prompt, paste it into your agent, and it connects to Agensi and installs this skill for you. If a payment is needed, your agent shows it to you first.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill passes our trust checks below.

    Security scanned

    Passed our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    Free forever

    No account required to browse

    Trust & safety

    Security scanned

    Verified clean today

    • Free to download with an account

    Needs access to

    Github

    Listedtoday

    What's inside

    Frequently Asked Questions