brs-docs-mcp

brs-docs-mcp

MCP server for Roku BrightScript documentation plus device-control tools.

See CLAUDE.md for dev conventions and docs/superpowers/specs/2026-04-16-brs-docs-mcp-design.md for the design.

Tools

Documentation (SQLite FTS5)

• brs_search(query, limit, kind?) full-text search across BrightScript docs.
• brs_get(id) fetch a doc by id (e.g. component:roDateTime).
• brs_list(kind, prefix?) list docs of a given kind, optional title prefix filter.

Read-only device introspection (ECP, port 8060)

• roku_device_info(host?) parse /query/device-info.
• roku_list_apps(host?) parse /query/apps.
• roku_tail_log(host?, seconds=10) capture BrightScript debug console output for seconds.
• roku_query_active_app(host?) parse /query/active-app.
• roku_query_media_player(host?) parse /query/media-player to a flat snake_case dict.
• roku_query_r2d2_bitrate(host?) parse /query/r2d2_bitrate into a list of stream entries.
• roku_query_icon(app_id, host?) fetch the channel icon at /query/icon/<app_id>; returns mime, base64 body, byte count.

ECP control (port 8060, no auth)

• roku_keypress(key, repeat=1, mode="press", host?) send /keypress, /keydown, or /keyup. Allowlisted standard keys (Home, Up, Down, ...) plus Lit_<char> for character input.
• roku_keysequence(keys, delay_ms=150, host?) send a sequence of keypresses with delay_ms between each.
• roku_launch(app_id, params?, host?) POST /launch/<app_id> with optional URL-encoded deep-link params. app_id="dev" is allowed.
• roku_input(params, host?) POST /input?<urlencoded> to deep-link into the running channel.
• roku_to_home(host?) macro that sends Home, Home to drop the device into a known idle state. NOT a reboot; the return value documents this.

Authenticated dev-portal (port 80, Digest)

• roku_install(zip_base64, host?, password?) sideload a channel zip.
• roku_remove(host?, password?) remove the currently installed dev channel.
• roku_query_registry(dev_id, host?, password?) parse /query/registry/<dev_id>.
• roku_profiler_snapshot(host?, password?) POST /plugin_inspect with mysubmit=Inspect; extract whatever blocks are present plus a 10 KB raw HTML excerpt.
• roku_crashlog_pull(host?, password?) GET /plugin_factory_log. Returns ok=False on 404. Body is streamed and capped at 1 MB.

host falls back to BRS_DEFAULT_ROKU_HOST. password falls back to BRS_ROKU_DEV_PASSWORD.