Tools Reference

Jump to: Console · Network · Errors · Evaluate · Device · Redux · Components · Storage · Bundle · Simulator · Deep Link · UI Interact · Navigation · Accessibility · Profiler · Test Recorder · Commands · Resources · Prompts

Console

• get_console_logs — Get recent console output. Filter by level (log/warn/error/info/debug), search text, limit. Supports summary and compact modes.
• clear_console_logs — Clear the log buffer.

Network

Request Tracking

• get_network_requests — Get buffered HTTP requests with method, URL, status, timing. Supports device param for per-device filtering.
• get_request_details — Get full headers for a specific request by URL.
• get_response_body — Get the response body for a specific request. Bodies under 1 MB are eagerly cached and survive reconnections; larger bodies are fetched on demand from the current CDP session.
• search_network — Filter by URL pattern, method, status code, or errors only.
• get_network_stats — Aggregated network statistics: breakdown by domain, status code distribution, response time percentiles (p50/p95/p99), and slowest endpoints.
• clear_network_requests — Clear the network request buffer.

Errors

• get_errors — Get uncaught exceptions with symbolicated stack traces.
• clear_errors — Clear the error buffer.

Evaluate

• evaluate_js — Execute any JavaScript expression in the running app and return the result. Supports async/await.

Device

• list_devices — List connected debuggable targets from Metro.
• get_app_info — Bundle URL, platform, device name, VM type.
• get_connection_status — CDP connection state and Metro status.
• reload_app — Reload the app. Tries Metro's HTTP reload endpoint first, then falls back to DevSettings.reload() via CDP.

Source

• symbolicate — Convert minified stack traces to original source locations.

Redux

No app changes needed for basic state inspection.

• get_redux_state — Get the full state tree or a specific slice via dot-path (e.g., user.profile).
• dispatch_redux_action — Dispatch an action to the Redux store.
• get_redux_actions — Get recent dispatched actions (real-time with client SDK).

Components

No app changes needed.

• get_component_tree — Get the React component tree. Use structureOnly=true for compact output (~1-3KB).
• find_components — Search by component name pattern.
• inspect_component — Get detailed props, state, and hooks for a specific component.
• get_testable_elements — List all elements with testID or accessibilityLabel.

Storage

No app changes needed.

• get_storage_keys — List all AsyncStorage keys.
• get_storage_item — Read a specific key value.
• get_all_storage — Dump all key-value pairs.

Bundle

• get_bundle_status — Metro server status and health check.
• get_bundle_errors — Compilation/transform errors with file paths.

Simulator

• take_screenshot — Capture simulator/device screenshot.
• list_simulators — List iOS simulators and Android emulators.
• install_certificate — Add root certificate to device.
• get_native_logs — Native logs (iOS syslog / Android logcat).
• app_lifecycle — Launch, terminate, install, uninstall apps.
• get_screen_orientation — Get current orientation.

Deep Link

• open_deeplink — Open a URL or deep link on the device.
• list_url_schemes — List registered URL schemes.

UI Interact

All tools use the CDP fiber tree first, falling back to simctl/adb, then IDB as a last resort. IDB is optional — tools will prompt you to install it when needed.

• list_elements — Get interactive elements from the React component tree (labels, testIDs, roles). No IDB needed.
• tap_element — Tap by label/testID (CDP fiber tree) or coordinates (simctl/adb → IDB fallback).
• type_text — Type into a TextInput by testID/label or the first visible input (CDP → adb → IDB).
• long_press — Long press by label/testID (CDP) or coordinates (adb → IDB).
• swipe — Scroll/swipe in a direction (CDP ScrollView → adb → IDB).
• press_button — Press HOME (simctl), BACK/ENTER/DELETE (CDP + adb), VOLUME/POWER (adb → IDB).

Navigation

No app changes needed.

• get_navigation_state — Full React Navigation / Expo Router state.
• get_current_route — Currently focused route name and params.
• get_route_history — Navigation back stack.
• list_routes — All registered route names.

Accessibility

No app changes needed.

