mcpField
L
looktap

looktap

Local
lakpriya.comDeveloper Tools3Updated 3d ago
RepositoryVisit website

About looktap

looktap is an MCP server for controlling apps on iPhone and Android devices, including simulators and emulators. It is for AI agents that need to inspect screens, perform interactions, and check device logs or crashes.

Key features

  1. 01Read screen content as text
  2. 02Tap controls by label
  3. 03Type, swipe, and scroll
  4. 04Capture screenshots
  5. 05Inspect logs and crashes
  6. 06Check CPU, memory, and frame performance

Use cases

  1. 01Interact with an app on a connected phone
  2. 02Exercise an app in a simulator or emulator
  3. 03Inspect a screen after an action
  4. 04Review app crashes and performance

MCP support

The server exposes device interaction and inspection tools to MCP clients, including screen reading, taps, typing, screenshots, logs, and crash reports. It installs and runs the looktap CLI.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "lakpriya1s-looktap": {
      "command": "npx",
      "args": [
        "-y",
        "@looktap/mcp"
      ]
    }
  }
}
Run commandnpx -y @looktap/mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@looktap/mcp0.7.1

Tools

16

Saved tool list · updated 1w ago

ParameterTypeRequiredDescription
allbooleanNoInclude unlabelled elements
devicestringNoSimulator UDID or adb serial, when several are booted. Remembered for later calls
platformenumNoWhen both an iOS and an Android device are booted. Remembered for later callsios | android

Details

From the project README

@looktap/mcp

The MCP server for looktap: it lets your AI agent see, use and control the apps on your phone: an iPhone or Android device (simulator, emulator or real phone), and any app on it. It reads the screen as text, taps by label, types, swipes, takes screenshots and reads logs and crashes.

This package only starts the server. Everything else lives in @looktap/cli, which it installs, so you always get the latest looktap. If you already have the CLI installed, looktap mcp is the same server.

Set up

Claude Code

claude mcp add looktap -- npx -y @looktap/mcp

Claude Desktop, Cursor, VS Code and other clients

{
  "mcpServers": {
    "looktap": { "command": "npx", "args": ["-y", "@looktap/mcp"] }
  }
}
  • Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Cursor: ~/.cursor/mcp.json

Desktop apps start servers with a minimal PATH, so if yours can't find npx (common with nvm), install the CLI with npm install -g @looktap/cli and paste the config that looktap mcp --config prints. It uses absolute paths.

Requirements

  • Node 18+
  • iPhone: macOS with Xcode, and a simulator or a paired iPhone (a free Apple ID is enough). The looktap tool's boot "iPhone 16 Pro" starts a simulator, and devices lists what's connected
  • Android: adb, with an emulator (boot <AVD name> starts one) or a phone with USB or wireless debugging

Tools

ls, tap, tap_xy, long_press, fill, type, key, hide_keyboard, swipe, scroll_to, back, home, wait, screenshot (returns the image), logs, crashes, perf (CPU, memory, threads, or frames and jank), and looktap for any other command (devices, boot, capabilities, stop, expect, test, apps, launch --time …). Actions return the settled screen unless ls: false.

Full docs: https://lakpriya.com/looktap/

License

AGPL-3.0-only

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.