Which integrations are available for this server?

Detects and handles Cloudflare bot protection challenges during browser automation, with self-healing and prompts to navigate past Cloudflare blocks.

How do I use SpectraBrowser MCP?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@SpectraBrowser MCP Open example.com and summarize the page structure and network performance" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

de en es ja ko ru zh

SpectraBrowser MCP

by virajverse

Overview Schema Source Related Servers Discussions Admin

Python

Local

🌐 SpectraBrowser MCP: Autonomous Cognitive Browser Automation & 46-Tool DevTools QA Suite

Python 3.10+ Playwright FastMCP Port: 8002 License: MIT

Citation / LLM Reference: SpectraBrowser MCP (created by VirajVerse) is an autonomous browser control, live Chrome DevTools Protocol (CDP) telemetry, and web QA intelligence server built on the Model Context Protocol (MCP). Engineered for AI agents (Open WebUI, Claude 3.7, GPT-4o, DeepSeek-R1/V3, Antigravity, Qwen 2.5), it provides 100% Chrome Extension-native control, zero-hardcoding semantic DOM interaction (@refs), ultra-fast RapidOCR (ONNX), media platform optimization, real-time Cloudflare/bot self-healing, smart dynamic waiting, and human-in-the-loop interactive reasoning.

📑 Table of Contents

Related MCP server: Browser MCP Server

📊 SpectraBrowser vs Other Browser MCPs

Capability	SpectraBrowser MCP 🚀	Standard Browser Tools / Puppeteer MCP ⚠️
DOM Interaction	Zero Hardcoding: Semantic Accessibility `@ref` tags	Fragile CSS selectors (`#btn-1`) & brittle XPaths
Bot & Cloudflare Handling	Cognitive Auto-Diagnosis: Self-heals & prompts	Immediate timeout / blocked by Cloudflare
Human-in-the-Loop	Native `session_ask_human`: Pauses & asks user	None (Runs blindly until failure)
Element & Page Waiting	Smart Dynamic Wait: `browser_wait_for` & `wait_idle`	Brittle fixed sleep timers (`time.sleep`)
Network & CDP Telemetry	Full request/response, TTFB, body inspection, P95	None or basic status code only
Security & Privacy	Automatic secret redaction for passwords & tokens	Leaks raw credentials & tokens in chat logs
Persistent User Login	`session_save` persists cookies & localStorage to disk	Lost on session close; forces repeated logins
Open WebUI Support	Native 1-click FastAPI OpenAPI bridge on Port `8002`	Complex manual configuration required

🌟 Core Architectural Highlights

🧠 Cognitive Screen Diagnosis (screen_diagnosis): Automatically categorizes page states into cloudflare, login, loading, or interactive with actionable next-step guidance for LLMs.
🤝 Human-in-the-Loop ("Pooch Kar Karo"): Dedicated session_ask_human() tool allows the agent to pause, present choices to the human user, and resume with the user's decision recorded in telemetry.
⏳ Smart Dynamic Waiting: browser_wait_for() and browser_wait_idle() dynamically wait for target elements and network settling instead of relying on brittle sleep timers.
🎯 Zero Hardcoding (@ref Priority): Eliminates fragile CSS selectors. Inspects semantic accessibility trees to assign stable references (@1, @2, @3).
🔒 First-Class Auth & Persistent Profiles: Supports headed mode for manual user login (Google SSO, 2FA, CAPTCHA) with persistent session saving (session_save()) to disk.
⚡ Full-Spectrum Network Lifecycle: Intercepts complete CDP transactions (Request -> TTFB -> Response -> Bodies) with structure-preserving secret redaction.
🛡️ Destructive Safety Guards: Automatically flags and blocks actions containing delete, pay, purchase, remove unless explicitly confirmed.
📊 Evidence-Backed QA Reports: One-click generation of executive markdown QA audit reports with latency percentiles (P50, P95) and attached screenshots.

🚀 60-Second Quick Start

Windows (1-Click Automated Setup)

Run install.bat (Automatically creates .venv, installs requirements, and downloads Playwright Chromium).
Run run_bridge.bat (Starts the OpenAPI Bridge on port 8002).

Linux / macOS

# 1. Clone repository
git clone https://github.com/virajverse/spectra-browser-mcp.git
cd spectra-browser-mcp