• audit_accessibility — Full screen audit for missing labels, roles, testIDs, alt text.
• check_element_accessibility — Deep check on a specific component.
• get_accessibility_summary — Counts overview of accessibility coverage.

Commands

• list_commands — List custom commands registered by the app.
• run_command — Execute a custom command with parameters.

Profiler

See the profiling guide for a full explanation of CDP CPU profiling vs React <Profiler>.

• start_profiling — Start Hermes CPU profiling via CDP. Param: samplingInterval in µs (default 1000). Captures all JS execution — React, Redux, navigation, your code.
• stop_profiling — Stop profiling and return top functions ranked by self time and total time. Params: topN (default 20), includeNative (default false).
• get_profile_status — Check whether profiling is active and whether a previous profile is available.
• get_flamegraph — Return the current profiling results as a human-readable text flamegraph: CPU call tree + ranked chart + React render chart.
• get_react_renders — Read render timings from <Profiler onRender={trackRender}> components. Returns renders sorted by actualDuration with memoSavingsPercent. Requires trackRender from metro-mcp/client. Param: clear (bool).

Profiler Resources

URI	Description
metro://profiler/flamegraph	CPU call tree with time bars + ranked self-time chart + React render chart (text)
metro://profiler/data	Raw JSON: full CDP Profile object + React render records with memo savings

Test Recorder

Records real user interactions via React fiber patching — no app code changes required. See the testing guide for full details.

• start_test_recording — Inject interaction interceptors into the running app. Captures taps, text entry, long presses, keyboard submits, and scroll/swipe gestures. Re-patches new fibers after each navigation so newly-loaded screens are always covered.
• stop_test_recording — Stop recording and retrieve the captured event log. Deduplicates rapid-fire text input events (keeps the final value per field).
• generate_test_from_recording — Convert the recording to a test file. Params: format (appium/maestro/detox), testName, platform (ios/android/both), bundleId, includeSetup.
• generate_wdio_config — Generate a minimal wdio.conf.ts for Appium + React Native, including the install command for all required packages.

Chrome DevTools

• open_devtools — Open the React Native DevTools debugger panel in Chrome (or Edge). Uses Metro's bundled rn_fusebox frontend but routes the WebSocket through the MCP's CDP proxy so both DevTools and the MCP can coexist. Finds Chrome/Edge automatically via chrome-launcher. See Chrome DevTools in the README for why you should use this instead of pressing "j" or tapping "Open Debugger".

Debug Globals

No app changes needed.

• list_debug_globals — Auto-discover well-known global debugging objects in the app runtime: Redux stores, Apollo Client, Expo Router state, React DevTools hook, and more. Use detailed=true to include top-level keys for each discovered global.

Inspect Point (Experimental)

No app changes needed.

• inspect_at_point — Inspect the React component rendered at specific screen coordinates. Walks the React fiber tree to find the host component whose layout contains the given (x, y) point, then walks up to find the nearest named React component. Returns component name, host element type, layout bounds, and optionally props. Layout measurement varies between Old and New Architecture.

Token-Efficient Output

All tools support modifiers to reduce context window usage:

Modifier	Effect
summary: true	Counts + last N items
structureOnly: true	Component tree without props/state (~1-3KB)
compact: true	Single-line compressed format (30–50% smaller)
maxLength: number	Truncate long values
limit: number	Cap number of results

Resources

URI	Description
metro://logs	Live console log stream
metro://network	Live network request stream
metro://errors	Live error stream
metro://status	Connection status
metro://redux/state	Redux state snapshot
metro://navigation	Navigation state
metro://bundle/status	Metro bundle status
metro://profiler/flamegraph	CPU flamegraph + React render chart (text)
metro://profiler/data	Raw JSON profiling data for agent analysis

Prompts

Name	Description
debug-app	General debugging session
debug-errors	Error investigation workflow
debug-performance	Performance analysis
diagnose-network	Network issue diagnosis
trace-action	Trace user action through state + network
record-test	Record a user flow and generate an Appium, Maestro, or Detox test
audit-accessibility	Accessibility audit with fixes