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

• Explains how to test a mobile feature with these tools

  Returns a written guide for the assistant: which cases to cover, what cannot be tested, how to avoid false bug reports and how to save a flow. Ask for it once before a test session.

  Try: “Read the testing guide before we test the checkout screen.”

  Read · get_testing_guide

• Lists the app builds on your relay

  Shows every app and build your tapflow relay holds, with the build numbers the install and launch tools need.

  Try: “Which builds of our app are on the relay?”

  Network · list_builds

• Lists past flow runs

  Shows recorded flow runs from CI and local machines, newest first, filtered by status, build or flow name.

  Try: “Show the failed CI flow runs from today.”

  Network · list_runs

• Shows why one flow run failed

  Returns the steps, failure message and screen of a recorded run, and says whether the app or the environment failed. Screenshots of up to four failed flows come back as images.

  Try: “Why did run 42 fail?”

  Network · get_run

• Lists simulators and emulators

  Shows the iOS simulators and Android emulators registered on your relay, with their session and device IDs.

  Try: “What devices can I test on?”

  Network · list_devices

• Joins a device session

  Opens a session on a device so you can control it. Boot, install and launch need this first.

  Try: “Connect to the iPhone 15 Pro simulator.”

  Write · connect_device

• Leaves a device session

  Ends your session on a device. The device keeps running.

  Try: “Disconnect from the simulator.”

  Write · disconnect_device

• Starts a simulator or emulator

  Boots the device in your session and waits up to 3 minutes until it is ready.

  Try: “Boot the Pixel emulator.”

  Write · boot_device

• Powers a simulator or emulator off

  Stops the device to free resources or force a cold start next time. This differs from disconnect, which leaves it running.

  Try: “Shut the iPhone simulator down.”

  Write · shutdown_device

• Reads the buttons and fields on screen

  Returns the interactive elements on the current screen with role, label, position and whether they are enabled. The assistant uses it to tap an element instead of guessing coordinates.

  Try: “List what is on the current screen.”

  Network · query_ui_tree

• Replays a saved test flow

  Runs a flow written in YAML, either inline or from a file path on your machine, with no model in the loop. Steps include launch, tap, type, scroll, swipe, open a URL and assert, and a clearState step wipes the app's data. On failure it saves a screenshot to a temp file.

  Try: “Replay login.yaml on the connected device.”

  Write · run_flow

• Takes a picture of the device screen

  Captures the device's current screen and returns the image so the assistant can look at it.

  Try: “Take a screenshot and tell me what screen this is.”

  Network · screenshot

• Taps at a screen position

  Taps at pixel coordinates that match the latest screenshot.

  Try: “Tap the Sign in button.”

  Write · tap

• Swipes between two points

  Swipes from one pixel position to another, for scrolling or dismissing.

  Try: “Scroll down the list.”

  Write · swipe

• Types text on the device

  Types the given text into the field that has focus on the device.

  Try: “Type test@example.com into the email field.”

  Write · type_text

• Presses a keyboard key

  Presses a key by its browser key name, such as Enter, Backspace, Escape or Tab.

  Try: “Press Enter.”

  Write · press_key

• Presses a hardware button

  Presses a device button by a cross-platform name such as home, lock, volume up or volume down.

  Try: “Press the home button.”

  Write · press_button

• Installs a build on the device

  Installs a build from your relay onto the connected device and waits up to 2 minutes.

  Try: “Install build 118 on the iPhone simulator.”

  Write · install_app

• Opens an installed app

  Launches an installed build, optionally with launch arguments or environment values, and waits up to 15 seconds.

  Try: “Launch build 118.”

  Write · launch_app

Watch out for

• It can act on any device your token reaches

  The assistant can boot, shut down, install and launch on shared simulators and emulators. Create a token for test devices only. github.com

• Flows can clear an app's data

  run_flow supports a clearState step that wipes the app's stored data on the device. Check a flow before you replay it on a device that holds data you need. github.com

• run_flow reads a file path you give it

  It opens a flow file from the folder the server runs in, and saves a failure screenshot to a temp file. github.com

• The project calls it experimental

  The docs warn of rough edges in selector matching and timing right after an app launches. github.com

Security advisories