For coding agents
Mimiq MCP server: user testing from your coding agent
Your agent built the page. Now it can show it to a crowd of simulated people, send them through the sign-up in a real browser, or compare the preview with production, and read back who left, where they got stuck, and why.
Is there an MCP server for user testing?
Yes. Mimiq runs one at https://mcp.mimiqai.com/mcp, listed in the official MCP registry. A coding agent can show a page or copy to simulated people, send them through a sign-up flow in a real browser, or compare two versions, and get back who left and why. One free test works without a key; with a key, results link to the full report.
Why test from inside the agent
Coding agents ship pages and sign-up flows in minutes, and nobody outside the team sees them until real visitors do. A test inside the agent's loop puts skeptical simulated people in front of the change while it is still cheap to fix, and the agent can read their objections and act on them before you review the diff.
- Eight tools: test a page, run a flow, test copy, text or a UI component, compare two pages or two pieces of copy, and ask a question.
- Works with Claude Code, Codex, Cursor, VS Code, Windsurf, and Claude Desktop.
- One free test without a key; a free account adds 100 credits.
- With a key, tests and comparisons are saved to your account, with a link to the full report.
Connect it
In Claude Code, run this once in your project. Leave out the header to use the free test, or set MIMIQ_API_KEY to a key from your Mimiq settings.
claude mcp add --transport http mimiq https://mcp.mimiqai.com/mcp --header "Authorization: Bearer $MIMIQ_API_KEY"Other clients
Clients that read an MCP config file take the same address. In Cursor, put this in .cursor/mcp.json, and keep a file with a key out of your repository. The README at github.com/victorgulchenko/mimiq-mcp has the setup for Codex, VS Code, Windsurf, and Claude Desktop.
{
"mcpServers": {
"mimiq": {
"url": "https://mcp.mimiqai.com/mcp",
"headers": { "Authorization": "Bearer mq_sk_..." }
}
}
}What your agent can ask for
Ask in plain words: test my landing page on startup founders, compare these two headlines on freelance designers, or compare the preview deployment with production. The agent picks the tool.
A flow sends each person through a task in their own real browser, such as signing up, for up to 15 steps by default, and returns each person's steps, where they stopped, and why. It uses 30 credits a person; without a key, a free flow has up to 3 people, within a daily limit.
A comparison shows both versions to the same simulated people and returns Mimiq's call: clear, leaning, or too close to call, with how many people moved each way.
How far to trust the results
Everyone in a Mimiq result is simulated. On 1,000 real headline A/B tests held out from its development, Mimiq's forecast picked the headline more readers clicked 76% of the time; the best rule of thumb, picking the headline written first, got 61%. Mimiq's forecast has held up on headlines. In pre-registered tests on emails, text messages and ads, it was no better than chance at ranking small wording changes, and on real web page tests it did not beat the simplest guess. So treat a call on copy, an email, or a page as a fast first read, not a measured result.
A flow shows where people like your visitors can get stuck, not how many real visitors will finish. It is a usability check, not a conversion forecast.
Local builds and keys
Mimiq opens pages in a real browser on its side, so the address has to be public. For a local dev server, open a temporary tunnel, such as a free cloudflared tunnel, and pass its address. The page is public while the tunnel runs, so your agent should tell you before it opens one.
To get a key, create a free account (it adds 100 credits), open Settings, find "Use Mimiq from your coding agent", and choose "Create a key". Send it as "Authorization: Bearer mq_sk_..." on every request. Packs start at $29 for 500 credits, and credits never expire.
The tools
| Tool | What it does |
|---|---|
| mimiq.test_page | One page: each simulated person reads it and says what confused them, what they doubted, and what would help. |
| mimiq.test_flow | A sign-up, onboarding, or checkout flow in a real browser, step by step, to find where people give up. 30 credits a person. |
| mimiq.compare_urls | Two pages, such as a preview deployment and production, shown to the same simulated people, and Mimiq's call on which to ship. |
| mimiq.compare_copy | Two versions of copy or an email, the same simulated people, and Mimiq's call. |
| mimiq.test_copy | One piece of copy: a headline, a tagline, a subject line, or a call to action. |
| mimiq.test_text | Any other text, such as positioning, feature descriptions, error messages, or instructions. |
| mimiq.test_component | A UI component, from its HTML or a description: do people understand it, trust it, and use it? |
| mimiq.ask_audience | A multiple-choice question, answered by each simulated person with their reasoning. |
From the server's own tool list. The server code is public under the MIT license at github.com/victorgulchenko/mimiq-mcp; the tests run on Mimiq's service.
Questions
Which MCP clients work with Mimiq?
Any client that supports remote MCP servers over HTTP. The README has setup for Claude Code, Codex, Cursor, VS Code with GitHub Copilot, Windsurf, and Claude Desktop through mcp-remote.
Do I need an account?
No, for one free test: without a key, each agent gets one free run. A free account adds 100 credits and a key, and saves every result as a report you can open in the app.
Can it test localhost?
Not directly. Mimiq needs a public address, so open a temporary tunnel to your dev server and pass the tunnel's address. The page is public while the tunnel runs.
What does a flow cost from the agent?
30 credits a person, since each one uses a real browser for minutes. Without a key, a free flow has up to 3 people, within a daily limit across everyone.
Where do the results go?
Back to your agent as structured results, with each person's reaction and reasons. With a key, each test and comparison is also saved to your account, and the result ends with a link to the full report. Reports stay private until you share them.
Is it open source?
The MCP server is, under the MIT license, at github.com/victorgulchenko/mimiq-mcp. The simulations run on Mimiq's service.
Keep reading
See what 25 people make of your page.
Last checked 2026-09-25.