boxcheck
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
boxcheck
100% local DOM geometry, CSS cascade, and layout-collision oracle (CLI + MCP) so coding agents stop shipping broken mobile UIs. Speaks raw CDP over Node 24 WebSocket with zero runtime dependencies.

See It Catch Mobile Layout Bugs Locally (Zero Setup)
npx boxcheck --demo --json --out ./boxcheck-report.htmlSpins up a built-in responsive SaaS pricing page (0 defects on 1440x900 desktop, mobile collisions on 390x844), audits it in local headless Chrome via raw CDP, prints compact deterministic collision JSON with winning CSS rules, and writes a self-contained visual SVG/PNG overlay report to ./boxcheck-report.html.
Related MCP server: art-director-mcp
Quick Start
# Audit mobile + desktop viewports
npx boxcheck audit http://localhost:3000 --vp 390x844,1440x900 --json
# Generate visual SVG/PNG collision overlay report
npx boxcheck audit http://localhost:3000 --vp 390x844 --out ./report.html
# Save lightweight git-committable JSON geometry baselines (.boxcheck/baselines/)
npx boxcheck snap http://localhost:3000
# Diff live geometry against baseline (flags unintended >2px shifts/resizes)
npx boxcheck diff http://localhost:3000 --fail-on-defectsConnect to Your Coding Agent (Stdio MCP)
boxcheck mcp exposes three lean tools (boxcheck_audit, boxcheck_snap, boxcheck_diff) returning compact deterministic JSON instead of giant accessibility tree dumps.
Antigravity / Cursor / Claude Code / Codex / OpenCode
{
"mcpServers": {
"boxcheck": {
"command": "npx",
"args": ["-y", "boxcheck", "mcp"]
}
}
}What boxcheck Detects (with Built-In False-Positive Shield)
Defect Kind | Deterministic Condition | False-Positive Shield |
| Non-ancestor content/interactive siblings intersect | Ignores ancestor-descendant pairs, |
| Page | Skips intentional |
| Text exceeds | Ignores intentional |
| Visible interactive element pushed | Ignores elements inside horizontal scroll containers, clipped/hidden/zero-opacity nodes |
|
| Ignores self, descendants, ancestors, and elements clipped out by scroll ancestors |
Each defect is enriched via CDP CSS.getMatchedStylesForNode with the exact deduplicated winning_css rule so your coding agent fixes the root CSS line directly.
Honest Comparison
Feature |
| Playwright MCP |
| Chromatic / Percy |
Install & Footprint | ~52 kB tarball, 0 runtime deps, uses system Chrome/Edge | Heavy browser bundle | Node + browser | Paid cloud SaaS + CI |
Output size per layout check | Compact JSON capped for small agent context budgets | Large a11y trees / PNGs | Navigation-focused refs | N/A (human PR review) |
Deterministic overlap / overflow / occlusion math + | Yes | No | No | Pixel diff only |
Git-committable JSON geometry baselines | Yes (tiny | No | No | Cloud PNG storage |
Where competitors win | (Chromium-only layout oracle) | Full interactive clicking, form filling, E2E scripting | Multi-step web navigation | Cross-browser Safari/Firefox cloud visual approval workflows |
Architecture
flowchart LR
Agent["Coding Agent / CLI\n(Antigravity · Claude Code · Codex · Cursor)"] -->|"CLI or Stdio MCP"| Core["boxcheck\n0 runtime deps · Node 24"]
Core -->|"Raw CDP over native WebSocket"| Chrome["Headless Chrome / Edge / Chromium\n(isolated temp profile, auto-cleaned)"]
Chrome -->|"Rects + Computed Styles + elementFromPoint"| Detector["Deterministic Collision Math\n+ False-Positive Shield"]
Chrome -->|"CSS.getMatchedStylesForNode"| Cascade["Winning CSS Attribution"]
Detector --> Output["Compact JSON · Baselines · SVG/PNG Overlay"]
Cascade --> OutputLocal Agent Reliability Suite
kvdiff: Zero-code local proxy that pinpoints the exact UTF-8 byte breaking your LLM prompt cache (
Anthropic,OpenAI,Gemini/Antigravity,llama.cpp/vLLM).boxcheck (this repo): Local DOM geometry & CSS collision oracle (CLI + MCP).
License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Audit public webpages and supplied markup for HTML, CSS, SEO, JSON-LD, and link issues.
Technical SEO audits: check a page or crawl a whole site, locally or hosted. Compares crawls.
Capture screenshots, detect visual regressions between page versions, and analyze with AI.
Read, screenshot, diff, verify and audit any URL: SEO, links, sitemaps, schema, a11y.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables CSS layout verification and debugging by extracting deterministic, diffable rendered layout from a browser, allowing agents to inspect, explain, and diff CSS changes.14 npm2MIT
- AlicenseNot gradedqualityBmaintenanceProvides coding agents with local tools to inspect project UI inventories, propose and compare visual direction boards, compile versioned design contracts and DTCG tokens, retrieve section-specific blueprints, and audit running interfaces with browser evidence including screenshots, accessibility findings, and overflow measurements.MIT
- AlicenseNot gradedqualityCmaintenanceEnables cross-browser mobile-first responsive layout auditing and browser automation, including overflow detection, tap target checks, viewport/media query introspection, and screenshot matrices via MCP.MIT
- AlicenseNot gradedqualityBmaintenanceEnables coding agents and CI to verify rendered web UIs against design token usage, layout constraints, and accessibility rules, returning concise pass/fail verdicts with actionable findings.12 npmMIT