smartest-tv
Control any smart TV with natural language.
Connector by Hybirdss · GitHub account verified by the MCP Registry
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.
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.
About
Use cases: api-integration
Reviews
Write a reviewNo 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_groupstv_historytv_insightstv_list_tvstv_playtv_recommendtv_statetv_state_watchtv_statustv_volumetv_whats_on
Write 5 · Create, change, send or run things.
tv_notifytv_queuetv_resolvetv_scenetv_sync
Not yet classified 7 · We could not tell from the name and description.
tv_audiotv_casttv_displaytv_launchtv_nexttv_powertv_screen
Secrets and settings it asks for
Other settings (environment variables or headers).
TV_IPTV_MACTV_PLATFORM
Network hosts it talks to 24
203.0.113.50· found in codeamazon.com· found in codeapis.justwatch.com· found in codecrunchyroll.com· found in codedisneyplus.com· found in codegithub.com· found in codeglama.ai· found in codegoogle.com· found in codegrafana.local· found in codehtml.duckduckgo.com· found in codehulu.com· found in codelaftel.net· found in codenetflix.com· found in codeopen.spotify.com· found in codeparamountplus.com· found in codeplay.max.com· found in codeprimevideo.com· found in coderaw.githubusercontent.com· found in coderemi-api.narukys.workers.dev· found in coderouter.local· found in codesearch.brave.com· found in codetop10.netflix.com· found in codetv.apple.com· found in codeyoutu.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_audioMulti-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_castCast 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_displayTurn 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_groupsList all TV groups and their members.
tv_historyShow recent play history.
tv_insightsGet 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_launchLaunch 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_tvsList all configured TVs with name, platform, IP, and default status.
tv_nextPlay 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_notifyShow a toast notification on the TV screen. Args: message: Text to display. tv_name: Target TV name. Omit for default TV.
tv_playFind 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_powerTurn TV on or off. Args: on: True = turn on, False = turn off. tv_name: Target TV name. Omit for default TV.
tv_queueManage 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_recommendGet personalized recommendations based on watch history + trending. Args: mood: "chill", "action", "kids", "random", or omit for auto. limit: Number of recommendations (default 5).
tv_resolveResolve 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_sceneRun 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_screenTurn 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_stateGet 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_watchStream 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_statusGet TV status: current app, volume, mute, model, firmware. Args: tv_name: Target TV name. Omit for default TV.
tv_syncPlay 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_volumeGet 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_onShow 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
- Repository
- github.com/Hybirdss/smartest-tv
- 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.
Cite this page
smartest-tv MCP server. Agent Mart. https://agentmart.dev/connectors/hybirdss-smartest-tv (last updated 2026-10-24)