# TVWizard [Health: Active]

**Category:** 📂 Browser Automation  
**Repository:** https://github.com/fizzious1/TVWizard-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**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
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "tvwizard": {
    "url": "https://tv.djwizard.ai"
  }
}
```

## Documentation & README

<h1 align="center">TVWizard</h1>

<p align="center">
  <strong>Your TV, controlled by any AI — from anywhere.</strong><br>
  Cloud relay + MCP server for Android TV and Google TV.
</p>

<p align="center">
  <a href="https://tv.djwizard.ai">Website</a> ·
  <a href="https://tv.djwizard.ai/pricing.html">Pricing</a> ·
  <a href="https://github.com/fizzious1/TVWizard-mcp/releases/latest">Download bridge</a> ·
  <a href="docs/quickstart.md">Quickstart</a> ·
  <a href="docs/mcp-tools.md">Tool reference</a>
</p>

---

## What it is

TVWizard turns any Claude-compatible AI chat into a universal remote. Pair your Android TV or Google TV once with a 6-digit code, and from that moment on you can say "put on Scrubs S2E5" or "turn the bedroom TV off" from your phone, your laptop, your car — anywhere you talk to Claude.

It works through the [Model Context Protocol](https://modelcontextprotocol.io), the emerging standard for AI agents controlling real-world tools.

## How it works

```
  ┌───────────┐       ┌─────────────────┐       ┌─────────────────────┐
  │  Claude   │──MCP─▶│  TVWizard Relay │──WS──▶│  TVWizard Bridge    │
  │  (any)    │       │ tv.djwizard.ai  │       │  (Android TV app)   │
  └───────────┘       └─────────────────┘       └─────────────────────┘
        ▲                                                  │
        └───────── pairing code (6 digits) ────────────────┘
```

The bridge connects outbound to the relay — no port forwarding, no VPN, no same-Wi-Fi requirement. Your TV at home obeys commands from your phone abroad.

## Install (5 minutes)

1. **Get the bridge APK** from [the latest release](https://github.com/fizzious1/TVWizard-mcp/releases/latest). Install on your Android TV or Google TV. *(Sideload instructions in [docs/install-bridge.md](docs/install-bridge.md).)*
2. **Open the app, tap Pair.** The TV shows a 6-digit code.
3. **Go to [tv.djwizard.ai/claim.html](https://tv.djwizard.ai/claim.html)**, type the code, pick a device name (e.g. `living-room`). Copy the bearer token + the Claude Desktop config snippet it generates.
4. **Paste into Claude Desktop** (see [docs/claude-desktop.md](docs/claude-desktop.md)). Restart the app.
5. **Talk to your TV.** Try: *"What's on my living-room TV right now?"* or *"Put on Stranger Things season 1 episode 1."*

## MCP tools

| Tool | What |
|---|---|
| `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. |

Full reference with examples: [docs/mcp-tools.md](docs/mcp-tools.md).

## Supported providers

`tv.play_title` resolves titles via TMDB → JustWatch → a region-aware Android package map, with a 60-day cache. Streaming catalogs vary by country; Stremio (virtual, IMDB-keyed) fills gaps where JustWatch coverage is patchy.

| Category | Providers |
|---|---|
| Subscription | Netflix, Disney+ (MEA-aware), Prime Video, Max, Hulu, Apple TV+, Paramount+, Peacock, fuboTV |
| Free / ad-supported | YouTube |
| Virtual (IMDB-keyed) | Stremio |

## Pricing

Early access is free. Pricing tiers are finalized at [tv.djwizard.ai/pricing.html](https://tv.djwizard.ai/pricing.html).

## Privacy + trust

- Open-source bridge. Audit exactly what runs on your TV.
- Hosted in Frankfurt (EU), GDPR-compliant. [Privacy policy.](https://tv.djwizard.ai/privacy.html)
- Your command content is **not** logged, **not** sold, **not** used to train anything.
- Fails loudly — if the TV is offline, your AI gets an immediate error, not a queued ghost command.

## Status

- Relay: live at `tv.djwizard.ai`. Uptime: [stats.uptimerobot.com](https://stats.uptimerobot.com/mAVl6cvq4w).
- **v0.3.0** (April 2026): six MCP tools, full title resolution chain, public claim UX. See [CHANGELOG.md](CHANGELOG.md).
- v0.4 (next): Samsung Tizen bridge, user accounts for multi-household, Claude.ai-native connector registration.

## Support

- Bug / issue: [open an issue](https://github.com/fizzious1/TVWizard-mcp/issues/new/choose)
- General: `hi@tv.djwizard.ai`
- Security: `security@djwizard.ai` (see [SECURITY.md](SECURITY.md))
- Business / hotels: `hotels@djwizard.ai`

## License

Documentation in this repo is under [MIT](LICENSE). The bridge APK is Apache 2.0 (source: coming soon). The relay is source-available, non-commercial.