# TVWizard [Health: Active]

**Category:** 📂 Browser Automation  
**Repository:** https://github.com/fizzious1/TVWizard-mcp  
**GitHub Stars:** 1  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/tvwizard

## Description
Control Android TV from any AI. 21 MCP tools: keys, apps, titles, playback, volume, observe.

## Tools
Capabilities this server exposes over MCP:

- **tv.list_devices** — Lists TVs paired to your account.
- **tv.send_key** — Sends a key: POWER, HOME, UP/DOWN/LEFT/RIGHT, OK, BACK, VOL_UP/DOWN.
- **tv.launch_app** — Opens an Android Intent — YouTube deep links, Netflix titles, any HTTPS URL.
- **tv.list_apps** — Enumerates installed apps so your AI knows what's available.
- **tv.play_title** — Resolves "Scrubs S2E5" to a country-specific provider deep link (Netflix, Disney+, Max, Apple TV+, and more) via TMDB + JustWatch.
- **tv.observe** — Reads back the TV screen state: foreground app, focused element, visible clickable nodes.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "tvwizard": {
    "command": "npx",
    "args": ["-y","tvwizard"]
  }
}
```

## Documentation

## What TVWizard MCP server does

TVWizard MCP server gives an AI client control over paired Android TV and Google TV devices. It can act as a remote control, inspect the current screen, open installed or provider-specific apps, and resolve a natural-language title request into a streaming destination.

The system is intended for Claude-compatible clients. A TV is paired once through the bridge app and a six-digit code, after which the device can be addressed by its configured name, such as `living-room`.

## How it works

The architecture has three parts: an MCP connection from the AI client to the TVWizard relay, a WebSocket connection from the relay to the TVWizard bridge, and the bridge app running on the Android TV or Google TV device. The bridge makes the outbound connection, so the setup does not require port forwarding, a VPN, or both devices to be on the same Wi-Fi network.

TVWizard MCP server uses a bearer token generated during device claiming. The relay forwards commands to the paired bridge and returns the device response. If the TV is offline, the service reports an error rather than holding the command for later execution.

## Setup and configuration

Install the bridge APK from the project's latest release on the Android TV or Google TV device. Open the bridge, choose pairing, and note the six-digit code displayed by the TV. Enter that code on the TVWizard claim page, assign a device name, and copy the generated bearer token and Claude Desktop configuration snippet.

Paste the configuration into Claude Desktop and restart the application. The provided material does not specify a package-manager command for running a local MCP process; the documented setup uses the hosted relay together with the bridge APK.

## Tools and capabilities

The documented MCP tools include:

- `tv.list_devices` returns TVs paired with the account.
- `tv.send_key` sends supported controls such as power, home, directional navigation, confirmation, back, and volume up or down.
- `tv.launch_app` opens Android Intents, including YouTube deep links, Netflix title links, and HTTPS URLs.
- `tv.list_apps` reports installed applications so an agent can choose from what is available on the device.
- `tv.play_title` resolves requests such as a show and episode into a country-specific provider link. Its lookup chain uses TMDB, JustWatch, and a region-aware Android package map.
- `tv.observe` reports the foreground app, focused element, and visible clickable nodes on the TV screen.

Title resolution covers providers listed in the project documentation, including Netflix, Disney+, Prime Video, Max, Hulu, Apple TV+, Paramount+, Peacock, fuboTV, YouTube, and Stremio. Results use a 60-day cache, and catalogs depend on the user's country.

## Limitations and notes

The bridge currently targets Android TV and Google TV. Samsung Tizen support is listed as a future item rather than a current capability. Streaming availability varies by region, and JustWatch coverage may be incomplete; the documentation notes Stremio as a fallback for some gaps.

Early access is currently free, while final pricing tiers are described as not yet finalized. The bridge is open source, but the repository describes the relay as source-available and non-commercial. The documentation also states that the service is hosted in Frankfurt, follows GDPR requirements, and does not log, sell, or use command content for training.

_Full upstream README: https://allmcps.com/mcp/tvwizard/readme_