Skip to content
Agentmart
Submit a tool

smartest-tv

Control any smart TV with natural language.

Connector by Hybirdss · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 55
Write a review

Chalk Labs

Need help deploying smartest-tv?

Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.

Book a call

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/hybirdss-smartest-tv

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Control any smart TV with natural language. Resolve Netflix/YouTube/Spotify and deep-link.

Use cases: api-integration

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
11 read · 5 write · 0 delete · 7 not yet classified
Secrets
None asked for
Install scripts
None found
Runs as
Python package

Tools by what they do 23

Read from the source code; the running server may list different tools.

Read 11 · Look things up without changing anything.

  • tv_groups
  • tv_history
  • tv_insights
  • tv_list_tvs
  • tv_play
  • tv_recommend
  • tv_state
  • tv_state_watch
  • tv_status
  • tv_volume
  • tv_whats_on

Write 5 · Create, change, send or run things.

  • tv_notify
  • tv_queue
  • tv_resolve
  • tv_scene
  • tv_sync

Not yet classified 7 · We could not tell from the name and description.

  • tv_audio
  • tv_cast
  • tv_display
  • tv_launch
  • tv_next
  • tv_power
  • tv_screen

Secrets and settings it asks for

Other settings (environment variables or headers).

  • TV_IP
  • TV_MAC
  • TV_PLATFORM

Network hosts it talks to 24

  • 203.0.113.50 · found in code
  • amazon.com · found in code
  • apis.justwatch.com · found in code
  • crunchyroll.com · found in code
  • disneyplus.com · found in code
  • github.com · found in code
  • glama.ai · found in code
  • google.com · found in code
  • grafana.local · found in code
  • html.duckduckgo.com · found in code
  • hulu.com · found in code
  • laftel.net · found in code
  • netflix.com · found in code
  • open.spotify.com · found in code
  • paramountplus.com · found in code
  • play.max.com · found in code
  • primevideo.com · found in code
  • raw.githubusercontent.com · found in code
  • remi-api.narukys.workers.dev · found in code
  • router.local · found in code
  • search.brave.com · found in code
  • top10.netflix.com · found in code
  • tv.apple.com · found in code
  • youtu.be · found in code

Files it touches

  • /proc/net/arp
  • Your home directory (~)
  • ~/.config/smartest-tv

