metro-mcp
Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.
Needs to start: nothing
Returns a result when called with no setup: 5 of 5 tools tried
Contacts while installing and starting: nothing
What it contacted
Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.
Starting it
npx -y metro-mcp@0.15.0
Installing a package runs its code. Use a sandbox for anything you have not read.
Calling its tools
5 tools that take no input and look read-only were called once with nothing. 5 returned a result.
get_console_logs | Returned a result under 0.1 s · 0 characters |
search_network | Returned a result under 0.1 s · 0 characters |
get_network_stats | Returned a result under 0.1 s · 29 characters |
get_errors | Returned a result under 0.1 s · 11 characters |
get_bundle_errors | Returned a result under 0.1 s · 26 characters |
During the calls it contacted nothing it had not already contacted.
Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.
What its tools tell an agent
In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.
Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.
Tools
get_console_logs level, search, limit, since, summary, device, format
Get recent console output. Filter by level or search text.
clear_console_logs device
Clear the console log buffer.
get_network_requests limit, since, summary, device, format
Get recent network requests from the React Native app.
get_request_details url, index, device
Get full details of a specific network request including headers and body.
get_response_body url, index, device
Get response body for a network request (cached if small; requires active session if large).
83 more tools
search_network urlPattern, method, statusCode, errorsOnly, limit, device
Search network requests by URL pattern, method, or status code.
clear_network_requests device
Clear the network request buffer.
get_network_stats device
Get aggregated network statistics: breakdown by domain, status code, and response times.
get_errors limit, since, summary, device, format
Get recent uncaught exceptions from the React Native app.
clear_errors device
Clear the error buffer.
get_bundle_errors limit
Get recent Metro compilation/transform errors.
evaluate_js expression, awaitPromise
Execute a JavaScript expression in the running React Native app and return the result. Use this for inspecting variables, calling functions, or querying app state.
list_devices rescan
List connected devices and debuggable targets from Metro bundler.
get_app_info
Get information about the connected React Native app (bundle URL, platform, device name).
get_connection_status
Check the connection status to Metro bundler.
reload_app timeout
Reload the connected app and verify a fresh runtime. Uses Page.reload, with a directed Metro message fallback only for a verified app/device peer.
symbolicate stack
Symbolicate a stack trace using Metro bundler source maps. Converts minified/bundled locations back to original source files.
get_redux_state path, compact
Get the current Redux state tree or a specific slice. Works without client SDK if Redux DevTools extension is present or store is exposed globally.
dispatch_redux_action type, payload
Dispatch a Redux action to the store.
get_redux_actions limit
Get recent Redux actions (requires metro-mcp client SDK for real-time tracking).
get_component_tree structureOnly, pageSize, cursor, maxDepth, maxNodes
Get a paged flat React component tree. Follow nextCursor to complete the snapshot and check traversal.complete before treating an empty page as authoritative.
find_components pattern, includeProps, maxDepth, maxNodes
Search for components by name inside the app runtime. Check traversal.complete before treating no matches as definitive.
inspect_component name, maxDepth, maxNodes
Get props, state, and hooks for the first exact component-name match, with traversal completeness metadata.
get_testable_elements maxDepth, maxNodes
Get elements with testID or accessibilityLabel. Check traversal.complete before treating an empty elements array as definitive.
get_storage_keys
List all AsyncStorage keys in the React Native app.
get_storage_item key
Read a specific AsyncStorage key value.
get_all_storage maxLength
Dump all AsyncStorage key-value pairs.
take_screenshot platform, delivery
Capture a screenshot from the connected iOS simulator or Android device.
list_simulators platform, bootedOnly
List available iOS simulators or Android emulators.
install_certificate certPath, platform
Install a root certificate on the iOS simulator or Android device.
get_native_logs platform, filter, lines
Get native platform logs from iOS simulator (syslog) or Android device (logcat).
app_lifecycle action, bundleId, appPath, platform
Launch, terminate, install, or uninstall an app on the simulator/emulator.
get_screen_orientation platform
Get the current screen orientation of the device.
open_deeplink url, platform
Open a URL or deep link on the connected iOS simulator or Android device.
list_url_schemes platform, bundleId
List URL schemes registered by an installed iOS app or Android package.
list_permissions platform, bundleId
List all app permission statuses on the connected iOS simulator or Android emulator. Returns compact text: one name=status line per permission.
grant_permission service, platform, bundleId
Grant a permission to the app on the connected iOS simulator or Android emulator.
revoke_permission service, platform, bundleId
Revoke a permission from the app on the connected iOS simulator or Android emulator.
reset_permissions service, platform, bundleId
Reset one or all permissions for the app on the connected iOS simulator or Android emulator. On iOS, omitting service resets all services. On Android, omitting service resets all runtime permissions.
open_app_settings platform, bundleId
Open the connected app's system settings page using React Native Linking.openSettings().
list_elements interactiveOnly, maxDepth, maxNodes
Get labelled or interactive elements from the focused React screen. Check traversal.complete before treating an empty elements array as definitive.
tap_element label, x, y, platform
Tap by label, testID, or logical device-point coordinates. Uses React handlers, then installed SimView or IDB on iOS and adb on Android. Coordinates use native input directly; native results identify the backend and dispatch state.
type_text text, testID, platform
Type text into an input field. Targets a specific input by testID/label, or the first visible TextInput. Uses the React handler first, then SimView or IDB on iOS and the selected ADB serial on Android.
long_press label, x, y, duration, platform
Long press using a React handler by label/testID, then semantic native input through SimView or IDB when the handler is unavailable. Explicit coordinates use native input directly; native results identify the backend and dispatch state.
swipe direction, platform
Scroll through React, then use installed SimView or IDB on iOS and the selected ADB serial on Android. Native results identify the backend and dispatch state.
press_button button, platform
Press a device button (HOME, BACK, VOLUME_UP, etc.).
get_navigation_state compact
Get the full React Navigation / Expo Router state tree including current route, params, and stack history.
get_current_route
Get the currently focused route name and params.
get_route_history
Get the navigation back stack / history.
list_routes
List registered route names from available navigation state. Uninitialized nested navigators are not discoverable.
audit_accessibility severity, maxDepth, maxNodes
Audit the current screen within bounded Fiber traversal limits. Checks labels, roles, testIDs, and alt text; returns issues, summary, and traversal coverage.
check_element_accessibility name, testID
Check accessibility properties of a specific component by name or testID.
get_accessibility_summary
Quick overview: counts of elements with and without proper accessibility props.
list_commands
List all custom commands registered by the app. Commands are registered on global.__METRO_BRIDGE__.commands or global.__METRO_BRIDGE_COMMANDS__.
run_command name, params, timeout
Execute a custom command registered by the app. Pass parameters as a JSON object.
start_test_recording
Inject interaction interceptors into the running app via the React fiber tree. Captures taps, text entry, long presses, keyboard submits, and scroll/swipe gestures — with no changes to your app code. Works with ScrollView, FlatList, SectionList, FlashList, and other scroll containers. Call stop_test_recording when done, then generate_test_from_recording to get the test.
stop_test_recording
Stop the active recording, retrieve all captured events, and store them for test generation. Returns a summary of what was recorded. Call generate_test_from_recording next to produce Appium, Maestro, or Detox test code.
generate_test_from_recording format, testName, platform, bundleId, includeSetup
Convert the most recent recording into a test file. Supports three formats: appium (WebdriverIO + Mocha), maestro (YAML), and detox (Jest). Call stop_test_recording first.
generate_wdio_config platform, bundleId, appPath, iosBundleId, androidPackageName, iosAppPath, androidAppPath, udid, deviceName, platformVersion, iosUdid, androidUdid, iosDeviceName, androidDeviceName, iosPlatformVersion, androidPlatformVersion, noReset, outputPath
Generate a minimal but runnable wdio.conf.ts for Appium + React Native testing, along with the npm install command.
add_recording_annotation note
Add a human-readable annotation (comment marker) to the current recording. Useful for labelling major flow checkpoints like "reached checkout", "error appeared here", "navigated to payment". Annotations appear as code comments in generated tests.
save_test_recording filename
Save the current recording events to disk as JSON so they can be reloaded later. Useful for regenerating the same flow in a different test format without re-recording. Files are saved to ~/.metro-mcp/recordings/<filename>.json.
load_test_recording filename
Load a previously saved recording from disk and make it available for test generation. After loading, call generate_test_from_recording with any format to regenerate the test. Use list_test_recordings to see available files.
list_test_recordings
List all previously saved test recordings in ~/.metro-mcp/recordings/. Returns filenames and sizes. Use load_test_recording to load one for test generation.
start_profiling samplingInterval
Start profiling the running React Native app. Primary path: injects into the React DevTools hook (__REACT_DEVTOOLS_GLOBAL_HOOK__) via evalInApp — captures all component render durations without requiring <Profiler> wrappers, works on all architectures. Fallback (legacy arch only): CDP Profiler domain for JS CPU call-graph sampling. Perform the interaction you want to measure, then call stop_profiling.
stop_profiling topN, includeNative
Stop profiling and return an analysis of the captured data. DevTools hook mode: returns top components by total render duration across all commits. CDP mode: returns top JS functions by self time and total time. Must call start_profiling first.
get_profile_status
Check whether profiling is active, which mode is in use, and whether a previous profile is available.
get_flamegraph
Return the current profiling results as a human-readable text chart. Shows React DevTools component profile (if captured), CPU flamegraph (if CDP profile captured), and React render data from <Profiler> components (if set up). Call stop_profiling first to populate the profile data.
get_react_renders clear
Read React render timing data collected via <Profiler onRender={trackRender}>. Returns all recorded renders sorted by actualDuration descending, with memoization savings from baseDuration. Requires importing trackRender from metro-mcp/client. Use clear=true to reset the buffer.get_memory_info
Get current JavaScript heap memory usage from the running app. Returns used heap, total heap, and heap size limit (when available). Call repeatedly to track memory growth over time or to detect leaks.
profile_action expression, extraMs, topN
Profile a specific JavaScript expression or code path in a single call. Starts profiling, evaluates the expression, waits for it to complete (plus optional extra duration), then stops and returns the top functions by self time. Use instead of calling start_profiling / stop_profiling manually for focused measurements.
start_heap_sampling samplingInterval
Start Hermes heap allocation sampling via CDP HeapProfiler. Records memory allocation call stacks to identify where objects are being allocated. Call stop_heap_sampling to retrieve the top allocation sites.
stop_heap_sampling topN
Stop heap allocation sampling and return the top allocation sites. Shows which functions are allocating the most memory, useful for diagnosing memory leaks. Must call start_heap_sampling first.
wait_for_element selector, timeout, pollInterval, maxDepth, maxNodes
Poll the component tree until an element matching the given testID or accessibilityLabel appears. Returns element info on success. Use after tap_element, navigate(), or any action that triggers async screen transitions or data loading — instead of immediately calling the next tool. Returns traversal metadata immediately when the bounded search is incomplete.
wait_for_condition expression, timeout, pollInterval
Poll a JavaScript expression in the app until it returns a truthy value, then return that value. Useful for waiting on state changes, loading flags, API responses, or any async condition. Example: wait for globalThis.myStore?.isLoaded === true.
wait_for_navigation routeName, timeout
Poll the active navigation route until it matches the expected route name, then return. Requires the navigation plugin to be set up (get_current_route must work). Use after tap_element on a link or after dispatching a navigate() action.
setup_statusline
Writes the Metro CDP connection status script to ~/.claude/metro-mcp-statusline.sh. Does not modify settings.json — tell the user to add it to their status line themselves (e.g. ask Claude: "/statusline add the script at ~/.claude/metro-mcp-statusline.sh"). Only works with Claude Code.
list_debug_globals detailed
Auto-discover well-known global debugging objects (Redux stores, Apollo Client, Expo Router, React DevTools hook, etc.) available in the app runtime.
inspect_at_point x, y, includeProps, maxDepth, maxNodes
Inspect the smallest measured host component at screen coordinates. Uses awaited Fabric/Paper measurement and returns traversal completeness metadata.
open_devtools open
Open the React Native DevTools debugger panel in Chrome. Connects through the CDP proxy so DevTools and the MCP can share the same Hermes connection.
get_app_directories bundleId, platform
Get known app sandbox directory paths (documents, cache, temp, library). Returns absolute paths usable with list_directory and read_file.
list_directory path, bundleId, platform, recursive
List files and directories in an app sandbox path. Call get_app_directories first to obtain the root path.
read_file path, bundleId, platform, encoding, maxBytes
Read the contents of a file from the app sandbox. Enforces a configurable size cap (default 50 KB, max 1 MB) to avoid flooding context.
get_file_info path, bundleId, platform
Get file or directory metadata: size, modification date, and whether it is a directory.
delete_file path, bundleId, platform, confirm
Delete a file from the app sandbox. Requires confirm: true to prevent accidental deletion.
get_build_info
Return build-time and runtime flags for the running React Native app: __DEV__, platform, OS version, RN version, Hermes engine, New Architecture, and expo-application fields if available.
get_env_vars filter, includeAll
Return a filtered subset of process.env from the running app. Credential-like keys (SECRET, KEY, TOKEN, PASSWORD, etc.) are redacted by default. Use filter to search by key name substring.
get_platform_constants
Return the full Platform.constants object from React Native, including OS-specific build details.
get_expo_config
Return expo-constants manifest/expoConfig fields if the app uses Expo, otherwise null.
Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.
Files it wrote
/tmp/ .config/ metro-mcp/ daemon-5f79370b78ff2c6b.json /tmp/ metro-mcp-status.json
Paths inside its sandbox, where its home folder is /tmp and its own folder cannot be written to.
Install facts
| License | MIT |
|---|---|
| Needs | node >=20.0.0 |
| Source | github.com/steve228uk/metro-mcp |
| Install scripts | None declared by it or anything installed with it. |
| Tarball | sha512-oq2ufjIYb1Dn4wWkQeZnQvTUQb+S/PLhUWX5T65bRDIeVkSFavnqfW16NUkHA8I1cxLIg5hc8yBk+X+rfhw2mA== |
Check this report yourself
This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.
Report as JSONExact text and tokenHow to verify it
Show it on your README
[](https://bragproof.smaverk.com/r/metro-mcp)
New version out? Ask for a fresh report.