{
  "markdown": "# CanaryUsers — MCP Server\n\n[![Official MCP Registry](https://img.shields.io/badge/MCP_Registry-ai.canaryusers%2Fcanaryusers-blue)](https://registry.modelcontextprotocol.io/v0/servers?search=canaryusers)\n[![Smithery](https://img.shields.io/badge/Smithery-brettonb%2Fcanaryusers-7c3aed)](https://smithery.ai/servers/brettonb/canaryusers)\n[![Website](https://img.shields.io/badge/setup-canaryusers.ai%2Fmcp-0aa)](https://www.canaryusers.ai/mcp)\n\n> Give your AI coding assistant eyes for UX: a flock of AI users tests your deployed app and reports where real people would bail — each with a concrete fix.\n\n**CanaryUsers** sends a flock of behaviorally‑diverse AI users through your **deployed** web app (a live or preview URL) and reports exactly where real people get stuck — confusing UX, broken mobile layouts, dead‑end conversion paths, and visual glitches — each with a concrete, AI‑ready fix you can apply in the same chat.\n\nThis is the public home for the **CanaryUsers remote MCP server**: manifest, install instructions, and docs. The product itself is hosted (closed source) — there's nothing to clone or run; you connect to the live endpoint. See [docs/WHY.md](docs/WHY.md) for why this repo exists and [docs/HOW-IT-WORKS.md](docs/HOW-IT-WORKS.md) for how the server works.\n\n- **Registry name:** `ai.canaryusers/canaryusers`\n- **Endpoint (remote, Streamable HTTP):** `https://www.canaryusers.ai/api/mcp`\n- **Auth:** `Authorization: Bearer <your CanaryUsers token>`\n- **Setup / get a token:** https://www.canaryusers.ai/mcp\n\n## What it does\n\nYou point it at a URL; a flock of AI personas actually renders and explores the page like real users, then hands back prioritized, fix‑ready findings — not a vague score. Two modes:\n\n- **Quick** (default) — a fast static check. Free.\n- **Deep** — renders the page, inspects it **visually on desktop + mobile** (catches mobile breakage and layout issues), and **clicks through key flows** like signup / checkout / onboarding (~60–90s, uses credits).\n\n## When to use it\n\n- Right **after you ship or deploy a UI change** (it scans the deployed result, not your source).\n- **Before a launch**, to pressure‑test the first‑run experience.\n- To check a specific high‑stakes **flow**: signup, checkout, onboarding, pricing, or a landing page.\n- When you suspect **mobile** breakage or a **conversion** drop‑off you can't see in analytics.\n\n## Why not Lighthouse or analytics?\n\nLighthouse grades your HTML; analytics charts what already happened. CanaryUsers **sends users** and tells you, in plain language, *where they'd give up and why* — before real ones do.\n\n## Tools\n\n| Tool | What it does |\n|------|--------------|\n| `canary_scan` | Run a UX scan on a deployed URL. `depth`: `quick` (free, default) or `deep` (visual + flow, uses a credit). Returns AI‑ready findings. |\n| `list_recent_scans` | List your recent scans (id, URL, score, grade, status, date). |\n| `get_report_markdown` | Fetch the full report for a scan id as Markdown. |\n\n## Install\n\nYou need a CanaryUsers token: **[canaryusers.ai/dashboard](https://www.canaryusers.ai/dashboard) → CI & API → toggle MCP on → copy your token.**\n\n**Generic (Cursor `~/.cursor/mcp.json`, Windsurf, VS Code, Claude Desktop):**\n\n```json\n{\n  \"mcpServers\": {\n    \"canaryusers\": {\n      \"url\": \"https://www.canaryusers.ai/api/mcp\",\n      \"headers\": {\n        \"Authorization\": \"Bearer YOUR_CANARYUSERS_TOKEN\"\n      }\n    }\n  }\n}\n```\n\n**Claude Code (CLI):**\n\n```bash\nclaude mcp add --transport http canaryusers https://www.canaryusers.ai/api/mcp \\\n  --header \"Authorization: Bearer YOUR_CANARYUSERS_TOKEN\"\n```\n\nThen just ask your assistant: *\"Scan my app at https://… with CanaryUsers.\"*\n\n## Pricing\n\n**Quick scans are free. Deep scans use credits** (the credit model is roughly *1 credit = 1 scanned page*). Plans and monthly allotments change over time, so this repo intentionally does **not** hardcode the numbers — see the live pricing for current plans and limits:\n\n➡️ **https://www.canaryusers.ai/#pricing** (single source of truth)\n\n## Links\n\n- **Setup & token:** https://www.canaryusers.ai/mcp\n- **Pricing (live):** https://www.canaryusers.ai/#pricing\n- **Official MCP Registry:** https://registry.modelcontextprotocol.io/v0/servers?search=canaryusers\n- **Smithery:** https://smithery.ai/servers/brettonb/canaryusers\n\n## License\n\n[MIT](LICENSE) — applies to the contents of this metadata/docs repo. The CanaryUsers service itself is a separate hosted product.\n",
  "bytes": 4454,
  "sha": "3eb4c6f25a1ba0bb3f2079d9a0cb9c2b69d403e8ae26714a973a7b366369fcb9",
  "repo_slug": "canaryusers-ai/canaryusers-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_canaryusers_canaryusers_0d92dd44/readme"
}