{
  "markdown": "<h1 align=\"center\">TVWizard</h1>\n\n<p align=\"center\">\n  <strong>Your TV, controlled by any AI — from anywhere.</strong><br>\n  Cloud relay + MCP server for Android TV and Google TV.\n</p>\n\n<p align=\"center\">\n  <a href=\"https://tv.djwizard.ai\">Website</a> ·\n  <a href=\"https://tv.djwizard.ai/pricing.html\">Pricing</a> ·\n  <a href=\"https://github.com/fizzious1/TVWizard-mcp/releases/latest\">Download bridge</a> ·\n  <a href=\"docs/quickstart.md\">Quickstart</a> ·\n  <a href=\"docs/mcp-tools.md\">Tool reference</a>\n</p>\n\n---\n\n## What it is\n\nTVWizard 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.\n\nIt works through the [Model Context Protocol](https://modelcontextprotocol.io), the emerging standard for AI agents controlling real-world tools.\n\n## How it works\n\n```\n  ┌───────────┐       ┌─────────────────┐       ┌─────────────────────┐\n  │  Claude   │──MCP─▶│  TVWizard Relay │──WS──▶│  TVWizard Bridge    │\n  │  (any)    │       │ tv.djwizard.ai  │       │  (Android TV app)   │\n  └───────────┘       └─────────────────┘       └─────────────────────┘\n        ▲                                                  │\n        └───────── pairing code (6 digits) ────────────────┘\n```\n\nThe 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.\n\n## Install (5 minutes)\n\n1. **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).)*\n2. **Open the app, tap Pair.** The TV shows a 6-digit code.\n3. **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.\n4. **Paste into Claude Desktop** (see [docs/claude-desktop.md](docs/claude-desktop.md)). Restart the app.\n5. **Talk to your TV.** Try: *\"What's on my living-room TV right now?\"* or *\"Put on Stranger Things season 1 episode 1.\"*\n\n## MCP tools\n\n| Tool | What |\n|---|---|\n| `tv.list_devices` | Lists TVs paired to your account. |\n| `tv.send_key` | Sends a key: POWER, HOME, UP/DOWN/LEFT/RIGHT, OK, BACK, VOL_UP/DOWN. |\n| `tv.launch_app` | Opens an Android Intent — YouTube deep links, Netflix titles, any HTTPS URL. |\n| `tv.list_apps` | Enumerates installed apps so your AI knows what's available. |\n| `tv.play_title` | Resolves \"Scrubs S2E5\" to a country-specific provider deep link (Netflix, Disney+, Max, Apple TV+, and more) via TMDB + JustWatch. |\n| `tv.observe` | Reads back the TV screen state: foreground app, focused element, visible clickable nodes. |\n\nFull reference with examples: [docs/mcp-tools.md](docs/mcp-tools.md).\n\n## Supported providers\n\n`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.\n\n| Category | Providers |\n|---|---|\n| Subscription | Netflix, Disney+ (MEA-aware), Prime Video, Max, Hulu, Apple TV+, Paramount+, Peacock, fuboTV |\n| Free / ad-supported | YouTube |\n| Virtual (IMDB-keyed) | Stremio |\n\n## Pricing\n\nEarly access is free. Pricing tiers are finalized at [tv.djwizard.ai/pricing.html](https://tv.djwizard.ai/pricing.html).\n\n## Privacy + trust\n\n- Open-source bridge. Audit exactly what runs on your TV.\n- Hosted in Frankfurt (EU), GDPR-compliant. [Privacy policy.](https://tv.djwizard.ai/privacy.html)\n- Your command content is **not** logged, **not** sold, **not** used to train anything.\n- Fails loudly — if the TV is offline, your AI gets an immediate error, not a queued ghost command.\n\n## Status\n\n- Relay: live at `tv.djwizard.ai`. Uptime: [stats.uptimerobot.com](https://stats.uptimerobot.com/mAVl6cvq4w).\n- **v0.3.0** (April 2026): six MCP tools, full title resolution chain, public claim UX. See [CHANGELOG.md](CHANGELOG.md).\n- v0.4 (next): Samsung Tizen bridge, user accounts for multi-household, Claude.ai-native connector registration.\n\n## Support\n\n- Bug / issue: [open an issue](https://github.com/fizzious1/TVWizard-mcp/issues/new/choose)\n- General: `hi@tv.djwizard.ai`\n- Security: `security@djwizard.ai` (see [SECURITY.md](SECURITY.md))\n- Business / hotels: `hotels@djwizard.ai`\n\n## License\n\nDocumentation in this repo is under [MIT](LICENSE). The bridge APK is Apache 2.0 (source: coming soon). The relay is source-available, non-commercial.\n",
  "bytes": 4741,
  "sha": "4231897e15e8aee3fedf7f9e0c48154375306e3c862098781598936c7df7ccb2",
  "repo_slug": "fizzious1/tvwizard-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_djwizard_tvwizard_2d26f0e8/readme"
}