Skip to main content
Glama
uicheck-ai

@uicheck/mcp

Official
by uicheck-ai

@uicheck/mcp

Local MCP server for @uicheck/core. The browser page connects to this server through WebSocket, and AI agents call MCP tools to ask that page for screenshots and DOM element info.

Start

npm install -g @uicheck/mcp
uicheck-mcp

Default endpoints:

MCP:    http://127.0.0.1:17322/mcp
Socket: ws://127.0.0.1:17322/socket

@uicheck/core

Configure the page script with the socket URL:

installUiCheck(html2canvas, {
  position: 'bottom-left',
  offset: [20, 20],
  size: 36,
  color: '#ef4444',
  draggable: true,
  socket: {
    url: 'ws://127.0.0.1:17322/socket'
  }
})

CDN query params are also supported:

<script src="http://127.0.0.1:17321/uicheck.js?socketUrl=ws://127.0.0.1:17322/socket"></script>

MCP Tools

Tool

Description

list_clients

Lists connected @uicheck/core browser pages.

capture_page

Asks a connected page to return a PNG screenshot.

inspect_elements

Returns visible DOM selectors, text, layout boxes, and spacing info.

get_element_at_point

Returns the element and ancestors at viewport coordinates.

CLI

uicheck-mcp --host 127.0.0.1 --port 17322

Related MCP Connectors