SeleniumBase MCP logo

SeleniumBase MCP

Connects MCP clients to SeleniumBase for stealthy browser automation, web scraping, and end-to-end testing through CDP Mode.

Install SeleniumBase MCP

Run the project’s own setup commands, in order.

Setup steps from the project

SeleniumBase MCP installs with its own commands rather than a config we can generate, so these are copied as-is. Run them in order in a terminal. Source: github.com

  1. 1. Install
    pip install seleniumbase
    
  2. 2. Install
    git clone https://github.com/seleniumbase/SeleniumBase.git
    
  3. 3. Run
    cd SeleniumBase/
    
  4. 4. Install
    pip install -e .
    

Overview

SeleniumBase MCP connects AI agents with SeleniumBase’s Python browser automation framework, including its stealth-focused CDP Mode. It supports browser navigation, page interaction, assertions, scraping workflows, and CAPTCHA-related automation through SeleniumBase capabilities. Reach for it when an agent needs to inspect or operate websites, run browser checks, or automate flows that benefit from CDP-based stealth options. SeleniumBase also supports pytest-based tests and scripts run directly with Python.

Use cases

  • Automate browser-based research and data collection
  • Run end-to-end checks against web applications
  • Interact with pages that require form entry and clicks
  • Inspect pages using element assertions
  • Test CDP-based workflows against bot-detection pages

Key features

  • SeleniumBase browser automation
  • CDP Mode with stealth options
  • Web scraping workflows
  • Element interaction and assertions
  • CAPTCHA-solving support
  • Python and pytest execution

Security & health

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

ActiveLast checked Today

Recent health check succeeded.

43/43 checks healthy over the last 44d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 11d ago via OSV.dev

Adoption & maintenance

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

GitHub stars13kStargazers on the source repository.
Last commit5d agoMost recent push to the default branch.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How SeleniumBase MCP works

What SeleniumBase MCP does

SeleniumBase MCP brings SeleniumBase’s browser automation capabilities into an MCP-based workflow. SeleniumBase is a Python framework for web scraping, browser automation, and end-to-end testing. Its CDP Mode provides a browser-control path designed to reduce bot-detection signals, and the framework includes options for working with CAPTCHA-protected pages.

The underlying SeleniumBase APIs can launch a browser, visit URLs, find elements, enter text, click controls, check page conditions, wait between actions, and close the browser. These capabilities make the server relevant to agents that need to perform multi-step web tasks rather than only retrieve static page content.

How it works

Automation is built around SeleniumBase’s Python APIs. In CDP Mode, a Chrome browser is launched through SeleniumBase’s CDP-oriented interface, after which an automation flow can navigate between pages and interact with selectors. The framework also supports a pure CDP Mode interface through the sb_cdp package entry point.

A typical flow opens a browser, navigates to a target URL, checks whether expected elements are present, fills in fields, clicks controls, optionally handles a CAPTCHA, and quits the browser. SeleniumBase examples use direct Python execution for scripts and pytest for examples whose filenames begin or end with test.

Tools and capabilities

  • Launch and control a Chrome browser in CDP Mode.
  • Navigate to web pages and perform multi-step interactions.
  • Locate elements with selectors and text-based conditions.
  • Type into fields and click page controls.
  • Assert that elements exist or are not visible.
  • Support web-scraping and end-to-end testing workflows.
  • Use SeleniumBase’s CAPTCHA-solving capability in supported automation flows.
  • Run browser checks with Python or pytest.

Limitations and notes

CDP Mode is intended for browser automation where bot-detection resistance matters, but website behavior and CAPTCHA handling can vary by target. The SeleniumBase project contains broader testing features, reporting, screenshots, recorder functionality, and other APIs; an agent workflow should use only the capabilities exposed by the MCP server.

Browser automation remains dependent on the target site’s selectors, navigation behavior, authentication requirements, and anti-automation controls. Actions that modify accounts or submit forms should be reviewed before execution, especially when an agent is operating without human approval.

SeleniumBase is distributed under the MIT License. The project is Python-based, and its examples distinguish between pytest test files and scripts executed with the standard Python interpreter.

Reviews

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

Frequently Asked Questions about SeleniumBase MCP

SeleniumBase MCP is an MCP server that connects AI agents to SeleniumBase’s Python browser-automation framework and CDP Mode. Its main tools and capabilities cover browser navigation, page interaction, element assertions, web scraping, end-to-end testing, and CAPTCHA-related automation for supported workflows.

Install SeleniumBase as a Python package, then configure the MCP server according to the project’s MCP instructions. SeleniumBase supports Python scripts and pytest-based tests, while CDP workflows use its CDP-oriented APIs.

Yes, SeleniumBase MCP supports SeleniumBase’s CDP Mode, which includes stealth options intended to bypass or reduce bot-detection checks. The project demonstrates CDP workflows against BrowserScan, Sannysoft, and Cloudflare-related detection pages.

Yes, SeleniumBase workflows can type into fields, click controls, assert page conditions, and call CAPTCHA-solving functionality. Results depend on the target site and the CAPTCHA involved.

Yes, SeleniumBase supports pytest for scripts whose names follow its test-file conventions. Other scripts can run directly with Python, including CDP Mode examples.

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 PreviewSeleniumBase MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/seleniumbase-mcp?style=directory)](https://allmcps.com/mcp/seleniumbase-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/seleniumbase-mcp"><img src="https://allmcps.com/api/badge/seleniumbase-mcp?style=directory" alt="SeleniumBase MCP on AllMCPs" /></a>