@tapflowio/mcp-server

Model Context Protocol server for tapflow — lets Claude Code, Codex, and any MCP-compatible LLM agent control iOS simulators and Android emulators as native tools.

Setup

npm install -g @tapflowio/mcp-server

Point it at your tapflow relay:

// e.g. Claude Code: .mcp.json
{
  "mcpServers": {
    "tapflow": {
      "command": "tapflow-mcp",
      "env": {
        "TAPFLOW_RELAY_URL": "ws://localhost:4000",
        "TAPFLOW_TOKEN": "tflw_pat_..." // view-scope PAT (not needed for a localhost relay WS, but REST endpoints require it)
      }
    }
  }
}

Tools

list_devices, connect_device, disconnect_device, boot_device, screenshot, query_ui_tree, run_flow, tap, swipe, type_text, press_key, press_button, install_app, launch_app, list_builds

• query_ui_tree returns the accessibility tree as { role, label, identifier, frame, enabled } with frames normalized 0-1 — tap by element instead of guessing coordinates from screenshots.
• run_flow replays a @tapflowio/flow-runner YAML flow deterministically — author once with the agent, replay with zero LLM calls.

Full guide: tapflow.dev/guide/mcp-server

License

MIT — part of the tapflow project.