crowd-test-mcp 🔥

The mob, on tap — an MCP server for crowd-test.

Ask Claude Desktop, Claude Code, Cursor, or any MCP client to unleash a crowd of AI virtual users — impatient shoppers, confused seniors, keyboard-only users, chaos monkeys — on your website. They browse it in real Chromium, file findings, and hand back a damage report with a survival grade (S–F).

"Send the mob at https://staging.myapp.com and tell me what to fix first."

That's the whole workflow now.

Install

pip install crowd-test-mcp

An LLM key is required in the server's environment: ANTHROPIC_API_KEY or OPENAI_API_KEY.

Claude Code

claude mcp add crowd-test -e ANTHROPIC_API_KEY=sk-... -- crowd-test-mcp

Claude Desktop / Cursor / anything MCP

{
  "mcpServers": {
    "crowd-test": {
      "command": "crowd-test-mcp",
      "env": { "ANTHROPIC_API_KEY": "sk-..." }
    }
  }
}

Related MCP server: Aiqaramba

Tools

Tool	What it does
`run_crowd_test`	Send the crowd at a URL. Pick personas, add a random `mob`, set a `goal`, choose the verification depth (`none` / `detective` / `cross` / `tribunal`). Returns a compact damage summary; full markdown/HTML reports land in `~/crowd-test-reports/`.
`list_personas`	The ten built-in ringleaders and what each one catches.
`preview_mob`	Preview the random mob a given `count`/`seed` would generate.
`read_report`	Fetch the newest full markdown report from disk.

The verification tribunal

Findings can be cross-examined by up to three independent harnesses before they count against the grade — a skeptical detective agent, a raw Playwright probe, and a Microsoft Webwright agent. Automation artifacts get disputed instead of panicking you. Details in the crowd-test README.

Deeper layers need one-time extras:

pip install crowd-test[probe] && playwright install chromium   # verify="cross"
pip install git+https://github.com/microsoft/Webwright         # verify="tribunal"

Good to know

Runs take minutes, not seconds — every persona drives a real browser. Start with 2–3 personas; escalate to mob=10 when you mean it.
Only test what you own. The mob is for your own staging and production sites, not other people's.
Reports default to ~/crowd-test-reports/<host>-<timestamp>/.