TVWizard
Control Android TV from any AI. 38 MCP tools: playback, recap, recommend, smart-home, schedules.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http tvwizard 'https://tv.djwizard.ai/mcp/'
{
"mcpServers": {
"tvwizard": {
"type": "http",
"url": "https://tv.djwizard.ai/mcp/"
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
TVWizard
Your TV, controlled by any AI — from anywhere.
Cloud relay + MCP server for Android TV and Google TV.
Website · Pricing · Download bridge · Quickstart · Tool reference
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.
Frequently asked questions
What is TVWizard?
Control Android TV from any AI. 38 MCP tools: playback, recap, recommend, smart-home, schedules.
How do I install TVWizard?
It runs as a remote server. In Claude Code: claude mcp add --transport http tvwizard 'https://tv.djwizard.ai/mcp/'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does TVWizard need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is TVWizard open source?
Its code is public on GitHub, but the repository does not declare a standard license.
Who maintains TVWizard?
It is published by fizzious1. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.