# vizio-tv

MCP server to control a Vizio SmartCast TV over your local network. No cloud required — talks directly to the TV via the SmartCast local API.

## Tools

| Tool | Description |
|------|-------------|
| `pair_start` | Initiate pairing — shows a PIN on the TV screen |
| `pair_finish` | Complete pairing with the PIN from the TV |
| `power` | Turn TV on, off, or toggle |
| `volume` | Volume up, down, or mute (with optional step count) |
| `send_key` | Send any remote key (up, down, ok, back, home, play, pause, etc.) |
| `change_input` | Cycle to the next input source |
| `get_state` | Get current power and volume state |

## Setup

```bash
npm install
export VIZIO_IP=<your-tv-ip>   # find in TV Settings > Network
node index.js
```

Find your TV's IP: `Menu → Network → Manual Setup → IP Address`

## Pairing (one-time)

After starting the server, run `pair_start` — a 4-digit PIN appears on the TV. Then run `pair_finish` with that PIN. Auth token is saved to `config.json` (gitignored).

## Add to Claude Code

```json
{
  "mcpServers": {
    "vizio-tv": {
      "command": "node",
      "args": ["/path/to/vizio-tv/index.js"],
      "env": { "VIZIO_IP": "<your-tv-ip>" }
    }
  }
}
```

## Available keys for `send_key`

`power` `vol_up` `vol_down` `mute` `up` `down` `left` `right` `ok` `back` `exit` `home` `menu` `input` `play` `pause` `stop` `rewind` `fast_forward` `ch_up` `ch_down`