MCP Tool Reference

This inventory reflects the tools registered by the current Hosanna Tools MCP server. Inspect the schema shown by your MCP client for exact parameters, because tools may add optional fields between releases.

Connection and Compact State

Tool	Purpose
health	Verify proxy reachability and report connected runtimes
get_connected_apps	List connected app IDs and app types
get_app_status	Inspect one app connection
reset_connection	Reset MCP/debug-proxy connection state
reload_web_app	Reload a connected web app
get_state	Return compact route, focus, view, and collection state
get_app_structure	Discover app screens, tabs, and navigation structure
get_token_stats	Inspect response/token accounting maintained by the debugger client

Navigation and Checks

Tool	Purpose
send_debugger_command	Send a raw remote-debug command
send_ecp_key	Send a Roku ECP key
drive	Send a short key sequence and return resulting state
diff_state	Compare state before and after keys
diff_focus	Compare focus before and after keys
go_to	Navigate toward a resolvable target
deep_link	Use an app-supported view, ID, or content deep link
wait_for_view	Wait until a matching view appears
check	Check screen, focus, visibility, or field expectations
batch_commands	Execute a group of debugger operations

There is no generic MCP test tool.

View and SceneGraph Inspection

Tool	Purpose
get_view_hierarchy	Read the Hosanna view tree
get_sg_hierarchy	Read the SceneGraph tree
get_view_details	Inspect one Hosanna view
get_sg_node_details	Inspect one SceneGraph node
find_views	Search views by identity, type, label, or text
get_focus_graph	Inspect focus relationships
set_view_property	Temporarily change a Hosanna view field
set_sg_property	Temporarily change a SceneGraph field
highlight_view	Highlight one view
start_highlighting	Enable interactive highlighting
stop_highlighting	Disable interactive highlighting

CollectionView Diagnostics

Tool	Purpose
get_collection_view	Inspect collections, rows, focus, visible ranges, and cell summaries
get_collection_view_slice	Read a targeted row/cell window
trace_cv_rows	Trace CollectionView row behavior
get_cv_diagnostic_report	Read the latest CollectionView diagnostic report
start_cv_listener	Start receiving DevTools CollectionView batches
stop_cv_listener	Stop the batch listener
pull_cv_batch	Request a specific batch
get_cv_recording	Read a CollectionView diagnostic recording
get_cv_recording_stats	Summarize a CollectionView diagnostic recording
analyze_cv_recording	Analyze recorded CollectionView batches

These are CollectionView diagnostics, not general UI-test recordings.

Tracing and Performance

Tool	Purpose
trace_handlers	Trace input/focus handler execution
trace_render	Trace state changes and view rebuilds
inspect_lifecycle	Inspect lifecycle events for a view
validate_data	Validate runtime data/binding assumptions
render_frequency	Find frequent view/field updates
perf_tracking	Control runtime performance collection
get_perf_report	Read collected timing/pool information
get_scroll_jank_telemetry	Read scroll-jank telemetry
reset_perf_data	Clear collected performance data
diagnose	Run high-level debugger diagnostics

Application and Roku Logs

Tool	Purpose
logs	High-level app log retrieval/search/analysis
get_app_logs	Read buffered app logs
search_app_logs	Search app logs
clear_app_logs	Clear app logs
connect_roku_logs	Connect to Roku debug logs
get_roku_logs	Read buffered Roku logs
get_roku_errors	Extract Roku errors and warnings
search_roku_logs	Search Roku logs
clear_roku_logs	Clear the Roku log buffer
roku_log_status	Inspect Roku log connection state

Device, Screenshot, Registry, and Accessibility

Tool	Purpose
configure_roku_device	Configure Roku IP and optional developer password
get_roku_device_info	Read Roku device metadata
get_active_channel	Read the active Roku channel
get_installed_channels	List installed Roku channels
launch_channel	Launch a Roku channel with optional deep-link data
post_to_device	Send a raw device HTTP request
take_screenshot	Capture a Roku screenshot
take_web_screenshot	Capture web content through Playwright/CDP
get_registry	Read app registry data
update_registry	Update app registry data
get_text_to_speech	Read text-to-speech state
toggle_text_to_speech	Toggle text-to-speech
type_text	Enter text through the supported runtime path
type_literal_keys	Send literal key names

Build, Deploy, and RASP

Tool	Purpose
roku_build	Run a project Roku build
deploy_roku	Deploy Roku output
export_rasp_capture	Export a saved RASP capture
validate_rasp_script	Validate RASP YAML

RASP input capture and execution are primarily CLI workflows: hst rasp:capture, rasp:export, rasp:validate, and rasp:run.

Hs2d Game Tools

Tool	Purpose
game_state	Read compact game runtime and scene state
game_drive	Send game input and return resulting state
game_diff_state	Compare game state around input
game_screenshot	Capture a web game screenshot, with Playwright fallback
game_diagnose	Run game-specific diagnostics

For Roku game screenshots, use configure_roku_device followed by take_screenshot.

Working Rule

Start with health, get_state, and a short drive or diff_state. Use targeted detail, logs, traces, screenshots, and full hierarchies only when the compact result does not answer the question.