About TVWizard
TVWizard is an MCP server in the Developer Tools category: control Android TV from any AI. 21 MCP tools: keys, apps, titles, playback, volume, observe. It has been installed 0 times through Conduid.
Install
git clone https://github.com/fizzious1/TVWizard-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about TVWizard
Powered by Claude · Grounded in docs
Security checks
- ·README presentNot checked yet.
- ·License declaredNot checked yet.
- ·Tests presentNot checked yet.
- ·Dependencies pinnedNot checked yet.
- ·No dynamic code executionNot checked yet.
- ·Scoped permissionsNot checked yet.
README
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.
README mirrored from the source repository 4 months ago. The original is authoritative.