Tools (23)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • tv_audio

    Multi-room audio mode — play music with screens off. Actions: play, stop, volume. Args: action: "play", "stop", or "volume". query: Music to play (required for "play"). Defaults to YouTube. platform: "youtube" or "spotify" (for "play"). rooms: List of room/TV names. Omit for all TVs. volume: Volume level (for "volume" action). room: Single room name (for "volume" action). Examples: tv_audio("play", "lo-fi beats") tv_audio("play", "chill vibes", "spotify", rooms=["kitchen", "bedroom"]) tv_audio("stop") tv_audio("volume", room="kitchen", volume=30)

  • tv_cast

    Cast a Netflix/YouTube/Spotify URL to the TV. Paste any streaming URL. stv parses the platform and content ID automatically. Args: url: Any Netflix, YouTube, or Spotify URL. tv_name: Target TV name. Omit for default TV. Examples: tv_cast("https://youtube.com/watch?v=dQw4w9WgXcQ") tv_cast("https://netflix.com/watch/82656797") tv_cast("https://open.spotify.com/track/3bbjDFVu...")

  • tv_display

    Turn the TV into a display — show dashboards, messages, clocks, or any URL. The TV becomes a smart display. HTML is generated and served locally, then opened in the TV's browser. Args: content_type: "message", "clock", "dashboard", "photo", "iframe", or "custom". data: Content-specific data: - message: {"text": "Hello!", "bg": "#000", "color": "#fff"} - clock: {"format": "24h"} or {"format": "12h"} - dashboard: {"title": "Home", "cards": [{"label": "Temp", "value": "22°C"}]} - photo: {"urls": ["http://..."], "interval": 5} - iframe: {"url": "ht…

  • tv_groups

    List all TV groups and their members.

  • tv_history

    Show recent play history.

  • tv_insights

    Get viewing insights, screen time, or subscription value analysis. Args: period: "day", "week", or "month". report_type: "full" (formatted report), "screen_time", or "sub_value:platform:cost" (e.g. "sub_value:netflix:17.99"). Examples: tv_insights("week") tv_insights("day", "screen_time") tv_insights("month", "sub_value:netflix:17.99")

  • tv_launch

    Launch an app, optionally with a deep link. Use tv_play instead if you have a content name (not ID). Use this when you already have the exact content ID. Args: app: App name (netflix, youtube, spotify) or raw app ID. content_id: Platform-specific content ID for deep linking. tv_name: Target TV name. Omit for default TV.

  • tv_list_tvs

    List all configured TVs with name, platform, IP, and default status.

  • tv_next

    Play the next episode. Continues from watch history. Args: query: Show name. Omit to continue the most recent Netflix show. tv_name: Target TV name. Omit for default TV.

  • tv_notify

    Show a toast notification on the TV screen. Args: message: Text to display. tv_name: Target TV name. Omit for default TV.

  • tv_play

    Find content by name and play it on TV. This is the primary tool. Resolves the content ID automatically, then deep-links into the app on your TV. Args: platform: "netflix", "youtube", or "spotify". query: Content name (e.g. "Stranger Things", "baby shark", "Ye White Lines"). season: Season number (Netflix series only). episode: Episode number (Netflix series only). title_id: Netflix title ID if already known (skips search). tv_name: Target TV name. Omit for default TV. Examples: tv_play("netflix", "Stranger Things", season=4, episode=7) tv_play("youtube", "ba…

  • tv_power

    Turn TV on or off. Args: on: True = turn on, False = turn off. tv_name: Target TV name. Omit for default TV.

  • tv_queue

    Manage the play queue. Actions: add, show, play, skip, clear. Args: action: "add", "show", "play", "skip", or "clear". platform: Required for "add". netflix/youtube/spotify. query: Required for "add". Content name. season: For "add" — Netflix season number. episode: For "add" — Netflix episode number. tv_name: For "play" — target TV. Examples: tv_queue("add", "youtube", "Gangnam Style") tv_queue("add", "netflix", "Dark", season=1, episode=1) tv_queue("show") tv_queue("play") tv_queue("clear")

  • tv_recommend

    Get personalized recommendations based on watch history + trending. Args: mood: "chill", "action", "kids", "random", or omit for auto. limit: Number of recommendations (default 5).

  • tv_resolve

    Resolve a content name to its platform ID without playing. Args: platform: netflix, youtube, or spotify. query: Content name. season: Season number (Netflix). episode: Episode number (Netflix). title_id: Netflix title ID if known. Returns: Content ID string.

Show 8 more tools
  • tv_scene

    Run or list scene presets. Built-in: movie-night, kids, sleep, music. Args: action: "list" or "run". name: Scene name (required for "run"). tv_name: Target TV (for "run"). Examples: tv_scene("list") tv_scene("run", "movie-night") tv_scene("run", "kids", tv_name="kids-room")

  • tv_screen

    Turn screen on or off (audio continues when off). Args: on: True = screen on, False = screen off (audio continues). tv_name: Target TV name. Omit for default TV.

  • tv_state

    Get unified live TV state: playback, volume, input, power. Returns a single snapshot for agent branching. Fields the target driver cannot supply are returned as None. Args: tv_name: Target TV name. Omit for default TV.

  • tv_state_watch

    Stream tv_state snapshots via progress notifications. Emits `count` progress updates spaced `interval` seconds apart, then returns the final snapshot. Default is 1 minute of watching. Args: tv_name: Target TV name. Omit for default TV. interval: Seconds between snapshots (default 5). count: Number of snapshots to emit (default 12). ctx: MCP context for progress reporting (injected by FastMCP).

  • tv_status

    Get TV status: current app, volume, mute, model, firmware. Args: tv_name: Target TV name. Omit for default TV.

  • tv_sync

    Play content on multiple TVs simultaneously (party mode). Resolves once, launches on all targets via asyncio.gather. Args: platform: netflix, youtube, or spotify. query: Content name. tv_names: List of TV names. Or use group. group: TV group name (e.g. "party"). season: Netflix season number. episode: Netflix episode number. title_id: Netflix title ID if known.

  • tv_volume

    Get or set volume, step up/down, or toggle mute. All in one tool. - No args: returns current volume + mute status - level=25: set volume to 25 - direction="up"/"down": step volume - mute=True/False/None: mute, unmute, or toggle Args: level: Volume level 0-100. direction: "up" or "down" for one step. mute: True=mute, False=unmute, None=toggle. tv_name: Target TV name. Omit for default TV.

  • tv_whats_on

    Show trending content on Netflix and/or YouTube. Args: platform: "netflix", "youtube", or omit for both. limit: Number of results per platform (default 10).

Signals

Stars
55
Forks
5
Open issues
0
Contributors
2
Weekly downloads
70
Last commit
Oct 2, 2026 (29 days ago)
Last release
Oct 2, 2026 (29 days ago)
Last package publish
Oct 2, 2026 (29 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.Hybirdss/smartest-tv
Version
0.4.1
Auth
No auth
Packages
pypi stv
License
MIT
First seen
Oct 24, 2026
Last checked
Oct 24, 2026

Done for you

Rather not set it up yourself?

Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.

See how we build AI agents →Read the case studies

Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.

launches shipped
50+
launches shipped
media placements
500+
media placements
founders on every account
2
founders on every account

Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block

Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.

Get smartest-tv running in your business

Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.

Goes to the Chalk Labs founders, not the newsletter. Privacy

Need help deploying smartest-tv?

CallGet help
Cite this page

smartest-tv MCP server. Agent Mart. https://agentmart.dev/connectors/hybirdss-smartest-tv (last updated 2026-10-24)