What is MCP and how does Gaze use it?

MCP (Model Context Protocol) is a standard protocol that allows AI assistants to interact with external tools. Gaze includes a built-in MCP server with 54 tools, enabling AI clients like Claude Desktop, Claude Code, and Cursor to directly control Android devices — managing apps, automating UI, capturing network traffic, running workflows, and more.

How do I connect Gaze to Claude or Cursor?

For Claude Desktop, add Gaze to your claude_desktop_config.json with the command path and --mcp flag. For Claude Code CLI, run: claude mcp add gaze -- /path/to/Gaze --mcp. For Cursor, add the same config to .cursor/mcp.json in your project root.

Gaze

For Android

Mirror · Files · Apps · Shell · Logcat · Proxy · Recording · UI Inspector · Workflow · Sessions · MCP

Download

View Source

macOS · Windows · Linux

Mirror & Recording

Low-latency scrcpy mirroring with audio forwarding. Keyboard and mouse control. Multi-device simultaneous recording. Background recording with system tray.

File Manager

Drag-and-drop upload and download. Copy, cut, paste, rename, delete. Navigate system directories. Batch file operations.

App Manager

Drag-and-drop APK/XAPK/AAB install. Export APK to local. Uninstall, force stop, clear data. View package details, permissions, activities, services.

Logcat

Real-time log streaming with filters by package, tag, level. Regex search. Pre-filter and exclude rules. Export logs to file.

Network Proxy

HTTP/HTTPS traffic capture with MITM decryption. Mock rules, breakpoints, URL remapping, and auto-rewrite. WebSocket support. Bandwidth throttling and latency simulation.

Performance Monitor

Real-time CPU, memory, FPS, network I/O, and battery monitoring. Per-app resource tracking. Process-level detail with memory breakdown.

Session & Events

Unified event timeline combining logcat, network, touch, and device events. Session recording with video sync. Full-text search and bookmarks. Export session data.

Workflow Automation

Visual node-based workflow editor with 30+ step types. Conditional branching, variables, sub-workflows. Step-by-step debugging. Session integration for test reporting.

UI Inspector

Browse full UI hierarchy tree. Inspect element properties, bounds, and attributes. Touch recording for automation scripts. Element-based actions with selectors.

MCP Integration Model Context Protocol

Gaze includes a built-in MCP server, allowing AI assistants like Claude and Cursor to directly control Android devices — device management, app operations, UI automation, network capture, and more.

Setup

C Claude Desktop

Add to claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/
Windows: %APPDATA%\Claude\

{ "mcpServers": { "gaze": { "command": "/Applications/Gaze.app/Contents/MacOS/Gaze", "args": ["--mcp"] } } }

> Claude Code (CLI)

Run in terminal:

claude mcp add gaze -- /Applications/Gaze.app/Contents/MacOS/Gaze --mcp

C Cursor

Add to .cursor/mcp.json in your project root:

{ "mcpServers": { "gaze": { "command": "/Applications/Gaze.app/Contents/MacOS/Gaze", "args": ["--mcp"] } } }

Replace the path with the actual location of your Gaze binary. On Windows use the .exe path.

Available Tools (54)

📱 Device Management 11 tools ▶

device_listList connected devices

device_infoGet device details

device_connectConnect via network

device_disconnectDisconnect device

device_pairWireless pairing

device_wirelessSwitch to wireless ADB

device_ipGet device IP

adb_executeRun any ADB command

aapt_executeAPK analysis

ffmpeg_executeVideo/audio processing

ffprobe_executeMedia file analysis

📦 App Management 8 tools ▶

app_listList installed apps

app_infoApp details

app_startLaunch app

app_stopForce stop

app_runningCheck running status

app_installInstall APK

app_uninstallUninstall app

app_clear_dataClear app data

📷 Screen Control 4 tools ▶

screen_screenshotTake screenshot (base64)

screen_record_startStart recording

screen_record_stopStop recording

screen_recording_statusCheck recording state

🎯 UI Automation 6 tools ▶

ui_hierarchyGet UI layout tree

ui_searchSearch UI elements

ui_tapTap element/coordinates

ui_swipeSwipe gesture

ui_inputInput text

ui_resolutionGet screen resolution

📊 Session Management 6 tools ▶

session_createCreate tracking session

session_endEnd session

session_activeGet active session

session_listList sessions

session_eventsQuery events

session_statsSession statistics

🔄 Workflow 12 tools ▶

workflow_listList workflows

workflow_getGet workflow details

workflow_createCreate workflow

workflow_updateUpdate workflow

workflow_deleteDelete workflow

workflow_runRun on device

workflow_stopStop execution

workflow_pausePause execution

workflow_resumeResume execution

workflow_step_nextStep-by-step debug

workflow_statusCheck run status

workflow_execute_stepExecute single step

🌐 Network Proxy 3 tools ▶

proxy_startStart HTTP/HTTPS proxy

proxy_stopStop proxy

proxy_statusGet proxy status

🎥 Video Processing 4 tools ▶

video_frameExtract frame at time

video_metadataGet video metadata

session_video_frameFrame from session recording

session_video_infoSession video info

Resources

gaze://devicesConnected Android devices (JSON)

gaze://devices/{deviceId}Device details

gaze://sessionsActive and recent sessions (JSON)

workflow://listAll saved workflows (JSON)

workflow://{workflowId}Workflow details with steps

Troubleshooting

macOS "App is damaged and can't be opened"

Gatekeeper blocks unsigned apps. Run this to fix:

sudo xattr -cr /Applications/Gaze.app

Windows "Windows protected your PC"

Click "More info" → "Run anyway"