TVWizard MCP Server for Claude

Overview

TVWizard is a Model Context Protocol server plus cloud relay that turns any Claude-compatible chat into a universal remote for Android TV and Google TV. After pairing once with a six-digit code, you can list devices, send keys, launch apps, resolve titles to provider deep links, and read the on-screen state from anywhere.

Source, docs, and releases are in fizzious1/TVWizard-mcp. The relay endpoint is https://tv.djwizard.ai/mcp/, registered as ai.djwizard/tvwizard.

Features

• tv.list_devices for TVs paired to your account.
• tv.send_key for POWER, navigation, OK, BACK, and volume keys.
• tv.launch_app for Android intents and HTTPS deep links.
• tv.list_apps to enumerate installed applications.
• tv.play_title with TMDB and JustWatch title resolution across regions.
• tv.observe to read foreground app and visible UI nodes.

Use Cases

• Turn off the bedroom TV from your phone while traveling.
• Launch Netflix or YouTube for a specific title with natural language.
• Inspect what app is foreground before sending navigation keys.
• List installed streaming apps to build better voice commands.
• Pause playback with BACK or HOME during automation experiments.

Installation

Pair the bridge

1. Install the latest bridge APK from GitHub releases.
2. Open the app on the TV and tap Pair to display a six-digit code.
3. Visit tv.djwizard.ai/claim.html, claim the code, and copy the bearer token.

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "tvwizard": {
      "url": "https://tv.djwizard.ai/mcp/",
      "transport": "streamable-http",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Fully quit and relaunch Claude Desktop after saving.

Claude Code

claude mcp add --transport http tvwizard https://tv.djwizard.ai/mcp/

Configure the bearer token in your client's header settings.

Configuration

{
  "mcpServers": {
    "tvwizard": {
      "url": "https://tv.djwizard.ai/mcp/",
      "type": "http",
      "headers": {
        "Authorization": "Bearer YOUR_TVWIZARD_TOKEN"
      }
    }
  }
}

Examples

Observe the screen

Use tv.observe on my living-room TV and tell me what app is in the foreground.

Play a title

Put on Stranger Things season 1 episode 1 on the living-room TV.

Power off

Send POWER to the bedroom TV.

Security

• Revoke and re-pair if a bearer token may have leaked via chat or screenshots.
• Avoid automating purchases or account changes on shared household TVs without consent.
• Review the open-source bridge APK to understand what runs on the TV device.

Troubleshooting

Tools do not appear

Confirm the Claude config path, merge into existing mcpServers, and restart fully.

authentication required

The bearer token is missing, wrong, or revoked; re-claim at /claim.html.

bridge offline

Ensure the TV is powered on, online, and the bridge app is running.

tv.play_title provider missing

Catalog coverage varies by country; try provider: "stremio" when JustWatch data is sparse.