AppReveal

unlikeotherai.github.io/AppReveal

Debug-only in-app MCP server for iOS, macOS, Android, Flutter, and React Native. Lets LLM agents discover, inspect, and control native apps over the local network -- like Playwright for native, but with direct access to app state, navigation, network traffic, DOM, and diagnostics.

How it works

Your App (debug build)                    External Agent
 +-- AppReveal framework                   +-- mDNS browse for _appreveal._tcp
      +-- MCP Server (Streamable HTTP)  <---+-- MCP client (curl, SDK, Claude, etc.)
      +-- mDNS advertisement               +-- LLM orchestration
      +-- Screen/element/state bridges
      +-- WebView DOM bridge

1. App calls AppReveal.start() in a debug build
2. Framework starts an HTTP server on a dynamic port
3. mDNS advertises the service as _appreveal._tcp on the LAN
4. Agent discovers the service, connects, and calls MCP tools

AppReveal shares the same core MCP surface across platforms. macOS adds desktop-specific window and menu tools on top of the shared native and web view tools.

Quick start

iOS

// Package.swift
.package(url: "https://github.com/UnlikeOtherAI/AppReveal.git", from: "0.8.0")

#if DEBUG
AppReveal.start()
#endif

See iOS guide for full setup.

macOS

// Package.swift
.package(url: "https://github.com/UnlikeOtherAI/AppReveal.git", from: "0.8.0")

#if DEBUG
AppReveal.start()
#endif

See macOS guide for full setup.

Android

// build.gradle.kts
debugImplementation("com.appreveal:appreveal")
releaseImplementation("com.appreveal:appreveal-noop")

if (BuildConfig.DEBUG) {
    AppReveal.start(this)
}

See Android guide for full setup.

Flutter

// pubspec.yaml
dependencies:
  appreveal:
    path: Flutter/appreveal

void main() {
  WidgetsFlutterBinding.ensureInitialized();
  AppReveal.start(); // no-ops in release builds
  runApp(AppReveal.wrap(const MyApp()));
}

// In MaterialApp:
MaterialApp(
  navigatorObservers: [AppReveal.navigatorObserver],
  ...
)

See Flutter guide for full setup.

React Native

npm install react-native-appreveal
cd ios && pod install

import { AppReveal, AppRevealFetchInterceptor } from 'react-native-appreveal';

if (__DEV__) {
  AppReveal.start();
  AppRevealFetchInterceptor.install();
}

See React Native guide for full setup.

MCP tools

UI and navigation

Tool	Description
list_windows	List visible app windows and their IDs
get_screen	Current screen identity, controller/activity chain, confidence score
get_elements	All visible interactive elements with id, type, frame, safe-area data, actions
get_view_tree	Full view hierarchy with class, frame, safe-area data, properties, accessibility info
tap_element	Tap by element identifier (buttons, cells, controls)
tap_text	Tap by visible text content (finds text, walks to tappable ancestor)
tap_point	Tap at screen coordinates
type_text	Type text into a field (by element ID or current responder)
clear_text	Clear a text field
scroll	Scroll a container (up/down/left/right)
scroll_to_element	Scroll until an element is visible
screenshot	Capture screen or element as base64 PNG/JPEG
select_tab	Switch tab bar tabs by index
navigate_back	Pop the navigation stack
dismiss_modal	Dismiss the topmost modal
open_deeplink	Open a URL in the app

All native UI tools and all web view tools accept an optional window_id parameter from list_windows. If omitted, AppReveal targets the current key window.

macOS desktop tools

| Tool | Description | |--

... View full README on GitHub