TVWizard

<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, 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. Install on your Android TV or Google TV. (Sideload instructions in 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, 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). 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.

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.