TVWizard
Control Android TV from any AI. 38 MCP tools: playback, recap, recommend, smart-home, schedules.
Open source Repository Open in the app JSON README (API)
About
Control Android TV from any AI. 38 MCP tools: playback, recap, recommend, smart-home, schedules.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- ai.djwizard
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 0.7.0
- Last push
- 2026-04-20T18:18:16Z
- Repository state
- ativo
- License
- NOASSERTION
- Added
- 2026-08-29 03:00:10
- Updated
- 2026-08-29 03:00:10
- Origin id
ai.djwizard/tvwizard
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.