AppReveal

AppReveal

**[unlikeotherai.github.io/AppReveal](https://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](docs/ios.md) 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](docs/macos.md) 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](docs/android.md) for full setup.

Flutter

// pubspec.yaml
dependencies:
  appreveal: