Check web pages for responsive design problems and capture screenshots across various phone, tablet, and desktop viewports.
Also known as chndr-prksh/facet, @chandra14/facet-check
- Stars
- 3
- Tools
- —
- Downloads, 30 days
- 181
- Latest version
- 0.1.0
- Last commit
- Oct 22, 2026
- License
- —
What is Facet MCP?
Facet checks web pages for responsive design problems and capture screenshots across various phone, tablet, and desktop viewports.
Summary generated from the project's README
About Facet MCP server
Facet provides a way to audit web pages for responsive design flaws across a wide range of viewports. It functions as a command line tool, a CI integration, or an MCP server that AI coding agents like Claude Code, Cursor, or VS Code can use to verify CSS changes. The server uses headless Chromium to emulate real device behaviors, including touch support, pixel ratios, and mobile viewport settings, rather than simply resizing a browser window.
Developers can use specific tools like check_responsive to identify issues such as horizontal scrolling, small tap targets, or incorrect font sizes that trigger iOS zooming. The system also offers screenshot capabilities for visual verification and an audit_accessibility tool that runs axe-core to find WCAG violations. It supports over 290 device profiles, ranging from mobile phones and foldables to 4K monitors. Users need Node 20 or later and a Chromium-based browser installed to run the service.
What you can do with it
- 1Identify horizontal scrolling issuesAsk an AI agent to find elements that cause a page to scroll sideways on mobile devices.
- 2Verify tap target sizesDetect interactive elements that are too small for touch users according to accessibility standards.
- 3Capture device screenshotsRequest visual proof of how a website renders on specific hardware like an iPhone or tablet.
- 4Audit accessibility complianceRun a check to find WCAG violations and receive suggested fixes for a specific device.
Written from the project's README. Every use case is checked against a quote from it.
How to install Facet MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Facet MCP in Claude Code
$ claude mcp add facet -- npx -y @chandra14/facet-checkInstall Facet MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"facet": {
"command": "npx",
"args": [
"-y",
"@chandra14/facet-check"
]
}
}
}Install Facet MCP in VS Code
.vscode/mcp.json
{
"servers": {
"facet": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@chandra14/facet-check"
]
}
}
}Install Facet MCP in VS Code CLI
$ code --add-mcp '{"name":"facet","type":"stdio","command":"npx","args":["-y","@chandra14/facet-check"]}'Install Facet MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"facet": {
"command": "npx",
"args": [
"-y",
"@chandra14/facet-check"
]
}
}
}Install Facet MCP in Codex
$ codex mcp add facet -- npx -y @chandra14/facet-checkInstall Facet MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.facet] command = "npx" args = ["-y", "@chandra14/facet-check"]
Install Facet MCP in Gemini CLI
$ gemini mcp add -s user facet npx -- -y @chandra14/facet-checkInstall Facet MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"facet": {
"command": "npx",
"args": [
"-y",
"@chandra14/facet-check"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachablechndr-prksh/facet is public and reachablegithub.com/chndr-prksh/facet ↗Pass
- Package names this repository as its source@chandra14/facet-check names chndr-prksh/facet as sourcenpmjs.com/package/@chandra14/facet-check ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-10-22github.com/chndr-prksh/facet ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @chandra14/facet-checkPass
- No critical advisory in the package or its dependencies101 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubfacet-check
Check a web page for responsive design problems on real phone, tablet and desktop viewports. It runs from the command line, in CI, or as an MCP server that AI coding agents (Claude Code, Cursor, Codex, VS Code) can call.
npx @chandra14/facet-check localhost:3000
Or install it once with npm install -g @chandra14/facet-check, then run facet-check localhost:3000.
Output for a test page with a price table that is too wide for phones (shortened):
Facet check http://localhost:3000
6 devices · 14 errors · 14 warnings
✗ iPhone 16 393×852 @3x
error Page scrolls sideways by 267px — The document is 660px wide in a 393px viewport.
error Extends 267px past the viewport — <table.prices> “SizeWhole beanGroundSubscriptionWholesal”
html > body > main > table
fix: Constrain it with max-width: 100%, min-width: 0 on a flex child, overflow-wrap: anywhere, or let it scroll inside its own container.
error Tap target is 13 × 13px — <input#weekly>
#weekly
fix: Targets must be at least 24 × 24px (WCAG 2.5.8); 44 × 44px is comfortable.
warn Field text is 14px, so iOS zooms in on focus — <input#email>
#email
fix: Give form controls font-size: 16px or larger.
console Carousel failed to initialise at 393px
! Full HD laptop at 125% (most common) 1536×864 @1.25x
warn Text is only 10px — <p#terms> “Prices include tax. Orders placed after ”
Each device is a real emulation in headless Chromium, not a resized window. It uses the device's viewport, pixel ratio, touch support, mobile viewport behaviour and user agent. A page with no viewport meta tag lays out at 980px on a phone, as it would on the real device.
It is the command-line and agent side of Facet, an open-source browser for responsive web development. Facet's device catalogue has 290+ profiles, from the iPhone SE to 2026 flagships, foldables, tablets, laptops and 4K monitors.
What it finds
On every device:
- Horizontal scrolling, and the element that causes it (the table, not each of its cells)
- Tap targets smaller than 24 × 24px on touch devices (WCAG 2.5.8)
- Text smaller than 12px, and text that is cut off without an ellipsis
- Form fields under 16px, which make iOS zoom in when focused
- Viewport meta problems: missing, not
device-width, or zoom disabled - Images that are far larger than needed, blurry on high-density screens, or missing dimensions
- Fixed headers and banners that cover too much of a small screen
- Console errors, uncaught exceptions and failed requests, per device. An error that only one device logs is a viewport-specific bug.
Command line
npx @chandra14/facet-check <url> [options]
| Option | |
|---|---|
-d, --devices <list> |
Device ids, names, sizes like 1024x768, or a preset (default: popular) |
-s, --screenshots <dir> |
Save a PNG of each device |
--full-page |
Capture the whole page, not only the first screen |
--json |
Print the full report as JSON |
--all |
Also list info-level notes |
--fail-on <level> |
Exit 1 when a finding is at least error (default), warn or info; never always exits 0 |
--timeout <ms> |
Page load timeout (default 30000) |
--list-devices [query] |
Show presets and the device catalogue |
The URL can be a full URL, a bare host (example.com), a local dev server (localhost:3000, :5173) or a path to an HTML file.
Presets: popular (the six most common real-world sizes), default (phone, tablet, laptop), phones, latest, tablets, desktops, apple, foldables, extremes.
npx @chandra14/facet-check localhost:3000 -d phones --screenshots shots
npx @chandra14/facet-check https://example.com -d iphone-17,"Galaxy S26",ipad,1440x900 --json
In CI
The exit code is 1 when errors are found, so it can gate a pull request:
- run: npx @chandra14/facet-check http://localhost:4173 --fail-on error
MCP server for AI agents
facet-check mcp runs a Model Context Protocol server over stdio. An agent can then check its own CSS changes on many screen sizes and look at the result.
Claude Code
claude mcp add facet -- npx -y @chandra14/facet-check mcp
Cursor, VS Code, Claude Desktop and other clients
{
"mcpServers": {
"facet": { "command": "npx", "args": ["-y", "@chandra14/facet-check", "mcp"] }
}
}
| Tool | What it does |
|---|---|
check_responsive |
Loads a URL on several devices and returns the problems on each, with selectors and fixes |
screenshot |
Returns one labelled image per device (viewport or full page) |
compare_element |
Measures one element on every device: size, visibility, font size, display, flex and grid |
audit_accessibility |
Runs axe-core on one device and returns WCAG violations with fixes |
list_devices |
Lists the device catalogue and presets |
Then ask, for example: "Check localhost:3000 on phones and fix anything that scrolls sideways."
Requirements
Node 20 or later and a Chromium-based browser. facet-check uses, in order: the browser at FACET_CHROME, Playwright's Chromium (npx playwright install chromium), Google Chrome, then Microsoft Edge. Most machines already have one of these.
Limits
- Chromium only. An iPhone profile emulates the iPhone's screen, not Safari's WebKit engine. Safari-specific bugs still need Safari.
- It checks the page as it is after load. Content behind a login or a click is out of reach from the command line.
License
MIT
Facet MCP questions
How do I add Facet MCP to Claude Code?
Run claude mcp add facet -- npx -y @chandra14/facet-check in your terminal. Add --scope user to make it available in every project.
How do I add Facet MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Does it emulate real devices or just resize the window?
Each device is a real emulation in headless Chromium using the specific device's viewport, pixel ratio, touch support, and user agent.
Can I use it to test Safari-specific bugs?
No, it is limited to Chromium-based emulation, so it cannot detect bugs specific to the Safari WebKit engine.
How can an AI agent use this server?
Agents can use tools to check responsive problems with selectors and fixes, take screenshots, compare element properties, or run accessibility audits.