Argent MCP Server: Setup for Claude Code, Cursor and Other Apps

• Lists the simulators, emulators, devices and apps you can drive

  Shows iOS simulators, Android emulators and devices, Chromium or Electron apps, Fire TV (Vega) devices and HarmonyOS phones and emulators.

  Try: “What simulators and emulators do I have available?”

  Read · list-devices

• Starts a simulator or emulator, or launches an Electron app

  Boots an iOS simulator, Android emulator, Vega virtual device or HarmonyOS emulator, or starts your Electron app.

  Try: “Boot an iPhone simulator.”

  Runs code · boot-device

• Opens an app on the device

  Starts an app by its bundle ID on iOS or package name on Android, with optional launch arguments.

  Try: “Open my app on the simulator.”

  Runs code · launch-app

• Closes and reopens an app

  Terminates the app and launches it again.

  Try: “Restart the app.”

  Runs code · restart-app

• Installs or reinstalls an app

  Installs the app you point to and clears its data and granted permissions.

  Try: “Reinstall the latest build on the emulator.”

  Delete · reinstall-app

• Opens a link or deep link on the device

  Opens a web address or app URL scheme on the device.

  Try: “Open myapp://settings on the simulator.”

  Runs code · open-url

• Grants, denies or resets an app permission

  Changes a runtime permission such as camera or location without going through the Settings screens.

  Try: “Grant the app camera permission.”

  Write · settings-permissions

• Changes the device orientation

  Sets portrait or either landscape orientation.

  Try: “Rotate the simulator to landscape.”

  Write · rotate

• Folds or unfolds a foldable device

  Sets a foldable simulator or emulator to a posture or hinge angle.

  Try: “Unfold the foldable emulator.”

  Write · fold

• Shakes the device

  Sends a shake gesture, for example to open a dev menu.

  Try: “Shake the device.”

  Write · shake

• Presses a hardware button

  Presses home, back, power, volume, app switch or the action button.

  Try: “Press the home button.”

  Write · button

• Presses a TV remote button

  Sends remote or D-pad presses to Apple TV, Android TV or Fire TV.

  Try: “Press the down arrow twice on the Apple TV.”

  Write · tv-remote

• Stops the connection to one device

  Ends the session for one device and frees its resources.

  Try: “Stop the connection to the iPhone simulator.”

  Runs code · stop-simulator-server

• Stops everything a device uses

  Stops simulator servers, native devtools and TV helpers for a device.

  Try: “Shut down all Argent device services.”

  Runs code · stop-all-simulator-servers

• Stops the Metro bundler on a port

  Stops the React Native Metro bundler listening on the port you give.

  Try: “Stop Metro on port 8081.”

  Runs code · stop-metro

• Takes a screenshot of the device

  Captures the current screen.

  Try: “Take a screenshot of the simulator.”

  Read · screenshot

• Reads what is on screen as text

  Returns the accessibility or DOM tree for the current screen so the assistant can find buttons and fields.

  Try: “Describe what is on the screen.”

  Read · describe

• Compares two screenshots

  Compares two PNG images and summarizes the visual differences.

  Try: “Compare the baseline screenshot with the new one.”

  Files · screenshot-diff

• Waits until the screen stops changing

  Blocks until content has rendered and the screen is steady.

  Try: “Wait for the screen to finish loading.”

  Read · await-screen-idle

• Waits for a screen element to appear or change

  Blocks until an element reaches a state you ask for, instead of checking over and over.

  Try: “Wait until the Continue button is enabled.”

  Read · await-ui-element

• Taps the screen

  Taps at coordinates given as fractions of the screen.

  Try: “Tap the Sign in button.”

  Write · gesture-tap

• Swipes or drags between two points

  Performs a smooth swipe or drag.

  Try: “Swipe up to scroll the list.”

  Write · gesture-swipe

• Scrolls a Chromium app

  Scrolls with mouse-wheel events in an Electron or Chromium app.

  Try: “Scroll down the page.”

  Write · gesture-scroll

