VxMouse FAQ
Short answers.
Quick answers about mouse mode and the MCP server.
Frequently asked questions
What is VxMouse?
VxMouse turns the Android TV or Google TV remote into a mouse: arrow keys move a pointer and OK clicks. The next release adds an MCP server so an AI agent can operate the device as well.
Do I need to root my TV?
No. Mouse mode uses the Android accessibility service, which you switch on in system settings. An optional ADB connection, planned for the next release, adds extra reliability and unlocks a few features.
How do I switch mouse mode on?
Press OK twice within about half a second in any app. Press OK twice again to leave. A custom toggle key (hotkeys) comes with the next release.
Which devices and Android versions work?
Android 8.0 or newer on Android TV and Google TV. The MCP tools also support Android phones and tablets, using touch coordinates through ADB.
What is MCP?
Model Context Protocol is an open standard that lets AI apps use tools. VxMouse runs an MCP server on the TV so an AI client can see the screen and press buttons.
Is the MCP server available now?
It is finished but not in the current release. It arrives with the next VxMouse update.
Which AI clients can connect?
Any MCP-capable client: Claude Desktop, Cline and other agents. Most clients speak stdio, so a small bridge script converts that to the WebSocket connection the TV uses. You can also write your own WebSocket client.
How many tools does the MCP server offer?
42: one operating-manual tool plus 41 device tools for sensing, input, apps, system, files, scheduling, translation and diagnostics.
Can an AI control any app?
Most. YouTube TV, Netflix, Spotify, Apple TV and Prime Video hide their on-screen structure, so the agent uses screenshots and remote keys there. Protected video shows as a black screenshot.
Is it safe to let an AI control my TV?
Set a token, keep the TV off the public internet, and switch the server off when you do not need it. Dangerous shell commands are blocked by default. The AI's own safety rules are advice, not enforcement.
Does the AI see my screen?
Yes. Screenshots and the on-screen element tree are handed to the connected AI client, so connect only clients you trust.
How do I get VxMouse?
VxMouse is distributed to supporters on Patreon and can be installed with GTV-toolkit on Windows.
Get VxMouse
VxMouse is distributed to supporters on Patreon and can be installed with GTV-toolkit on Windows.