# canaryusers

canaryusers sends simulated visitors through a deployed web project to spot layout flaws and broken flows. It flags exact drop-off points so you can adjust the interface before launch.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: CanaryUsers-ai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/CanaryUsers-ai/canaryusers-mcp
- Updated: 2026-06-13
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/canaryusers

## What it does

This server evaluates live preview or production URLs rather than scanning local repositories. Synthetic visitor personas render the interface, examine layouts across desktop or mobile viewports, and navigate critical paths like signups. Instead of delivering an opaque rating, the audit lists clear technical remediations ready to implement.

It exposes three tools to the model: `canary_scan` to trigger an evaluation, `list_recent_scans` to inspect prior checkups, and `get_report_markdown` to read complete findings in Markdown. Two inspection modes exist. The default `quick` scan runs a free static review. The `deep` option takes 60 to 90 seconds, traverses interactive funnels, and deducts account credits.

Everything operates through the remote HTTP endpoint `https://www.canaryusers.ai/api/mcp`. No local repository setup is needed. Execution requires an API token from your account dashboard, meaning unauthenticated calls will fail immediately.

## Requirements
- Remote server: `https://www.canaryusers.ai/api/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http canaryusers https://www.canaryusers.ai/api/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add canaryusers --url https://www.canaryusers.ai/api/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "canaryusers": {
            "url": "https://www.canaryusers.ai/api/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "canaryusers": {
            "type": "http",
            "url": "https://www.canaryusers.ai/api/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http canaryusers https://www.canaryusers.ai/api/mcp
```

## When to use it
- detect broken mobile layouts and responsive styling glitches
- test friction across registration and checkout flows
- retrieve concrete interface fixes directly into the chat session
- spot user drop-off causes before a public launch

## Example prompts
- Run a fast canaryusers interface scan on `<url>`
- Inspect our signup funnel at `<url>` using canary_scan with depth set to deep
- Fetch the full markdown report for my latest scan via get_report_markdown

## Similar
- [break-ui](https://affpapa.org/en/nevibecode/skills/break-ui.md) — skill · 121000 installs
- [ui-ux-tester](https://affpapa.org/en/nevibecode/agents/ui-ux-tester.md) — subagent · ★ 26718 repo stars
- [Menso](https://affpapa.org/en/nevibecode/mcp/menso.md) — MCP server
- [flow-checker](https://affpapa.org/en/nevibecode/skills/flow-checker.md) — skill · ★ 33 repo stars
- [frontend-visual-qa](https://affpapa.org/en/nevibecode/skills/frontend-visual-qa.md) — skill · 664 installs
- [benchmark](https://affpapa.org/en/nevibecode/skills/garrytan-benchmark.md) — skill · 409 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