• Drags with the mouse in a Chromium app

  Presses, moves and releases the mouse in a Chromium app.

  Try: “Drag the slider to the right.”

  Write · gesture-drag

• Pinches to zoom

  Performs a pinch around a center point.

  Try: “Zoom into the map.”

  Write · gesture-pinch

• Rotates content with two fingers

  Draws a two-finger arc to rotate what is on screen.

  Try: “Rotate the photo 90 degrees.”

  Write · gesture-rotate

• Sends a custom touch sequence

  Plays any sequence of touch events for complex gestures.

  Try: “Draw a circle on the canvas.”

  Write · gesture-custom

• Types text or presses special keys

  Types into the focused field or presses keys such as Enter.

  Try: “Type my email into the field.”

  Write · keyboard

• Pastes text via the clipboard

  Puts text on the device clipboard and pastes it. Works on simulators and emulators only.

  Try: “Paste this address into the search box.”

  Write · paste

• Runs several interaction steps in one call

  Executes a list of steps together to save round trips.

  Try: “Open Settings, tap Wi-Fi and take a screenshot.”

  Write · run-sequence

• Starts recording the screen

  Records the device screen to an h264 mp4 file.

  Try: “Start recording the screen.”

  Write · screen-recording-start

• Stops the recording and returns the video

  Stops recording and retrieves the video file.

  Try: “Stop recording and give me the video.”

  Files · screen-recording-stop

• Connects to the app's JavaScript debugger

  Attaches to the JS runtime of a React Native or Chromium app.

  Try: “Connect the debugger to the app.”

  Runs code · debugger-connect

• Shows the debugger connection status

  Reports whether the debugger is connected and any diagnostics.

  Try: “Is the debugger connected?”

  Read · debugger-status

• Runs JavaScript inside the app

  Executes JavaScript in the app's runtime, Hermes on a device or V8 in Chromium, and returns the result.

  Try: “Evaluate the current user object in the running app.”

  Runs code · debugger-evaluate

• Shows the current screen as React components

  Returns a compact text tree of the React components on screen.

  Try: “Show the React component tree.”

  Read · debugger-component-tree

• Inspects the React component at a point

  Returns the component hierarchy at the screen coordinate you give.

  Try: “What component is at this spot?”

  Read · debugger-inspect-element

• Summarizes the app's console logs

  Returns the console logs captured from the app.

  Try: “Show the console errors from the app.”

  Read · debugger-log-registry

• Reloads the Metro bundle

  Restarts the bundle without restarting the native process.

  Try: “Reload the JavaScript bundle.”

  Runs code · debugger-reload-metro

• Lists the app's captured web requests

  Returns HTTP requests captured from the running app.

  Try: “Show the failed network requests.”

  Read · view-network-logs

• Shows one captured request in full

  Returns full details of a request by its ID.

  Try: “Show details of that failing request.”

  Read · view-network-request-details

• Lists and manages tabs in a Chromium app

  Lists, switches, opens and closes tabs or browser windows in a Chromium or Electron app.

  Try: “List the open tabs.”

  Write · chromium-tabs

• Reads and writes cookies in a Chromium app

  Reads and writes cookies, including HttpOnly ones.

  Try: “Show the session cookie of the app.”

  Write · chromium-cookies

• Reads and writes browser storage in a Chromium app

  Reads and writes localStorage and sessionStorage of the active page.

  Try: “Show localStorage for the page.”

  Write · chromium-storage

• Starts CPU and React commit profiling

  Starts CPU profiling and React commit capture on a connected React Native app. If another session owns the profiler it reports who, and only takes over when forced.

  Try: “Start profiling my app, then I will open the settings screen.”

  Runs code · react-profiler-start

• Stops profiling and keeps the data

  Stops the CPU profile and collects the React commit tree, which is stored in memory for the analysis tools.

  Try: “Stop the profiler and tell me how many React commits it captured.”

  Runs code · react-profiler-stop

