Cognitive Browser — Claude Code MCP server: visual regression testing
Cognitive Browser connects AI agents to web browsers for user journey simulation, visual diffing, and accessibility audits. Useful for end-to-end regression testing.
no license 19,566 installs updated 2026-04-12
claude mcp add --transport http cbrowser https://cbrowser.run.toolsWhat Cognitive Browser does
The server exposes over one hundred browser control tools for layout inspection and automated bug discovery. It finds DOM targets by intent and accessibility tree roles rather than brittle CSS paths. Built-in helpers remove cookie dialogs, run natural language test suites, and generate attention heatmaps based on distinct user profiles. Layout regression tests rely on Wasserstein consensus math to prevent false alarms on dynamic components.
Every multi-step flow relies on _browserToken, which is generated during initial navigation. If an agent calls click, fill, or screenshot without forwarding that token, the command runs against an empty new browser window instead of your current tab. Persisting cookies or local storage between test suites is handled through save_session and load_session.
The public endpoint is free for evaluation and enforces a hard rate limit of 50 requests per hour.
What it helps with
- track visual regressions between layout versions
- find elements by intent and accessibility markers
- simulate different user personas across application journeys
- dismiss cookie banners and modal overlays automatically
Example prompts for the agent
- Navigate to the target site via
navigateand locate the signup button usingfind_element_by_intent. - Run
visual_regressionagainst the active baseline to identify layout drift. - Clear cookie banners on the open page with
dismiss_overlay.
How to install Cognitive Browser
Platform CLI: remote server
claude mcp add --transport http cbrowser https://cbrowser.run.toolsPlatform CLI: remote server
codex mcp add cognitive-browser --url https://cbrowser.run.toolsConfig file
{
"mcpServers": {
"cognitive-browser": {
"url": "https://cbrowser.run.tools"
}
}
}Config file
{
"servers": {
"cognitive-browser": {
"type": "http",
"url": "https://cbrowser.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http cognitive-browser https://cbrowser.run.toolsStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Cognitive Browser
How to install Cognitive Browser in Claude Code?
Run claude mcp add --transport http cbrowser https://cbrowser.run.tools in your terminal. This registers the remote HTTP endpoint without local package setup.
What does Cognitive Browser do?
It gives coding agents browser automation tools to interact with web elements, dismiss dialogs, compare visual baselines, and simulate user persona behaviors.
What usage limits apply to Cognitive Browser?
The service provides free evaluation access capped at 50 requests per hour.