RokuMCP MCP server

by jack1590·io.github.jack1590/RokuMCP·v1.3.2·3 stars

No reviews yet

MCP server for Roku device automation — deploy, ECP control, screenshots, and debug console

B72/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B72/100

full report

Adoption

Growing

3 stars93 downloads/wk

Reviews

Write one

Nobody has reviewed RokuMCP yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

RokuMCP tools (20, 5 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

roku_console_connect
Open a persistent TCP connection to the BrightScript debug console on port 8085. Only one connection is active at a time.
roku_console_disconnect
Close the active BrightScript debug console connection.
roku_console_read
Read buffered output from the BrightScript debug console since the last read. Automatically disconnects after reading.
roku_console_sendwrite action
Send a command to the BrightScript debug console and return the response. Automatically disconnects after receiving the response. Common commands: bt (backtrace), var (variables), cont (continue), step, over, out, exit, print <expr>.
roku_delete_dev_channelwrite action
Delete the currently sideloaded developer channel from the Roku device.
roku_deploywrite action
Sideload (deploy) a Roku application to the device. Packages all files in the project directory and uploads them. A dev channel must not already be running, or it will be replaced.
roku_discover
Scan the local network for Roku devices using SSDP discovery. Returns a list of all found devices with their IP addresses.
roku_find_node
Search the app UI tree for a node by its ID or attribute value. Returns the matching node with all its properties (text, visible, focused, subtype, bounds, etc.). Only works when a sideloaded dev channel is running.
roku_get_focused_node
Get the currently focused node in the app UI tree. Returns the node with all its properties (id, subtype, text, bounds, etc.). Only works when a sideloaded dev channel is running.
roku_keypresswrite action
Send a single key press to the Roku device via ECP. Common keys: Home, Rev, Fwd, Play, Select, Left, Right, Down, Up, Back, InstantReplay, Info, Backspace, Search, Enter, Lit_<character>
roku_keypress_sequencewrite action
Send a sequence of key presses to the Roku device with an optional delay between each press.
roku_launch
Launch or deep-link into a channel on the Roku device. Use appId "dev" for the sideloaded developer channel.
roku_query_active_app
Query the currently active (foreground) app on the Roku device.
roku_query_app_ui
Get the current app UI tree as XML. Only works when a sideloaded dev channel is running.
roku_query_device_info
Query the Roku device for its info: model, firmware version, serial number, network info, etc.
roku_query_media_player
Query the media player state on the Roku device. Returns playback state (play, pause, buffer, stop, none), position, duration, and error info. Use this to verify video playback in tests.
roku_query_sg_nodes
Query SceneGraph nodes on the Roku device. Use type "all" for all nodes, "roots" for root nodes, or "node" with a nodeId to inspect a specific node.
roku_screenshot
Capture a screenshot of the current screen on the Roku device. A sideloaded dev channel must be running. Returns the image as base64-encoded content and the file path where it was saved.
roku_sleep
Wait for a specified duration. Use this between navigation steps to allow the UI to render, animations to complete, or content to load.
roku_type_text
Type a text string into the currently focused text field on the Roku device. Each character is sent as an individual Lit_ keypress. Use this for search fields, email inputs, password fields, etc.

Public scan report

scanner v0.1.10 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings

Code scan15 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 114 days ago8/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Overall 72/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How RokuMCP compares

Against every graded Developer tools MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 72/100; higher than 33% of 1,119 Developer tools servers
Tools: 20; the typical Developer tools server has 7
Tools that change things: 25%; typical: 5%. Fewer write tools means less an agent can break
GitHub stars: 3; more than 75% of 855 Developer tools servers
Downloads a week: 93; more than 57% of 436 Developer tools servers with a package

What its tools let an agent do: 15 read · 5 change

Install RokuMCP in Claude Code, Cursor or VS Code

Runs npx -y roku-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add RokuMCP -- npx -y roku-mcp

Add to Cursor

What the publisher says

From the RokuMCP repository's README, as published. We do not edit it. Read it on GitHub

roku-mcp

A Model Context Protocol (MCP) server for Roku device automation. Exposes tools for app deployment, ECP remote control, screenshot capture, SceneGraph node inspection, and BrightScript debug console access.

Install

The server ships as a single npx command. Install once globally if you prefer, or let your MCP client launch it on demand via npx -y roku-mcp — both work.

npm install -g roku-mcp     # optional, global install
# or just point your client at: npx -y roku-mcp

Configure your AI client below. Every platform uses the same launch line; only the config file and reload step change.

Cursor — agent-mode tools, auto-discovers MCP servers

Prerequisites: Cursor 0.45+ with Agent mode.

Install: create .cursor/mcp.json in your project root (or ~/.cursor/mcp.json for global):

{
  "mcpServers": {
    "roku": {
      "command": "npx",
      "args": ["-y", "roku-mcp"],
      "env": {
        "ROKU_DEVICE_HOST": "192.168.1.XXX",
        "ROKU_DEVICE_PASSWORD": "your-password"
      }
    }
  }
}

Then reload the window (Cmd+Shift+P / Ctrl+Shift+P → Developer: Reload Window).

Verify: open Cursor Settings → MCP and confirm the roku row shows a green dot. If it appears disabled, click the toggle. In a new agent chat, type list roku tools — you should see rokudeploy, rokuscreenshot, etc.

Routing rule (recommended): the repo also ships an AGENTS.md. Cursor picks it up automatically, so the agent knows the canonical observe → act → wait → verify loop and the RTA uiElementId gotcha without you having to re-explain it every session.

Troubleshoot: if the server stays grey/disabled, check View → Output → MCP Logs — the most common cause is ROKUDEVICEHOST unreachable on the LAN. Omit the env block entirely to fall back to SSDP auto-discovery.

VS Code (GitHub Copilot) — agent mode, MCP via .vscode/mcp.json

Prerequisites: VS Code 1.99+ with the GitHub Copilot extension and an active Copilot subscription that includes Agent mode.

Install: create .vscode/mcp.json in your project root:

{
  "servers": {
    "roku": {
      "command": "npx",
      "args": ["-y", "roku-mcp"],
      "env": {
        "ROKU_DEVICE_HOST": "192.168.1.XXX",
        "ROKU_DEVICE_PASSWORD": "your-password"
      }
    }
  }
}

Reload the window (Cmd+Shift+P / Ctrl+Shift+P → Developer: Reload Window).

Verify: open Copilot Chat, switch the chat-mode dropdown to Agent, and ask "what roku tools do you have?". You should see the full roku list. The MCP panel (Cmd+Shift+P → MCP: List Servers**) should show roku as Running.

Troubleshoot: if the server fails to start, run npx -y roku-mcp --help in a regular terminal first — that confirms Node 18+ and npx are working before VS Code launches it.

Claude Desktop — official Anthropic desktop app

Prerequisites: Claude Desktop (latest from claude.ai/download), Node.js 18+ on PATH.

Install: edit your Claude Desktop config:

macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
Windows: %APPDATA%\Claude\claudedesktopconfig.json

{
  "mcpServers": {
    "roku": {
      "command": "npx",
      "args": ["-y", "roku-mcp"],
      "env": {
        "ROKU_DEVICE_HOST": "192.168.1.XXX",
        "ROKU_DEVICE_PASSWORD": "your-password"
      }
    }
  }
}

Fully quit and restart Claude Desktop (the menu-bar icon must close — Cmd+Q on macOS).

Verify: open a new chat. The 🛠️ icon in the input bar should list roku-mcp with all its tools. Ask "take a Roku screenshot" — Claude will request approval for roku_screenshot and run it.

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

RokuMCP: common questions

Is RokuMCP MCP server safe?: Mostly: it is graded B (72/100). Read the RokuMCP safety report
How do I install RokuMCP?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does RokuMCP need an API key?: Yes. The registry entry asks for ROKU_DEVICE_PASSWORD.
Is RokuMCP maintained?: The last commit was 151 days ago (2026-06-06). The latest release is v1.3.2.
What can I use instead of RokuMCP?: Servers from other publishers that do the same job: Yaver MCP server, walkerOS Flow MCP server and Omnara MCP server.
How does RokuMCP compare with other Developer tools MCP servers?: safety score 72/100 (higher than 33% of 1,119 Developer tools servers); tools 20 (the typical Developer tools server has 7); tools that change things 25% (typical: 5%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to RokuMCP

Same job from other publishers: the closest match first, then the best rated.

Yaver
Phone-first OpenCode MCP for trusted devices: run, build, deploy, and manage endpoint-local tools.
not reviewed
Growing
C
walkerOS Flow
Build, validate, simulate, and deploy walkerOS event pipelines
not reviewed
Established
B
Omnara
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
not reviewed
Established
A
Metaplex Agent Registry
Deploy AI agents on-chain on Solana with an EIP-8004 identity. Deploy fee funds $THREE buybacks.
not reviewed
Established
B
Aiven MCP
Provision PostgreSQL, manage Apache Kafka, and deploy apps with Aiven - all from your AI assistant.
not reviewed
Established
A

Run it through the gateway

Local package. It runs on your machine, not through the gateway.

Rating: —
Safety grade: B · 72/100
Stars: 3
Downloads/wk: 93
Price: Free
Licence: MIT
Transport: Local · npm
Version: 1.3.2
Category: Developer tools
Last release: 2026-06-06

Credentials it needs

ROKU_DEVICE_HOSTIP address or hostname of the Roku device
ROKU_DEVICE_PASSWORDsecretDeveloper password for the Roku device

Own this server?

Claim it to keep the listing current and reply to reviews. Claiming never changes the grade or hides a review.

Claim listing

Badge for your README

Shows the safety grade and links back to this page. It updates itself after every scan and review.

[![mcp.market](https://mcp.market/badge/jack1590-rokumcp.svg)](https://mcp.market/server/jack1590-rokumcp)

How the badge works