• Checks the profiler session

  Reports whether a profiling session is running and who owns it, with no side effects. Useful after a disconnect.

  Try: “Is a profiling session still running?”

  Read · react-profiler-status

• Writes a performance report from a React profile

  Builds a markdown report of slow React commits (16 ms or more) with render cascades, root causes and a table of top components, and saves the raw data to disk.

  Try: “Analyze the profile and list the slowest commits.”

  Files · react-profiler-analyze

• Finds the source of a React component

  Looks up a named component in your project and returns its file, line, whether it is memoized and about 50 lines of code.

  Try: “Show me the source of the ProductList component.”

  Files · react-profiler-component-source

• Lists the hottest JavaScript functions

  Returns the top functions by self time from the Hermes CPU profile, for work that is not React rendering.

  Try: “Which functions use the most CPU in this profile?”

  Read · react-profiler-cpu-summary

• Counts component re-renders on a live app

  Scans the live React fiber tree and returns a table of the components that rendered most, with durations. No profiling session needed.

  Try: “Which components re-render the most right now?”

  Read · react-profiler-renders

• Returns the React fiber tree

  Returns the component hierarchy as JSON with render durations, handy for tracing a library component or checking that the React Compiler is active.

  Try: “Dump the fiber tree under the checkout screen.”

  Read · react-profiler-fiber-tree

• Starts native profiling

  Starts Instruments (xctrace) on iOS or Perfetto on Android to capture CPU, hangs and memory for the running app.

  Try: “Start native profiling while I scroll the feed.”

  Runs code · native-profiler-start

• Stops native profiling and exports the trace

  Stops xctrace or the Perfetto daemon and exports the trace data to disk.

  Try: “Stop native profiling and export the trace.”

  Runs code · native-profiler-stop

• Writes a report from a native trace

  Parses the exported iOS or Android trace into a markdown report of CPU hotspots, UI hangs and memory leaks or RSS growth.

  Try: “Analyze the native trace and show UI hangs.”

  Files · native-profiler-analyze

• Queries the CPU profile

  Answers targeted questions about the Hermes CPU profile, such as top functions overall or CPU use in a time window. Needs a stopped React profile.

  Try: “What was the CPU doing during the slow commit?”

  Read · profiler-cpu-query

• Queries React commits

  Looks up commits by component, time range or index, or builds a parent-child cascade tree. Needs a stopped React profile.

  Try: “Show every commit where ProductList rendered and why.”

  Read · profiler-commit-query

• Queries a native trace

  Digs into a native trace: stacks during a hang, who calls a function, CPU per thread, or leak stacks. Needs an analyzed native trace.

  Try: “Show the stacks during hang number 2.”

  Read · profiler-stack-query

• Joins React and native profiles

  Matches native hangs to React commits by wall-clock time. Needs both the React and the native analysis first.

  Try: “Correlate the native hangs with React commits.”

  Read · profiler-combined-report

• Reloads a saved profiling session

  Lists saved sessions or restores one from disk so the query tools can read it again without a new recording.

  Try: “List my saved profiling sessions and load the latest.”

  Files · profiler-load

• Reads your project setup

  Returns a snapshot of a mobile project: package.json, Metro and Babel config, app.json, eas.json, platform folders, lockfile type, .env key names (not values), installed tool versions and CI config type.

  Try: “Gather my workspace data and tell me which React Native setup I have.”

  Files · gather-workspace-data

• Checks native devtools on iOS

  Reports whether the native devtools library is injected into the running iOS app.

  Try: “Are the native devtools connected to my app?”

  Read · native-devtools-status

• Lists native network requests

  Returns requests captured at the NSURLProtocol level, including native modules and background transfers that JavaScript network logs miss.

  Try: “Show native-level requests from the last minute.”

  Read · native-network-logs

• Finds UIViews by property

  Searches the running iOS app for views by class, accessibility identifier, label, tag or nativeID and returns their frames and properties.

  Try: “Find the view with the identifier checkout-button.”

  Read · native-find-views

