Layout Debug MCP Server

Stop describing UI to your AI agent in words. Alt+click any layer in your running page or Android app and type the change in its chat. Your agent (Claude Code, Codex, Cursor, Copilot…) gets the…

Local serverstdioMIT

What is the Layout Debug MCP Server?

layout-debug-mcp is an MCP project maintained in the antonchuraev99/layout-debug-mcp repository. The maintainer describes its purpose as “Stop describing UI to your AI agent in words. Alt+click any layer in your running page or Android app and type the change in its…”. Read the project documentation for the complete scope.

Installation

The documented npm package is layout-debug-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares LD_TARGET_URL. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-09.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
open_windowStarts the local server if it isn't running, opens the window, and tells the agent to start listening
wait_for_messageWaits for the next message or edit from the window and returns it with the element's artifacts. Returns "no message yet" after the timeout, and the agent…
reply_in_windowWrites to the window's chat: what changed, which files, what's left. With requestId it closes exactly that request
layout_snapshotTree of the latest snapshot: nodes, sizes, anchors for finding them in code. Depth-limited
selected_elementWhat the user has selected in the window right now: box, anchors, parent chain, live tweaks
pending_requestsAll requests sent from the window, for agents that don't listen

How to install the Layout Debug MCP Server

{
  "mcpServers": {
    "layout-debug": {
      "command": "npx",
      "args": [
        "-y",
        "layout-debug-mcp"
      ],
      "env": {
        "LD_TARGET_URL": "http://localhost:3000"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
LD_TARGET_URLDeclared in the maintainer’s client configuration.Check documentation