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, 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)
- Get the bridge APK from the latest release. Install on your Android TV or Google TV. (Sideload instructions in docs/install-bridge.md.)
- Open the app, tap Pair. The TV shows a 6-digit code.
- Go to 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. - Paste into Claude Desktop (see docs/claude-desktop.md). Restart the app.
- 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.
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.
Privacy + trust
- Open-source bridge. Audit exactly what runs on your TV.
- Hosted in Frankfurt (EU), GDPR-compliant. Privacy policy.
- 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. - v0.3.0 (April 2026): six MCP tools, full title resolution chain, public claim UX. See CHANGELOG.md.
- v0.4 (next): Samsung Tizen bridge, user accounts for multi-household, Claude.ai-native connector registration.
Support
- Bug / issue: open an issue
- General:
hi@tv.djwizard.ai - Security:
security@djwizard.ai(see SECURITY.md) - Business / hotels:
hotels@djwizard.ai
License
Documentation in this repo is under MIT. The bridge APK is Apache 2.0 (source: coming soon). The relay is source-available, non-commercial.