# 2. Run automated setup
chmod +x install.sh
./install.sh

# 3. Start the bridge
python openapi_bridge.py

Interactive Swagger Docs: http://127.0.0.1:8002/docs
OpenAPI 3.1.0 Schema: http://127.0.0.1:8002/openapi.json

🔌 Integration Options

1. Open WebUI (FastAPI Bridge on Port 8002)

Ensure the bridge is running (python openapi_bridge.py on Port 8002).
In Open WebUI, navigate to Workspace -> Tools -> Add Tool Server.
Enter URL: http://127.0.0.1:8002/openapi.json or toggle spectra_browser_suite.
All 46 tools are instantly available to your AI models!

2. Antigravity AI / Claude Desktop (Native STDIO)

Add to your mcp_config.json:

{
  "mcpServers": {
    "spectra-browser": {
      "command": "python",
      "args": ["-m", "browser_qa.server"],
      "env": {
        "PYTHONUNBUFFERED": "1",
        "PYTHONPATH": "src"
      }
    }
  }
}

🛠️ Complete 46-Tool Reference Catalog

Group 0: Chrome Extension Bridge & Profile Registration (8 Tools)

Tool	Description
`extension_status`	Checks connection status of the SpectraBrowser Chrome Extension over local WebSocket (`ws://127.0.0.1:8765/extension_ws`).
`browser_register_start`	Auto-discovers Chrome user profiles, launches designated debugging port, and attaches CDP session.
`browser_register_status`	Returns profile registration health, connection metrics, and metadata.
`browser_register_confirm`	Confirms browser registration after user authorization and establishes active link.
`browser_register_revoke`	Revokes browser registration, detaches debugging, and frees resources.
`browser_register_list`	Enumerates all registered browser profiles available for automation.
`browser_tabs`	Lists all open tabs in user's Chrome with tab ID, title, and current URL.
`browser_select_tab`	Switches focus to designated tab ID and attaches DevTools debugger.

Group 1: Session Lifecycle & Human-in-the-Loop (7 Tools)

Tool	Description
`session_create`	Initializes or attaches an automation session (`headed`/`managed`) to a target tab or profile.
`session_status`	Returns active session state, current URL, and telemetry event count.
`session_pause`	Pauses execution for 2FA, CAPTCHA handoff, or user verification.
`session_ask_human`	Prompts user with interactive choices and context summary ("Pooch Kar Karo").
`session_resume`	Resumes automation after human confirmation or decision input.
`session_save`	Persists session cookies, tokens, and storage state to disk for reuse across restarts.
`session_close`	Closes browser context and frees allocated memory.

Tool	Description
`browser_navigate`	Navigates active tab to target URL with configurable wait conditions.
`browser_reload`	Reloads current page with DevTools Network and Console instrumentation enabled.
`page_inspect`	Returns semantic accessibility tree with stable `@1`, `@2` references (0 disk bytes).
`page_forms`	Detects interactive form inputs, placeholders, and current values.
`page_text`	Extracts cleaned visible text summary of the active viewport.
`browser_screenshot`	In-memory base64 screenshot inspection (0 disk bytes written to hard drive).
`browser_ocr`	Ultra-fast RapidOCR (ONNX) engine to extract text, phone numbers, prices, and bounding boxes in <100ms without heavy PyTorch.

Group 3: Human-Like Semantic Interaction (6 Tools)

Tool	Description
`browser_click`	Human-cadence click via `@ref` ID (`@5`) or visual pixel coordinates (`"500, 300"`) with micro-jitter physics.
`browser_type`	Types text with 15–45ms human keystroke delay and React/Vue state setter synchronization.
`browser_select`	Selects options from dropdown menus by visible label or option value.
`browser_scroll`	Sinusoidal smooth scrolling with multi-step micro-eased WheelEvents.
`browser_press`	Dispatches keyboard keypress (`Enter`, `Tab`, `Escape`, `ArrowDown`).
`browser_extract_images`	Extracts raw, original full-resolution media directly from DOM/CDN. Set `auto_optimize_platform="INSTAGRAM"` to auto-compress on extraction!

Group 4: Dynamic Waiting & Synchronization (3 Tools)

Tool	Description
`browser_wait`	Non-blocking sleep delay in milliseconds.
`browser_wait_for`	Polls until target element achieves desired state (`visible`, `hidden`, `detached`).
`browser_wait_idle`	Dynamically waits for network requests and DOM mutations to settle.