• Dumps the full UIKit view tree

  Returns the complete UIKit view tree. Output can reach hundreds of KB, so the docs advise native-find-views for most questions.

  Try: “Dump the view hierarchy with SwiftUI internals pruned.”

  Read · native-full-hierarchy

• Reads the native accessibility tree

  Returns the screen's accessibility elements with frames, tap points in points and normalized tap points, and traits.

  Try: “Describe the screen using the native accessibility tree.”

  Read · native-describe-screen

• Inspects the view at a point

  Returns the deepest visible UIView at a screen point, ignoring whether it accepts touches, to identify unlabeled icons or overlays.

  Try: “What view is drawn at x 120, y 300?”

  Read · native-view-at-point

• Inspects the view that would get a touch

  Returns the deepest UIView at a point that would actually receive the touch, to explain a tap that does nothing.

  Try: “Which view receives a tap at x 120, y 300?”

  Read · native-user-interactable-view-at-point

• Starts recording an e2e test

  Creates or resets a YAML file under .argent/e2e/ and starts recording device steps into it.

  Try: “Start recording an e2e test called login.”

  Write · e2e-start-recording

• Runs a tool and records it as a step

  Executes one Argent tool and appends it as a step in the e2e test being recorded.

  Try: “Tap the login button and record it as a step.”

  Runs code · e2e-add-step

• Adds an echo step

  Records an echo step in the e2e test, used as a progress marker in replays.

  Try: “Add an echo step saying the form is filled.”

  Write · e2e-add-echo

• Records a local script step

  Runs a local .mjs file you point to and records it as a step in the e2e test. This is arbitrary code on your machine.

  Try: “Run scripts/seed.mjs and record it as a step.”

  Runs code · e2e-add-script

• Finishes an e2e recording

  Closes the e2e test being recorded and saves the YAML file.

  Try: “Finish recording the login test.”

  Write · e2e-finish-recording

• Reads an e2e test's precondition

  Returns the precondition the test's author recorded, without running the test.

  Try: “What does the login e2e test need before it runs?”

  Files · e2e-read-prerequisite

• Replays a saved e2e test

  Runs a saved YAML e2e test step by step and returns a per-step report. The first failure stops the run.

  Try: “Run the login e2e test and report the result.”

  Runs code · e2e-execute

• Applies a pending Argent update

  Updates the Argent install, global, local or both. The docs say to call it only after you agree to the update.

  Try: “Update Argent to the latest version.”

  Runs code · update-argent

• Silences update reminders

  Hides the update notification for a number of hours you give.

  Try: “Remind me about the Argent update in 24 hours.”

  Write · dismiss-update

• Stages a design variant (macOS)

  Stages one design alternative for one on-screen element and returns at once, so you can compare variants later. Registered on macOS only.

  Try: “Propose a second layout for the Settings header.”

  Write · propose_variant

• Waits for you to pick a variant (macOS)

  Blocks until you finish choosing among the staged design variants. Registered on macOS only.

  Try: “Wait for me to pick a variant.”

  Read · await_user_selection

Watch out for

• It can run code inside your app

  One tool executes JavaScript in the app's runtime, and the device tools tap and type as a user would. Use it on test builds only. github.com

• Reinstalling an app clears its data

  The reinstall tool wipes app data and granted permissions. Back up anything you need on the device first. github.com

• It can read cookies and browser storage

  For Chromium and Electron apps it reads and writes cookies, including HttpOnly ones, and localStorage. Do not point it at a signed-in personal session. github.com

• Some tools run local code or update the install

  e2e-add-script runs a .mjs file you name, e2e-execute replays saved tests that can include such scripts, and update-argent updates the installed package. Treat these like running a script from your own repo. github.com

• Usage telemetry is on unless you turn it off

  Argent's privacy notice says telemetry is enabled by default and lists install and update progress, which tools are called and whether they succeeded, and which AI coding tool drives it. It says it does not collect source code, file paths, tool inputs or device identifiers. Turn it off with `argent telemetry disable`. Some bundled binaries are proprietary. github.com

Security advisories