# Cognitive Browser

105-tool browser automation with cognitive user simulation, visual testing, persona system, and site knowledge. Rate limited (50 req/hr). Free for evaluation

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add alexandria-shai-eden/cbrowser

# Browse available tools
npx -y @smithery/cli@latest tool list alexandria-shai-eden/cbrowser

# Get full schema for a tool
npx -y @smithery/cli@latest tool get alexandria-shai-eden/cbrowser navigate

# Call a tool
npx -y @smithery/cli@latest tool call alexandria-shai-eden/cbrowser navigate '{}'
```

## Direct MCP Connection

Endpoint: `https://cbrowser.run.tools`

## Tools (105)

- `navigate` — Navigate to a URL and take a screenshot. Pass _browserToken from a previous tool call to reuse the same browser session.
- `click` — Click an element on the page. MUST pass _browserToken from previous tool call to click on the same page. Without it, cl…
- `smart_click` — Click with auto-retry and self-healing selectors. v11.8.0: Added confidence gating - only reports success if healed sel…
- `dismiss_overlay` — Detect and dismiss modal overlays (cookie consent, age verification, newsletter popups). Constitutional Yellow zone.
- `fill` — Fill a form field with text. MUST pass _browserToken from previous tool call to interact with the same page.
- `scroll` — Scroll the page. MUST pass _browserToken from previous tool call to scroll the same page.
- `screenshot` — Take a screenshot of the current page. IMPORTANT: If you received a _browserToken from a previous tool call (navigate, …
- `extract` — Extract data from the page. Pass _browserToken to use the same browser session.
- `assert` — Assert a condition using natural language
- `analyze_page` — Analyze page structure for forms, buttons, links
- `generate_tests` — Generate test scenarios for a page
- `find_element_by_intent` — AI-powered semantic element finding with ARIA-first selector strategy. Prioritizes aria-label > role > semantic HTML > …
- `ai_benchmark` — Compare AI-friendliness across competitor sites. Runs agent-ready audits on each URL, ranks by AI readiness grade, and …
- `save_session` — Save browser session (cookies, storage) for later use
- `load_session` — Load a previously saved session
- `list_sessions` — List all saved sessions with metadata (name, domain, cookies count, localStorage keys, created date, size)
- `delete_session` — Delete a saved session by name
- `heal_stats` — Get self-healing selector cache statistics
- `visual_baseline` — Capture a visual baseline using Wasserstein barycenter. Takes multiple screenshots, rejects outliers, computes optimal …
- `visual_regression` — Run visual regression test against a baseline. Automatically uses smart regression (Wasserstein) if a smart baseline ex…
- `cross_browser_test` — Test page rendering across multiple browsers
- `cross_browser_diff` — Quick diff of page metrics across browsers
- `responsive_test` — Test page across different viewport sizes
- `ab_comparison` — Compare two URLs visually (staging vs production)
- `transport_map` — Generate a Visual Transport Map showing WHERE visual content moved between two screenshots. Produces heatmap, flow arro…
- `attention_analysis` — Analyze where a persona's visual attention goes on a page using Wasserstein saliency. Produces attention alignment, ent…
- `attention_compare` — Compare attention patterns between two personas on the same page. Shows where they look differently and the Wasserstein…
- `nl_test_file` — Run natural language test suite from a file. Returns step-level results with enriched error info, partial matches, and …
- `nl_test_inline` — Run natural language tests from inline content. Returns step-level results with enriched error info, partial matches, a…
- `repair_test` — AI-powered test repair for broken tests
- `detect_flaky_tests` — Detect flaky/unreliable tests by running multiple times
- `coverage_map` — Generate test coverage map for a site
- `hunt_bugs` — Autonomous bug hunting - crawl and find issues. Returns bugs with severity, selector, and actionable recommendation for…
- `chaos_test` — Inject failures and test resilience
- `compare_personas` — Compare how different user personas experience a journey. In Claude Code sessions (no API key), use compare_personas_in…
- `compare_personas_init` — Initialize persona comparison for Claude Code bridge workflow. Returns persona profiles and instructions for running jo…
- `compare_personas_complete` — Complete persona comparison by aggregating journey results. Call this after running all persona journeys via the bridge…
- `cognitive_distance` — Compute the Wasserstein cognitive distance between two personas. Returns W₁ distance (true cognitive distance), per-tra…
- `cognitive_coverage` — Select the N most cognitively different personas from a list for maximum test coverage. Uses greedy farthest-point samp…
- `cognitive_interpolate` — Generate an interpolated persona between two known personas using Wasserstein geodesic. Preserves trait coupling struct…
- `cognitive_load_estimate` — Estimate cognitive load for a specific persona on page metrics. Returns per-dimension breakdown (information, visual, a…
- `cognitive_journey_init` — Initialize a cognitive user journey simulation. Returns the persona's cognitive profile, initial state, and abandonment…
- `cognitive_journey_update_state` — Update the cognitive state during a journey simulation. Call this after each action to track mental state.
- `list_cognitive_personas` — List all available personas with their cognitive traits (includes accessibility and emotional personas)
- `persona_values_list` — List all Schwartz's 10 Universal Values with their meanings, plus higher-order values, Self-Determination Theory needs,…
- `persona_values_lookup` — Look up the values profile for a persona (Schwartz's 10 Universal Values, SDT needs, Maslow level). Values describe WHO…
- `list_influence_patterns` — List research-backed behavioral persuasion patterns (Cialdini, Kahneman) and which persona values correlate with suscep…
- `persona_questionnaire_get` — Get the persona questionnaire for building a custom persona. Returns research-backed questions that map to cognitive tr…
- `persona_questionnaire_build` — Build a custom persona from questionnaire answers with category-aware value safeguards. Answers should be a map of trai…
- `persona_trait_lookup` — Look up behavioral descriptions for specific trait values. Useful for understanding what a trait value means in practic…
- `persona_category_guidance` — Get guidance for value assignment based on persona category. (v16.12.0) Explains research basis for why cognitive, phys…
- `perf_baseline` — Capture performance baseline for a URL
- `perf_regression` — Detect performance regression against baseline with configurable sensitivity. Uses dual thresholds: both percentage AND…
- `list_baselines` — List all saved baselines (visual and performance)
- `agent_ready_audit` — Audit a website for AI-agent friendliness. Analyzes findability, stability, accessibility, and semantics. Returns score…
- `competitive_benchmark` — Compare UX across competitor sites. Runs identical cognitive journeys on multiple sites and generates head-to-head comp…
- `empathy_audit` — Simulate how real users experience a site. Accepts ANY persona — disability personas get specialized barrier detection,…
- `webmcp_ready_audit` — Audit an MCP server for Claude in Chrome / WebMCP compatibility. Uses 6-tier evaluation: Server Implementation (25%), T…
- `status` — Get CBrowser environment status and diagnostics including data directories, installed browsers, configuration, self-hea…
- `browser_health` — Check if the browser is healthy and responsive. Use this before operations if you suspect the browser may have crashed.
- `browser_recover` — Attempt to recover from a browser crash by restarting the browser process. Use this when browser_health returns unhealt…

---
*Response truncated. Use `npx -y @smithery/cli@latest` for complete data.*