OmniDebugLink MCP Server

OmniDebugLink provides remote debugging and automated testing for iOS, Android, Unity, Godot, Flutter, and React Native/Web via Model Context Protocol (MCP). It uses a real-device workflow to inspect and drive running apps, including UI tree access, screenshots, taps/swipes/types, and log reading, without USB, emulator, or shared network.

🛠️ Key Features

Remote debug across multiple app platforms (iOS/Android/Unity/Godot/Flutter/RN/Web)
UI tree inspection on real-device
Screenshot capture
Tap, swipe, and type interactions
Read logs and measure performance
Automated testing capability

🚀 Use Cases

Enable AI coding tools to inspect a running app remotely
Conduct automated tests on real devices
Debug app UI and behavior using AI coding tool workflows

⚡ Developer Benefits

Works over MCP with AI coding tools (e.g., Claude Code, Cursor, Codex, Gemini CLI)
Uses a device token and a small client SDK in the app
Requires one outbound WebSocket from the device

⚠️ Limitations

Not stated that it works with emulators, USB connections, or shared networks

OmniDebugLink

Remote debugging and automated testing on real devices — from anywhere.

Add a small client SDK to your app, connect it with a device token, and any AI coding tool (Claude Code, Cursor, Codex, Gemini CLI, …) can inspect and drive the running app over Model Context Protocol: dump the UI tree, take screenshots, tap, swipe, type, read logs, measure performance — no USB cable, no shared network, no emulator.

code

Your App ──wss──> OmniDebugLink relay ──MCP──> AI coding tool

One outbound WebSocket from the device — works across networks, behind NAT, on real hardware.

The AI side sees plain MCP tools: list_devices → run_task / device_status / list_tasks …

One token pair = one device seat. Tokens are per-device; never embed one in a release build — release use goes through the conditional pattern.

Client SDKs

Platform

Install

Repo

Unity

Package Manager → add from git URL

omnidebuglink_unity

Android

JitPack: com.github.omnidebuglink:omnidebuglink_android:<tag>

omnidebuglink_android

Flutter

pubspec git dependency (ref: tag)

omnidebuglink_flutter

iOS / macOS

Swift Package (iOS 15+ / macOS 12+)

omnidebuglink_apple_swift

React Native

npm i omnidebuglink/omnidebuglink_react_native#<tag>

omnidebuglink_react_native

Godot

copy the addons/omni_debug_link/ folder (Godot ≥ 4.2)

omnidebuglink_godot

Web

CDN build via jsDelivr (@<tag>)

omnidebuglink_web

Each SDK repo has the full install steps and task tables for its platform. Pin a version tag (#vX.Y.Z / ref: / @vX.Y.Z) in production hosts.

Quickstart

Create a device token pair at the console (free during the public beta).

Connect your app: add the SDK for your platform and start it with the token — freely in debug builds; in release builds only via the conditional pattern (runtime-issued token, never embedded).

Add the MCP server to your AI tool (OAuth login in the browser):

bash

claude mcp add --transport http odl https://api.omnidebuglink.dev/mcp

Works with any MCP client: Cursor, Codex CLI, Gemini CLI, …

Ask the AI to list_devices and start driving the device.

Building a client for another platform?

Any platform with a WebSocket client can join — the wire protocol is a single JSON frame format:

→ Third-Party Client Development Guide — protocol spec, a portable reference implementation, known pitfalls, and a pre-deployment verification checklist. AI coding agents can implement a compliant client from this guide alone, without reading any SDK source.

Install

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://api.omnidebuglink.dev/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "omnidebuglink": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.omnidebuglink.dev/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

OmniDebugLink

OmniDebugLink MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

OmniDebugLink

Client SDKs

Quickstart

Integrating an SDK into your app

Building a client for another platform?

Links

Install

Remote endpoint

Related servers