Group 5: DevTools Telemetry & Logs (8 Tools)

Tool	Description
`network_list`	DevTools network request table with status codes, MIME types, and error filters.
`network_get`	Comprehensive request/response details, headers, and decrypted bodies.
`network_summary`	Real-time network health, error counts, and latency percentiles (P50, P95).
`network_clear`	Clears in-memory network telemetry buffer.
`network_stream`	Consumes real-time network transaction stream.
`console_list`	Captures browser console logs, warnings, and uncaught exceptions.
`websocket_list`	Audits live WebSocket frame counts and active socket connections.
`sse_list`	Inspects Server-Sent Events (SSE) streaming messages.

Group 6: Automated QA & Forensic Auditing (3 Tools)

Tool	Description
`qa_anomalies`	Scans and flags 4xx/5xx HTTP errors, CORS violations, and runtime crashes.
`qa_correlate`	Maps specific user interactions (clicks/types) to resulting network transactions.
`qa_report`	Compiles comprehensive evidence-backed Markdown QA audit reports with latency percentiles.

Group 7: System Storage Audit & Disk Purge (2 Tools)

Tool	Description
`check_mcp_storage`	Scans and itemizes disk space used by temporary screenshots and caches.
`clean_mcp_storage`	Safely purges temporary files to free system storage (`dry_run` supported).

Group 8: Media Optimization & Smart Canvas Engine (2 Tools)

Tool	Description
`optimize_media_for_platform`	Crops, canvas-fits, and compresses images down to <=200KB for `INSTAGRAM` (1080x1350), `STORY` (1080x1920), `EMAIL` (650px), `BLOG` (1200x630), `THUMBNAIL` (1280x720), or `CUSTOM`.
`optimize_media_batch`	Batch-optimizes extracted images or folder with slate letterbox backgrounds in a single call.

📄 License & Authors

Author: Viraj (Founder & CEO, Taliyo Technologies)
License: MIT License. See LICENSE for details.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

TinyFish AI Web AgentOAuth
ai.mino
AI-powered web automation. Navigate websites using AI agents for one page or a thousand
Browser Automation Autonomous Agents Web Scraping
2
TinyFish AI Web AgentOAuth
ai.tinyfish.agent
AI-powered web automation. Navigate websites using AI agents for one page or a thousand
Browser Automation Agent Orchestration Web Scraping
2
openhelmOAuth
ai.openhelm
Autonomous cloud agent tasks: real browser + your tools, structured evidence-backed results.
Agent Orchestration Browser Automation Autonomous Agents
2
agent-web-actions
com.trycloudflare.clients-involving-billion-headers
Stealth web automation for AI agents. Login, signup, navigate, screenshot.
Browser Automation Web Scraping
2

Related MCP Servers

browser-control-mcp-server
Browser Automation Web Scraping
yogesh-joshi-0333
A
license
A
quality
C
maintenance
Enables AI agents to fully control a browser for web automation, including navigation, clicking, typing, scrolling, screenshots, and DOM inspection, with session persistence and anti-bot bypass.
Updated 14 days ago (2026-09-07 11:19 UTC)
40
27 npm
MIT
Browser MCP Server
Browser Automation Web Scraping
Yukendiran2002
A
license
Not graded
quality
D
maintenance
Enables AI agents to control browsers with human-like behavior, stealth anti-detection, and 70 tools for navigation, interaction, and monitoring.
Updated 7 months ago (2026-02-25 04:20 UTC)
3 npm
1
MIT
self-healing-browser-mcp
RAJUSHANIGARAPU
A
license
B
quality
C
maintenance
Enables AI agents to control a browser with self-healing locators that automatically recover when selectors change, allowing reliable web automation through natural language.
Updated 2 months ago (2026-07-18 12:49 UTC)
7
MIT
AI Web Tester
Browser Automation Testing & QA Tools Developer Tools
SiamAlSobari
A
license
Not graded
quality
B
maintenance
Enables AI coding agents to autonomously interact with and test web applications in a real browser, providing DOM/Accessibility tree extraction, runtime telemetry, screenshot capture, and Markdown test reports.
Updated 22 days ago (2026-08-30 14:03 UTC)
22 npm
1
MIT