Ascended Browser logo

Ascended Browser

by AceAtDev

Local browser MCP for verified web actions, frontend QA, screenshots, responsive checks, and console or network inspection.

Install Ascended Browser

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "aceatdev-ascended-browser": {
      "command": "uvx",
      "args": [
        "ascended-browser"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 11 tools correctly (10d ago).

Overview

AceAtDev/ascended-browser connects MCP clients to a local Camoufox browser for interactive automation and frontend QA. It exposes verified page actions, structured page inspection, screenshots, responsive viewport emulation, read-only JavaScript evaluation, and console or network diagnostics. Use it to investigate local or live web apps, reproduce interrupted interactions, test authenticated flows, and collect evidence alongside observed page changes. It is intended for exploratory QA rather than deterministic regression testing or CI validation.

Use cases

  • Test a local frontend flow and report page errors
  • Inspect console errors and failed network requests
  • Check responsive layouts across phone, tablet, and desktop viewports
  • Reproduce interrupted browser actions
  • Exercise login-protected pages with saved credentials

Key features

  • Verified browser actions with change reports
  • Console, network, audit, and design inspection
  • Screenshot capture and visual comparison
  • Responsive viewport and display-mode emulation
  • Read-only JavaScript evaluation
  • Saved-login browser automation

Tools11

What Ascended Browser lets your agent do. Expand a tool for its parameters.

Verified live~7.4k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

What it can do

From the 11 tools this server returned when we ran it.

Runs commands · 1Handles credentials · 5Makes network requests · 4Read-only tools · 10
Network at startup4 connections
Files written at startup20

Observed 2026-10-30 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 11d ago via OSV.dev · ascended-browser (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2Stargazers on the source repository.
Last commit21d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed11Callable tools this server registers over MCP.

How Ascended Browser works

What AceAtDev/ascended-browser does

AceAtDev/ascended-browser gives coding agents access to a local browser through MCP. It uses Camoufox, a hardened Firefox-based browser, and returns structured observations of pages and controls so an agent can act on named elements rather than coordinates.

The main use case is agent-assisted exploratory QA. An agent can open a page, complete a workflow, inspect what changed after each action, review console and network activity, and capture screenshots of the resulting state. The server also supports ordinary browsing tasks such as searching pages, handling forms, and navigating across tabs.

How it works

The server runs locally over stdio and launches the browser when needed. browser_open and browser_observe expose page content and control references. Actions sent through browser_act are checked and report the resulting page change, which helps an agent recover when an interaction is interrupted or produces an unexpected result.

Camoufox is pinned by the package, and the browser download can be performed before the first agent request. On Linux, Xvfb can provide a virtual display; with a display available, viewport changes can exercise real responsive breakpoints.

Setup and configuration

Install through Python tooling with uvx ascended-browser, or use the npm launcher with npx -y ascended-browser. Run doctor to check the machine and fetch to download the browser ahead of time. Python installation requires Python 3.11 or newer when the npm launcher cannot use uv or pipx.

Add the command as a local stdio MCP server. Claude Code and Codex provide commands for registration; Cursor, Windsurf, Claude Desktop, and other compatible clients can use uvx with ascended-browser, or npx with -y ascended-browser. Codex permissions must allow browser actions; sandboxed execution that cannot request approval will fail unless the server tools are pre-approved.

Tools and capabilities

  • Open one or more URLs and inspect page content with control references.
  • Re-observe a page, or limit observations by region, query, or filter.
  • Navigate, click, fill fields and forms, choose options, check controls, set dates, press keys, upload files, scroll, wait, and run action sequences.
  • Extract page text and field state, find phrases, and list CSS-selector matches with text and attributes.
  • Read console logs, network activity, inspection data, audits, and design-related page information.
  • Capture screenshots and compare them with an earlier image or another tab.
  • Resize Linux browser viewports for phone, tablet, and desktop checks and emulate dark mode, reduced motion, forced colors, or offline mode.
  • Run policy-checked, read-only JavaScript; list, close, or sleep tabs; record and replay flows with new values.
  • Use saved logins without exposing their values to the agent, and wait through browser-check pages when supported challenge controls block a form.

Limitations and notes

The browser is intended for exploratory QA, not as a replacement for deterministic regression tests or a validated CI integration. The browser download is roughly 700 MB when fetched. On Linux, installing Xvfb is useful for a virtual display; without a display, the browser runs headless. Saved-login use keeps credentials out of agent results, but the signed-in account remains visible on the browser screen during the session.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Ascended Browser

AceAtDev/ascended-browser is an MCP server that connects coding agents to a local Camoufox browser. Its main tools open and inspect pages, perform verified actions, extract text and diagnostics, capture screenshots, resize viewports, manage tabs, replay flows, and use saved logins without exposing credentials.

Install it with `uvx ascended-browser` or `npx -y ascended-browser`. Run `doctor` to check the machine and `fetch` to download the browser before use. Python-based installation requires Python 3.11 or newer when the npm launcher cannot use uv or pipx.

Yes, AceAtDev/ascended-browser works with Cursor as a local stdio MCP server. Configure Cursor with command `uvx` and argument `ascended-browser`, or use command `npx` with arguments `-y` and `ascended-browser`.

Yes, `browser_extract` can read console and network data. Agents can use those results with page observations and screenshots to investigate failed requests, frontend errors, and the visible state that accompanied a problem.

Yes, `browser_viewport` can resize the Linux browser for phone, tablet, and desktop checks. It can also emulate dark mode, reduced motion, forced colors, and offline conditions, while screenshots provide visual evidence of the resulting layout.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewAscended Browser AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/aceatdev-ascended-browser?style=directory)](https://allmcps.com/mcp/aceatdev-ascended-browser)
HTML Embed
<a href="https://allmcps.com/mcp/aceatdev-ascended-browser"><img src="https://allmcps.com/api/badge/aceatdev-ascended-browser?style=directory" alt="Ascended Browser on AllMCPs" /></a>