tautulli_activity
Check current Plex streaming activity to see who's watching what, playback status, and quality before restarting servers or Plex.
Instructions
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.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- tautulli.py:153-177 (handler)The handler function `tautulli_activity` queries the Tautulli API for active sessions and formats the output for the user.
@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)