universal-browser
Supports controlling Brave (Chromium) browser sessions via the same extension and CDP automation, with background tab management, DOM indexing, and interactive browser actions.
Enables AI agents to control live Google Chrome browser sessions through the extension and Chrome DevTools Protocol, including background tab leases, DOM indexing, clicking, typing, navigation, screenshots, and Markdown extraction.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Universal AI Browser Control ππ€
Open-Source Autonomous AI Browser Extension + Universal MCP Server & CLI Hub
Live Production Web Portal & Cloud Relay:
π https://universal-browser-control.vercel.app
Public GitHub Repository:
π https://github.com/abdulaaly/universal-browser-control
Download Packaged Chrome Extension (.zip):
π extension-v1.0.0-chrome.zip
Universal AI Browser Control is a 100% open-source, vendor-agnostic browser automation system engineered to surpass closed proprietary extensions (such as the ChatGPT Chrome Extension hehggadaopoacecdllhhajmbjkdcmajg).
It provides an open bridge allowing ANY AI clientβincluding Google Gemini, Anthropic Claude (Web, Desktop, iOS, Android), Perplexity, Cursor, and the Antigravity CLIβto safely control the user's live, authenticated desktop browser session without hijacking active tabs or exposing credentials.
π¨ Tier-1 "Obsidian Command" Design System
The UI was crafted from the ground up utilizing the official Obsidian Command design specification (synthesizing Linear, Raycast, and Cursor design tokens):
Obsidian Monolithic Palette: Pure dark canvas (
#08090b), surface ladder (#0e1015β#14171fβ#191d27), and hairline borders (1px solid #232834).Tactile Micro-Actions: 2x2 grid in both the popup and sidepanel for instant DOM indexing, viewport capture, Markdown extraction, and agent cursor positioning.
Dedicated Popup Hub (
popup.html): Compact 360x520px extension popup featuring active tab domain, live CDP status badge, segmented transport switch (Local WS/Public Tunnel), and 1-click PAT token rotation.5-Tab Multi-Modal Sidepanel (
sidepanel.html):Agent Stream: Natural-language prompt box withββkeycap, live timeline action feed, and emergencyInterrupt Run (Esc)button.DOM Inspector: Searchable element index table with selector tags and numeric markers[1]..[n].DOM Actions: Zero-friction action playground to dispatch clicks, synthesized typing, and background navigations.Security HITL: Human-In-The-Loop safety guardrails, sensitive domain interceptor, and whitelisted domains.Protocol Logs: Real-time CDP and MCP JSON-RPC protocol trace stream.
Related MCP server: Tato Runtime
π Key Superpowers & Capabilities
π 100% Vendor Agnostic: Works identically with Gemini, Claude, Perplexity, Cursor, Antigravity, or custom autonomous agents via standard Model Context Protocol (MCP).
π‘οΈ Zero Tab Hijacking & Background Leases: Operates smoothly in background tabs using Chrome DevTools Protocol (
chrome.debugger) and tab leases without stealing focus while you work.ποΈ Token-Optimized DOM Indexer: Converts web pages into compact, numbered interactive element markers (
[1],[2],[3]) and human-readable Markdown summaries.π±οΈ Natural Visual Agent Cursor: Injects a physics-based Bezier cursor trail and click ripple animation inside an isolated Shadow DOM container (
closedmode) so you see exactly what the AI is doing in real-time.π¨ Human-in-the-Loop (HITL) Guardrails: High-risk actions (file downloads, browser history access, form submissions on unknown domains) pause for interactive approval cards (
[Allow Once],[Trust Domain],[Deny]).π Pre-configured Sensitive Domain Blocklist: Automatic denial on banking portals, password managers, and critical identity providers (
chase.com,paypal.com,1password.com,bitwarden.com, etc.).π‘ Dual Transport Modes:
Local
stdioTransport: Zero-latency IPC for local coding assistants (Antigravity, Cursor, Terminal).Remote
SSE / Streamable HTTP& WSS Cloud Relay: Enables remote mobile and web clients (Claude on iPhone, Gemini Web in the cloud) to command your desktop browser across networks with Firebase Auth & 2FA.
ποΈ Monorepo Architecture
universal-browser-control/
βββ packages/
β βββ extension/ # Chrome/Edge/Brave Extension (React + Vite + Tailwind + MV3)
β βββ mcp-server/ # Universal MCP Server (@modelcontextprotocol/sdk, stdio & SSE)
β βββ cli/ # CLI-Anything zero-config hub (npx universal-browser)
β βββ firebase-backend/ # Firebase Auth, 2FA, Scoped PATs & WSS Cloud Relay
βββ reference-extension/ # Deconstructed ChatGPT Chrome Extension (hehggadaopoacecdllhhajmbjkdcmajg)
βββ api/ # Production Vercel Serverless MCP SSE & Relay Gateway
βββ public/ # Live Production Web Companion Hub
βββ ARCHITECTURE.md # Comprehensive technical deconstruction & architectural specification
βββ DESIGN.md # Tier-1 Obsidian Command Design System Specification
βββ SETUP.md # Step-by-step connection guide for Gemini, Claude, Perplexity, Cursor
βββ firebase.json # Production Firebase configuration
βββ firestore.rules # Strict user-isolation security rules
βββ LICENSE # MIT Licenseπ Quickstart Guide
Prerequisites
Node.js
>= 18.0.0Google Chrome, Microsoft Edge, or Brave Browser
1. Build the Monorepo
# Clone the repository
git clone https://github.com/abdulaaly/universal-browser-control.git
cd universal-browser-control
# Install all workspace dependencies
npm install
# Build all packages
npm run build2. Load the Chrome Extension
Open Google Chrome and navigate to
chrome://extensions.Enable Developer mode in the top-right corner.
Click Load unpacked and select the directory:
universal-browser-control/packages/extension/dist(oruniversal-browser-control/chrome-extension)Pin the Universal AI Browser Control icon in your Chrome toolbar.
Click the extension icon to view the compact Popup Hub or open the Side Panel to inspect live telemetry.
3. Start the Local MCP Bridge
# Start local stdio MCP server for Antigravity or local agents
npx universal-browser start
# Or start in SSE streaming mode for remote web/mobile AI clients:
npx universal-browser start --sse --port 3000π€ AI Client Connection Configurations
1. Anthropic Claude (Web & iOS / Android Mobile)
Add the MCP configuration to your Claude Desktop config (claude_desktop_config.json) or mobile connection:
{
"mcpServers": {
"universal-browser": {
"url": "https://universal-browser-control.vercel.app/api/mcp/sse",
"headers": {
"Authorization": "Bearer ub_pat_live_89f0a8c2b7d41e9e03"
}
}
}
}2. Google Gemini (Web, API & CLI)
Add the MCP server configuration into your Gemini runtime:
{
"mcpServers": {
"universal-browser": {
"url": "https://universal-browser-control.vercel.app/api/mcp/sse",
"headers": {
"Authorization": "Bearer ub_pat_live_89f0a8c2b7d41e9e03"
}
}
}
}3. Cursor IDE
In Cursor Settings β Features β MCP, add a new SSE Server:
Name:
universal-browserType:
sseURL:
https://universal-browser-control.vercel.app/api/mcp/sseHeaders:
{"Authorization": "Bearer ub_pat_live_89f0a8c2b7d41e9e03"}
4. Perplexity AI
Under Perplexity Developer Settings / MCP Connections:
{
"mcpServer": {
"name": "universal-browser",
"transport": "sse",
"endpoint": "https://universal-browser-control.vercel.app/api/mcp/sse",
"bearerToken": "ub_pat_live_89f0a8c2b7d41e9e03"
}
}5. Antigravity & Local CLI
Zero-config instant bridge via terminal:
npx @universal-browser/cli connect --url https://universal-browser-control.vercel.app/api/mcp/sseπ Comparison: Vendor-Locked Extension vs. Universal AI Browser Control
Feature | Original ChatGPT Extension ( | Universal AI Browser Control |
Supported Models | ChatGPT Web Only | Gemini, Claude (Web/Mobile), Perplexity, Cursor, Antigravity CLI |
Remote / Mobile Control | β No | β Full SSE & Encrypted Cloud Relay |
Dual Transport (stdio + SSE) | β Stdio/Local Only | β
Both Local |
Background Tab Isolation | Partial | β Full CDP Background Leases |
Visual Agent Cursor | Basic | β Physics-Based Bezier Curve & Click Ripple |
Security Guardrails | Basic Confirmation | β
3-Tier HITL ( |
Sensitive Domain Blocking | Limited | β Hard-Coded Bank/Vault Blocklist |
Design System | Generic UI | β Tier-1 Obsidian Command (Linear/Raycast/Cursor) |
Source Code & License | Proprietary & Minified | β 100% Open-Source (MIT) |
π‘οΈ Security & Privacy Architecture
Local-First Execution: By default, all CDP commands execute locally on your machine.
Explicit User Leases: The extension only connects to tabs when an automation action is triggered.
No Credential Harvesting: The extension never inspects password input values or transmits cookies.
Instant Emergency Kill-Switch: Users can hit
Escor click Interrupt Run at any microsecond to revoke automation leases immediately.
π License & Attribution
Author & Maintainer: 100xdigitizer@gmail.com
Repository: https://github.com/abdulaaly/universal-browser-control
License: Released under the MIT License.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
This server cannot be deployed
Maintenance
Related MCP Connectors
Browz hosted MCP (free public beta): let an AI app drive your own Browz browser profiles from anywhere. Connect https://mcp.gobrowz.com/mcp and sign in with your Browz account (OAuth) or an agent token. Each call is relayed to the Browz app on your computer, which must be online with Remote control on and have a hardware security chip (Mac Secure Enclave or TPM 2.0). 17 tools: profiles, tabs, navigate, snapshot, act, wait, screenshot. Cookies, downloads and stored sign-ins stay on your computer.
Let AI agents use your real, signed-in Chrome: tabs, clicks, forms, screenshots and video.
Live browser debugging for AI assistants β DOM, console, network via MCP.
Browser MCP for logged-in tasks. Uses your Chrome β credentials stay local. Zero-token replay.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to control your existing Chrome browser via MCP, using your logged-in sessions for automation on authenticated sites. Provides high-level browser tools plus raw CDP and Chrome API access.MIT
- AlicenseAqualityCmaintenanceEnables MCP-speaking AI agents to operate a desktop and browser through structured UI inspection, mouse/keyboard gestures, tab-scoped browsing, and approved local screen recording with editing.31MIT
- AlicenseNot gradedqualityBmaintenanceEnables any MCP-capable AI agent to operate the user's own everyday Chrome browser with all existing login sessions intact, offering 22 tools for reading page/network data, filling forms, clicking, batch multi-step actions, and handing CAPTCHAs or confirmations back to the human β without API keys, debug ports, or launch flags.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents and MCP clients to safely control the user's real Chrome browser, using shared tabs with per-site approvals, credential-field protection, a kill switch, and an activity log.11 npmApache 2.0