Siteglass MCP README

siteglass MCP server

siteglass-mcp exposes siteglass.io as MCP tools. Three things an AI agent (or a human) can do with it:

Scan the app you're building — FREE, no account — siteglass_scan_local runs a headless browser on your machine against http://localhost:PORT (or any URL you can reach — nothing is tunneled to us), then siteglass analyzes the crawl and returns real findings: broken links/assets, console errors, accessibility & SEO issues, forms worth testing, plus a plain-English report. Point it at your dev server right after the agent builds or changes the app. No signup, no ownership verification, no payment. (First run downloads a headless Chromium, ~1 min.)
Archive any public URL — siteglass_render renders a page server-side and returns a permanent, shareable snapshot: an interactive rrweb DOM capture (post-JS, selectable text, working links), a single-page PDF, or a full-page PNG. No CAPTCHA, no signup, no ownership check, callable programmatically — a bot-friendly alternative to archive.today. (It renders JS-heavy pages; it does not produce WARC, and if the target itself blocks datacenter IPs the capture can come back empty.)
Web-QA a deployed site you own — register → verify → scan → generate flows → run → read results, autonomously, no human signup. This is the hosted/continuous tier (runs on our servers against your live site).

The local scan (1) is free and needs no auth. For the hosted tools (2, 3), auth is automatic (creates + caches an API key at ~/.siteglass/key; set SITEGLASS_API_KEY to use your own); the first scan per site is free, then scans (2 credits) and flow runs (1 credit) draw from a prepaid balance topped up in USD over Bitcoin Lightning.

Install

Terminal

npx siteglass-mcp

Claude Code:

Terminal

claude mcp add siteglass -- npx siteglass-mcp

Cursor / Claude Desktop / Windsurf — add to the MCP config (~/.cursor/mcp.json, claude_desktop_config.json, …):

config.json

{
  "mcpServers": {
    "siteglass": { "command": "npx", "args": ["-y", "siteglass-mcp"] }
  }
}

OpenClaw — add to ~/.openclaw/openclaw.json (OpenClaw consumes MCP servers); your assistant gets the siteglass_* tools:

config.json

{ "mcpServers": { "siteglass": { "command": "npx", "args": ["-y", "siteglass-mcp"] } } }

Then ask the agent: "test my app at with siteglass."

Tools

tool	does
`siteglass_scan_local`	free, no-auth — crawl a local/dev app in a browser on your machine → analyzed findings + report
`siteglass_render`	archive any public URL → shareable snapshot permalink (rrweb / pdf / png); no CAPTCHA, no signup
`siteglass_get_render`	fetch an archive once its Lightning invoice is paid
`siteglass_register_site`	register an app URL, get an ownership-proof token
`siteglass_verify_site`	confirm the token is live (DNS TXT or hosted)
`siteglass_scan` / `siteglass_get_scan`	crawl the site → report + findings (first scan free)
`siteglass_generate_flows`	derive executable E2E test flows from a scan
`siteglass_run_flow` / `siteglass_get_run`	run a flow → per-step pass/fail, screenshots, video, rrweb replay
`siteglass_set_credentials`	give a test login for authenticated flows
`siteglass_feedback`	send feedback to the siteglass team

Long ops return an id and you poll the get_* tool, so every call stays under MCP client request timeouts.

Discovery

Listed in the official MCP Registry as io.siteglass/mcp.
Machine-discovery on the API host: https://siteglass.io/openapi.json, /.well-known/agent-skills/index.json, /llms.txt, /SKILLS.md.

MIT licensed.