mcp-tautulli

Instructions

Implementation Reference

• tautulli.py:153-178 (handler)

  The handler function for the `tautulli_activity` MCP tool. It retrieves streaming activity from Tautulli and formats it into a human-readable string.

  @mcp.tool()
  async def tautulli_activity() -> str:
      """Get current Plex streaming activity — who's watching what, playback state, progress, and quality.
  
      Use this before restarting Plex or rebooting servers to check for active streams.
      """
      data = await _api("get_activity")
      stream_count = int(data.get("stream_count", 0))
      sessions = data.get("sessions", [])
  
      if not sessions:
          return "No active streams on Plex."
  
      lines = [f"{stream_count} active stream(s):\n"]
      for s in sessions:
          lines.append(f"  • {_fmt_session(s)}")
  
      # Bandwidth summary
      total_bw = data.get("total_bandwidth", 0)
      wan_bw = data.get("wan_bandwidth", 0)
      lan_bw = data.get("lan_bandwidth", 0)
      if total_bw:
          lines.append(f"\nBandwidth: {int(total_bw) / 1000:.1f} Mbps total (LAN: {int(lan_bw) / 1000:.1f}, WAN: {int(wan_bw) / 1000:.1f})")
  
      return "\n".join(lines)